Shellular: Run AI Agents and Dev Environments on Mobile

Shellular allows developers to access their local machine's terminal, AI agents, and localhost servers from a mobile device. It enables the execution of tools such as Claude Code, Codex, OpenCode, and Cursor CLI directly from a phone without needing to copy context between devices or maintain a separate mobile version of a codebase.

Remote AI Agent Management

Shellular provides a full user interface for AI agents running on a host machine. This allows developers to maintain active sessions with agents like Claude Code and Codex, picking up exactly where they left off regardless of their physical location. Because the agents run where the code lives, there is no need to transfer context or files between the mobile device and the desktop environment.

Full Terminal and Localhost Access

Shellular provides a real TTY terminal with full PATH access, allowing users to run commands, restart services, and tail logs on their host machine. The application includes touch-optimized chord shortcuts to improve the terminal experience on mobile screens.

Additionally, the tool includes a localhost tunnel that provides encrypted access to development servers, dashboards, and internal tools running on the host machine. This allows developers to browse localhost and use DevTools from a mobile browser without exposing the services to the public internet.

Direct File and Git Integration

Shellular grants access to actual project files on the source machine, eliminating synchronization conflicts. It supports multiple languages including TypeScript, Python, and Go, and allows users to perform Git operations such as staging hunks, committing, and pushing directly on the real repository.

Security and Encryption Model

Shellular uses an end-to-end encryption (E2EE) model to ensure that the relay server does not have access to user data. The security architecture consists of the following components:

• End-to-End Encryption: Data is encrypted on the host machine and decrypted only on the mobile device.
• TLS Traffic: All traffic is routed over TLS to prevent unencrypted connections.
• Relay Server: The relay server is open source and serves only to pass encrypted data between the device and the host.
• QR Code Pairing: Pairing is performed by scanning a QR code containing the encryption key, ensuring the key is never transmitted over a network.
• Host Approval: Every new device must be manually approved on the host machine before a connection can be established.

Installation and Setup

To set up Shellular, users run the command npx shellular on their host machine. This command connects the machine to the relay server and generates a QR code. After scanning the QR code with the mobile app (available on iOS and Android) and approving the device on the host, the development environment becomes accessible on the phone.