# MobileCLI

> A self-hosted Rust CLI daemon that streams AI coding agents (Claude Code, Gemini CLI, Codex, OpenCode) to your phone. Approve tool calls, browse files, monitor progress — from anywhere.

MobileCLI is a terminal mirror and AI agent control panel for your phone. It is NOT an SSH client or mobile IDE — it connects to your running AI coding sessions and lets you monitor and control them remotely.

## Key Facts

- Self-hosted terminal streaming: Rust daemon runs on your machine, with no MobileCLI terminal relay or account required
- Auth-v2 pairing: mobile clients must prove possession of a QR pairing token before sessions or terminal data are available
- Privacy model: Terminal streams use your configured network path; push notifications currently use Expo and include notification metadata
- Open source CLI: github.com/MobileCLI/mobilecli
- iOS app available on the App Store, Android coming soon
- Free tier: Terminal streaming, tool call approvals, push notifications, session management
- Pro tier ($20/year or $30 lifetime): File system access with syntax highlighting, search, editing

## Supported AI CLIs

- Claude Code (Anthropic)
- Gemini CLI (Google)
- Codex (OpenAI)
- OpenCode

## Links

- Website: https://mobilecli.app
- Documentation: https://mobilecli.app/docs
- Getting Started: https://mobilecli.app/docs/getting-started
- Features: https://mobilecli.app/features
- Pricing: https://mobilecli.app/pricing
- Install: https://mobilecli.app/download
- GitHub: https://github.com/MobileCLI/mobilecli
- Blog: https://mobilecli.app/blog
- Integrations: https://mobilecli.app/integrations
- Compare SSH+tmux: https://mobilecli.app/compare/ssh-tmux
- Compare Happy Coder: https://mobilecli.app/compare/happy-coder

## Use Cases

- **Monitoring long-running tasks**: Kick off a Claude Code refactoring session, leave your desk, and watch progress from your phone. Get a push notification when the agent finishes or needs input.
- **Approving tool calls remotely**: Gemini CLI wants to write to a file or run a command? Approve or reject from your phone with numbered quick-response buttons — no need to rush back to your laptop.
- **Browsing project files while commuting**: Use the Pro file browser to review code, check configs, or read logs from your phone while on the train or bus.
- **Managing multiple AI sessions**: Run Claude Code on one project and Codex on another. Switch between live sessions on your phone and keep tabs on both.
- **Getting push notifications when agents need input**: MobileCLI sends native iOS push notifications when any connected AI CLI asks a question, requests tool approval, or completes a task.

## Comparisons

### MobileCLI vs SSH + tmux
- **Purpose-built mobile UI vs raw terminal**: MobileCLI provides a native iOS app optimized for phone screens with quick-action buttons. SSH+tmux gives you a raw terminal that is hard to use on small screens.
- **Push notifications vs manual polling**: MobileCLI sends native push notifications when your AI agent needs attention. With SSH+tmux, you have to manually check the terminal.
- **Auto-reconnect vs dropped connections**: MobileCLI automatically reconnects when your mobile connection drops. SSH sessions disconnect and require manual reattach with tmux.

### MobileCLI vs Happy Coder
- **Local daemon vs cloud**: MobileCLI runs a daemon on your machine and avoids a MobileCLI terminal relay. Happy Coder routes through cloud servers.
- **Multi-CLI vs Claude-only**: MobileCLI supports Claude Code, Gemini CLI, Codex, and OpenCode. Happy Coder supports Claude Code only.
- **Open source vs closed**: MobileCLI's CLI daemon is open source on GitHub. Happy Coder is fully closed source.

## Q&A

**What is MobileCLI?**
MobileCLI is a self-hosted Rust daemon that streams AI coding agent sessions (Claude Code, Gemini CLI, Codex, OpenCode) to your phone. It lets you monitor terminal output, approve tool calls, browse files, and get push notifications — all from a native iOS app.

**Is MobileCLI free?**
Yes. The core features — terminal streaming, tool call approvals, push notifications, and session management — are free forever. Pro features (file browser, editor, search) cost $20/year or $30 lifetime.

**Does MobileCLI work with Claude Code?**
Yes. MobileCLI supports Claude Code, Gemini CLI, Codex, and OpenCode. It auto-detects supported CLIs without any configuration.

**Is my code stored in the cloud?**
No. MobileCLI does not store your code or terminal stream on MobileCLI servers. The daemon runs on your machine and serves terminal streams over your configured network path. Push notifications currently use Expo and include notification metadata.

**How does MobileCLI connect to my phone?**
MobileCLI connects your phone to your desktop daemon over WebSocket on your local network, Tailnet, or a protected endpoint you configure. The app pairs with a QR credential and completes auth-v2 challenge-response before sessions or terminal data are available. For remote access outside your home or office, use Tailscale so the daemon is only reachable by devices in your Tailnet.

**What platforms does MobileCLI support?**
The CLI daemon runs on macOS (Apple Silicon + Intel), Linux (x86_64 + ARM), and Windows (x64). Use the curl installer on macOS/Linux; on Windows use the GitHub Releases zip or Cargo. The mobile app is available for iOS on the App Store. Android support is coming soon.