Shellular: Remote Access for AI Agents and Development Environments on Mobile

Shellular is a remote access tool that enables developers to run AI agents, terminals, and development servers from a mobile device. By connecting a mobile app to a host machine via a relay server, developers can maintain active sessions with tools like Claude Code, Codex, and Cursor CLI without needing to carry a laptop.

Remote AI Agent Management

Shellular provides a native mobile UI for AI agents running on a host machine, eliminating the need to copy context between devices. It supports a wide range of agents including Claude Code, Codex, OpenCode, Hermes Agent, Cursor, Pi, and GitHub Copilot.

Key capabilities for agent management include:

  • Session Persistence: Users can pick up the exact agent session they left on their desktop.
  • Native Interface: The app provides a dedicated UI for agents, which users have noted is superior to relying solely on terminal renderers.
  • Context Preservation: Because the agents run where the code lives, there is no need to transfer files or context to the mobile device.

Full Terminal and Localhost Access

Beyond AI agents, Shellular provides direct access to the host machine's environment to manage infrastructure and preview applications.

Integrated Terminal

The tool provides a full TTY with a complete PATH, allowing users to run commands, restart services, and tail logs. It is not a sandbox or a simulated shell, but a direct connection to the host machine. To optimize for mobile use, it includes touch-optimized chord shortcuts and maintains state across reconnections.

Localhost Tunneling

Shellular enables encrypted access to local development servers, dashboards, and internal tools running on the host machine. This allows developers to browse localhost from their phone and use browser DevTools without exposing these services to the public internet.

File and Git Management

Users can interact with actual project files on the source machine. The system supports TypeScript, Python, and Go, and allows users to stage hunks and perform git commits and pushes directly from the mobile app.

Security Model and Connectivity

Shellular uses an end-to-end encrypted (E2EE) architecture to ensure that the relay server does not have access to user data.

  • Encryption: Data is encrypted on the mobile device before transmission and decrypted only upon reaching the host machine. All traffic is routed over TLS.
  • Pairing: Device pairing is performed by scanning a QR code containing the encryption key, ensuring the key is never transmitted over a network.
  • Authorization: Every new device must be explicitly approved by the user on the host machine before a connection is established.
  • Open Source: The relay server is open source to allow for community auditing.

Setup and Installation

Connecting a mobile device to a host machine requires two steps:

  1. Host Setup: Run npx shellular on the host machine to connect to the relay and generate a QR code.
  2. Mobile Connection: Scan the QR code with the Shellular app (available on iOS and Android) and approve the device on the host.

Community Feedback and Insights

Users on Hacker News have highlighted both the utility and the potential friction points of the tool. Some developers have praised the ability to build features while away from their desks, while others raised questions about security and integration.

I was at the passport office for 3 hours today, and built a huge engineering feature. Love it man, absolutely love it.

Other technical observations from the community include:

  • Comparison to Alternatives: Some users compared Shellular to tools like Paseo or the /remote-control command in Claude Code, noting that Shellular's native app approach provides a more integrated experience.
  • Connectivity Issues: Some early testers reported difficulties reconnecting to the app after it had been closed for an hour.
  • UI Consistency: Feedback suggested that the agents tab and home screen should be more consistent in how they display main agents versus sub-agents.
  • Network Suggestions: Users suggested adding support for Tailscale or Iroh to provide alternative networking layers.

Sources

Related

  • Project
  • Project
  • Project
  • Project
  • Project