Summary

CC Pocket provides a mobile-first interface for controlling AI coding agents like Codex and Claude Code, enabling users to initiate, manage, and approve sessions entirely from their phone. It targets developers and engineers who rely on autonomous coding agents and need to stay engaged with long-running tasks or frequent approval requests while away from their keyboard, offering a convenient way to make critical decisions from anywhere.

How It Works

The system comprises a self-hosted Node.js "Bridge Server" on the host machine and a Flutter-based mobile application. Unlike existing remote control features that hand off active sessions, CC Pocket allows users to initiate new sessions directly from their phone. The mobile app acts as the primary interface for decision-making, while the host machine executes the agent's tasks in the background, facilitating a seamless workflow for remote oversight and intervention.

Quick Start & Requirements

Install Node.js 18+ and a CLI provider (Codex or Claude Code) on your host. Run npx @ccpocket/bridge@latest to start the Bridge Server. Connect via QR code scan from the mobile app (iOS/Android) or download the macOS Desktop (Beta) client. ANTHROPIC_API_KEY environment variable is required for Claude Code.

Highlighted Details

• Mobile Control: Initiate sessions, handle approvals via touch-first UI, monitor live output, and review code diffs (including images) from your phone.
• Session Management: Track multiple projects, receive push notifications for actions, and utilize advanced modes like "Accept Edits" or "Plan" for Claude Code, and configurable execution/planning/sandbox for Codex.
• Advanced Features: Isolate sessions using Worktrees with .gtrconfig customization, connect remotely via Tailscale or SSH, and manage host services (launchd/systemd).
• Platform Specifics: macOS offers enhanced features like screenshot capture and window listing.

Maintenance & Community

No specific details on maintainers, community channels, or project health signals were found in the provided README.

Licensing & Compatibility

Licensed under FSL-1.1-MIT, which converts to the standard MIT license on March 17, 2028. This license permits use, modification, and distribution, with potential restrictions under FSL-1.1 until the conversion date.

Limitations & Caveats

Sessions must be initiated from the mobile app; CC Pocket cannot attach to sessions started directly on the host. Screenshot capture and window listing are macOS-only features. Older bridge versions (<1.25.0) are deprecated due to Anthropic policy concerns; use >=1.25.0 with environment variable API key configuration.