MobileCLI

Product Introduction

1. Definition: MobileCLI is a self-hosted, local-first terminal streaming and remote management solution. It is technically a Rust-based daemon that creates a persistent WebSocket bridge between a user's desktop environment and their mobile device.
2. Core Value Proposition: MobileCLI exists to enable developers and power users to monitor, interact with, and approve actions for AI-powered coding agents (like Claude Code, Gemini CLI, and Codex) from their mobile phones, without compromising security by sending data to the cloud. Its primary value is seamless, privacy-first remote terminal access.

Main Features

1. Real-Time Terminal Streaming: The core functionality captures PTY (pseudo-terminal) output from AI agent sessions and streams it in real-time to a native mobile app over a WebSocket connection. It features full ANSI color code support and automatic reconnection logic to handle unstable mobile networks, ensuring a faithful terminal experience.
2. Structured Tool Call Approval: When an AI agent like Claude Code requires user approval for a tool call, MobileCLI intercepts the prompt and presents it on the mobile app with structured, numbered buttons (e.g., "1. Yes", "2. Yes, always", "3. No") and a virtual "Esc" key. This allows for precise, prompt-matching input directly from the phone, a critical feature for agent workflows.
3. Integrated File System Browser (Pro Feature): The Pro version provides a native mobile file explorer for the connected desktop. It allows users to browse, search, view (with syntax highlighting for 10+ languages), and perform basic file operations (create, rename, copy, delete) within their projects and configuration directories directly from their phone.
4. Privacy-First, Self-Hosted Architecture: The entire system is built around a locally executed Rust daemon. All connections are direct peer-to-peer, either over the local network (LAN) or via a secure mesh VPN like Tailscale. No terminal data, file contents, or session metadata is relayed through a third-party cloud server.
5. Multi-Session & Multi-Agent Support: The daemon can manage multiple concurrent AI agent sessions (e.g., separate Claude Code and Gemini CLI instances). Users can switch between these active sessions from the mobile app, monitoring different projects or agents simultaneously.

Problems Solved

1. Pain Point: The inability to monitor long-running AI coding sessions or respond to critical approval prompts when away from the desktop. This forces users to remain tethered to their computer or risk stalling their automated workflows.
2. Target Audience: The primary user personas are software developers, DevOps engineers, and technical founders who utilize AI coding assistants (Claude Code, Gemini CLI, OpenCode) for automation, code generation, or system management and require mobility without interrupting their workflows.
3. Use Cases: A developer starts a Claude Code session to refactor a codebase, then leaves their desk. MobileCLI sends a push notification to their phone when Claude needs approval to run a test. The developer approves it instantly from their phone. Another use case is browsing server log files or checking on a deployment status from a mobile device while connected via Tailscale.

Unique Advantages

1. Differentiation vs. SSH/Tmux: Unlike generic SSH clients paired with tmux, MobileCLI is purpose-built for AI agent interaction. It provides a structured UI for approvals and push notifications, whereas SSH requires precise touchscreen command input and offers no native integration with agent prompt flows.
2. Differentiation vs. Cloud-Based Solutions: Unlike remote desktop or cloud-terminal services, MobileCLI's self-hosted model guarantees that sensitive code, terminal history, and file system access never leave the user's own machines, addressing major security and privacy concerns for developers.
3. Key Innovation: The integration of a local Rust daemon that specifically parses and structures AI agent CLI prompts for mobile interaction. The combination of real-time PTY streaming, prompt-aware approval UI, and a native file browser, all within a zero-cloud-architecture, is its defining technical innovation.

Frequently Asked Questions (FAQ)

1. Does MobileCLI work with Claude Code and Gemini CLI? Yes, MobileCLI is explicitly designed to auto-detect and stream sessions from popular AI coding agents including Claude Code, Gemini CLI, Codex, and OpenCode. It captures their PTY output and manages their specific approval prompts.
2. Is my code secure with MobileCLI? Is it stored in the cloud? Yes, your code is secure. MobileCLI employs a privacy-first, self-hosted architecture. The Rust daemon runs on your local machine, and all data streams directly to your phone over your local network or an encrypted Tailscale connection. No code, terminal data, or file contents are ever sent to a third-party cloud server.
3. How do I connect to MobileCLI when I'm not on my home Wi-Fi? For remote access outside your local network, MobileCLI seamlessly integrates with Tailscale. By installing Tailscale on both your desktop and phone, a secure WireGuard tunnel is established, allowing the MobileCLI connection to work as if both devices are on the same local network, without requiring manual port forwarding.
4. What is the difference between the free and Pro version of MobileCLI? The free version of MobileCLI includes core features: terminal streaming for AI agents, tool call approvals, push notifications, and multi-session management. The Pro version adds full file system browsing, search, and file management capabilities from the mobile app for an annual fee or lifetime license.
5. Does MobileCLI have an Android app? Currently, the MobileCLI mobile app is available for iOS on the App Store. Official Android support is listed as being on the development roadmap. However, the CLI daemon itself is compatible with Windows, macOS, and Linux desktops.