ccpocket

Name: ccpocket
Author: K9i-0

by K9i-0

Warning

Mobile client for Codex and Claude — control coding agents from your phone via WebSocket bridge

870stars

75forks

Dart

Added 3/13/2026

View on GitHub Download ZIP Scan for vulnerabilities

AI Agentsandroidapp-serverbridge-serverclaude-codecli

Installation

# Add to your Claude Code skills
git clone https://github.com/K9i-0/ccpocket

Getting Started

Guides for using ai agents skills like ccpocket.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportWarning

Last scanned: 5/8/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "@anthropic-ai/claude-agent-sdk: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@anthropic-ai/sdk: Claude SDK for TypeScript has Insecure Default File Permissions in Local Filesystem Memory Tool",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@hono/node-server: @hono/node-server: Middleware bypass via repeated slashes in serveStatic",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "express-rate-limit: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "hono: Hono missing validation of cookie name on write path in setCookie()",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "ip-address: ip-address has XSS in Address6 HTML-emitting methods",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "picomatch: Picomatch: Method Injection in POSIX Character Classes causes incorrect Glob Matching",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "postcss: PostCSS has XSS via Unescaped </style> in its CSS Stringify Output",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "rollup: Rollup 4 has Arbitrary File Write via Path Traversal",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "vite: Vite Vulnerable to Path Traversal in Optimized Deps `.map` Handling",
      "severity": "high"
    }
  ],
  "status": "WARNING",
  "scannedAt": "2026-05-08T05:57:58.313Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

213,760

ping-island aiflowy

CC Pocket

CC Pocket is a mobile and desktop app for controlling Codex and Claude coding-agent sessions. Run the agents through a self-hosted Bridge Server on your own Mac, Linux, or Windows machine, then start sessions, approve actions, answer questions, review changes, and pick up work from iPhone, iPad, Android, native macOS, or experimental Linux/Windows desktop builds. Experimental Linux and Windows desktop builds are also available from GitHub Releases.

日本語版 README | 简体中文版 README | 한국어 README

Install

Install at least one agent CLI on the machine that will run your sessions: Codex or Claude Code. For Codex on macOS/Linux, the current standalone installer is: curl -fsSL https://chatgpt.com/codex/install.sh | sh.
Install Node.js 18 or newer on that same machine.
Start the CC Pocket Bridge Server:

npx @ccpocket/bridge@latest

Install CC Pocket and scan the QR code printed by the Bridge Server.
Pick a project, choose Codex or Claude, and start coding from the app.

Platform	Install
iOS / iPadOS
Android
macOS	Download the latest `.dmg` from GitHub Releases. Look for releases tagged `macos/v*`. You can also install using Homebrew Cask with `brew install --cask cc-pocket`.
Linux (experimental)	Download the latest `.tar.gz` from GitHub Releases. Look for releases tagged `linux/v*`.
Windows (experimental)	Download the latest `.zip` from GitHub Releases. Look for releases tagged `windows/v*`.

Free to Use

CC Pocket is free to use. If it helps your workflow, please consider becoming a Supporter in the app. Supporter purchases help cover development and AI tooling costs.

New to mobile coding agents? See How to run Codex from iPhone or Android.

What You Can Do

Control Codex and Claude anywhere: start sessions from the app, resume recent sessions created in the CLI or app, and move between phone, tablet, and Mac without losing context.
Stay in the approval loop: approve commands, file edits, MCP requests, and agent questions from a mobile-first UI without returning to your keyboard.
Explore and review the workspace: browse project files with Explorer, inspect git diffs and image diffs, stage changes, commit, push, or revert them.
Write rich prompts on mobile: use Markdown, completions, voice input, and image attachments.
Keep working on spotty networks: recover missed streaming updates, queue outgoing messages while offline, and resend automatically after reconnecting.
Work in parallel safely: run sessions in separate git worktrees and keep long-running work isolated.
Manage your machines: save hosts, connect with QR codes or mDNS discovery, use Tailscale, start/stop/update over SSH, and receive push notifications.
Use larger screens when helpful: CC Pocket adapts to iPad, macOS, Linux, and Windows with workspace layouts for chat, Git, Explorer, screenshots, and images.

Why Fork CC Pocket?

CC Pocket is MIT licensed so you can treat it as a starting point for your own agent workflow, not only as a finished app.

Build an internal client that combines Codex or Claude with your team's Jira, Linear, GitHub, or private REST APIs.
Remove surfaces you do not need and keep a focused app for your daily workflow.
Reuse the Bridge sync layer, approval flow, prompt history, git operations, file browsing, and image/diff viewers instead of rebuilding them from scratch.
Keep compatibility with the local agent tools and their session history while adding workflow-specific GUI features that are easier to use than prompts or MCP.
Extend desktop support. macOS, Linux, and Windows builds are available today; Linux and Windows remain experimental because the project does not have the same continuous verification coverage for those environments.

For a deeper implementation overview, see the technical stack page or the agent-readable Markdown.

How It Works

CC Pocket has two parts:

CC Pocket app  <->  Bridge Server on your machine  <->  Codex / Claude

The app is the interface you use. The Bridge Server runs locally on the machine that has access to your projects, shell, git repository, and agent CLI. Your code stays on your own machine instead of moving into a hosted IDE.

Remote Access

On the same network, connect with the QR code, mDNS discovery, or a manual ws:// / wss:// URL.

For access away from home or the office, Tailscale is the recommended setup:

Install Tailscale on your host machine and phone.
Join the same tailnet.
Connect to ws://<host-tailscale-ip>:8765 from CC Pocket.

For an always-on host, the Bridge Server can also be registered as a background service:

npx @ccpocket/bridge@latest setup

Service setup supports macOS launchd and Linux systemd. For Bridge flags and persisted service settings such as BRIDGE_ALLOWED_DIRS, see the Bridge package README.

Notes

Claude sessions require @ccpocket/bridge 1.25.0 or newer and an ANTHROPIC_API_KEY. Claude subscription login via /login is not supported for new Bridge installs. See Claude authentication troubleshooting.
CC Pocket is designed around self-hosting and minimal data collection. Supporter purchases restore within the same Apple ID or Google account, but do not sync across stores. See Supporter / Purchases.
Screenshot capture on macOS requires Screen Recording permission for the terminal app running the Bridge Server.
CC Pocket is not affiliated with, endorsed by, or associated with Anthropic or OpenAI.

Development

git clone https://github.com/K9i-0/ccpocket.git
cd ccpocket
npm install
cd apps/mobile && flutter pub get && cd ../..

Common commands:

Command	Description
`npm run bridge`	Start Bridge Server in dev mode
`npm run bridge:build`	Build the Bridge Server
`npm run dev`	Restart Bridge and launch the Flutter app
`npm run test:bridge`	Run Bridge Server tests
`cd apps/mobile && flutter test`	Run Flutter tests
`cd apps/mobile && dart analyze`	Run Dart static analysis

For end-to-end checks with a local Bridge and mobile app, see Development Testing.

See CONTRIBUTING.md for contribution guidelines.

License

MIT