Development
Plugin
ccpocket
CC Pocket is a mobile and desktop app for controlling Codex and Claude coding-agent sessions.
Plugin Signal84/100Strong
maintained99
capable65
documented100
adopted64
Install
$ npx -y skills add K9i-0/ccpocket --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
What's inside
Skills
18/codex-guideCodex の使い方、CLI/app/IDE、rules・hooks・AGENTS.md・skills・subagents・config などを案内する。Codex や OpenAI 製品の仕様を答える前に必ず公式ドキュメントを確認し、rules/approval は `codex execpolicy check` で実検証すること。/flutter-ui-designFlutter UI実装のアーキテクチャ規約・コンポーネント分割・状態管理ガイド（Bloc/Cubit版）/flutter-upgradeFlutter SDKバージョンアップグレード対応。新バージョンのリリースノート・Breaking Changes調査、コードベース影響分析、mise/CI/Shorebird含むプロジェクト全体の対応タスクリスト作成と実行。「Flutterアップグレード」「Flutter X.Y.Zがリリースされた」「Flutter最新化」「Flutter更新」と言われたとき、またはFlutterの新バージョンについて言及されたときに使用する。/mergeブランチをメインにマージしてお掃除する/mobile-automationMCP (dart-mcp + Marionette) を使ったFlutterアプリのE2E自動化・UI検証ガイド。シミュレーターでのUI動作確認、モックプレビュー検証、Bridge経由のE2Eテスト、スクリーンショット撮影など、アプリの動作検証が必要なときに使う。「動作確認して」「UIを検証して」「E2Eテスト」「シミュレーターで確認」「モックで確認」と言われたときや、UI変更後の検証フェーズで使用すること。/playwright-cliAutomates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, test web applications, or extract information from web pages.
Show all 18 skillsShow fewer
/release-appアプリのリリース（バージョンbump + CHANGELOG + タグ → GH Actions で自動ビルド・配布）。iOS / Android / macOS / Linux / Windows の任意の組み合わせでリリースできる。「リリース」「バージョン上げて」「リリースして」と言われたときに使う。/release-bridgeBridge Server のリリース（バージョンbump + CHANGELOG + タグ → GH Actions で npm publish）/release-cardccpocket の X 向けリリース告知カード画像を作成・更新する。最新の iOS/Android/macOS リリースタグ、App Store release_notes、既存の scripts/release-card/generate.mjs を使って英語・日本語の告知PNGを生成し、画像を目視確認して不備があれば生成スクリプトを修正する。「リリースカード」「X告知画像」「リリース報告用画像」「release-card」と言われたときに使用する。/self-reviewタスク完了前のセルフレビュー。Claude subagentで別コンテキストから客観的にコード変更を検証。/shorebird-patchShorebird OTA パッチの作成・staging 配布（stable 昇格はユーザー実施）/sim-previewiOSシミュレーターでアプリをビルド・起動し、TrollVNC経由でiPhoneからリモートプレビューできるようにする。実装の確認をユーザーに依頼するとき、シミュレータープレビュー、VNCプレビュー、実機確認と言われたとき、UIの変更結果を見せたいときに使用する。/submit-store-reviewApp Store Connect・Google Playの現在の公開版をAPIで調べ、既存の最新安定ビルドとの差分から4言語のリリースノートを作成し、CLI/APIで審査へ提出・再提出する。新しいビルドを作るrelease-appとは分離し、「最新を審査提出して」「ストア審査へ提出して」「App Reviewに出して」「Google Playの審査を進めて」「却下対応して再提出して」と依頼されたときに使用する。/test-bridgeBridge Server (TypeScript) のテスト実行・型チェック・テスト記述ガイド/test-flutterFlutter App のテスト実行・静的解析・フォーマット・テスト記述ガイド/triageGitHub Issue・PRのトリアージ。番号を渡すと、要望の要約・実現難易度・既存機能との重複チェック・対応判断を調査してレポートする。Issue/PRの番号が出てきたとき、トリアージ、優先度判断、対応判断と言われたときに使用する。/update-storeストア情報の更新自動化 — スクリーンショット撮影（シミュレーター × モック画面 × Marionette MCP）とメタデータテキスト更新。ストア更新、スクショ更新、App Store / Google Play のメタデータ更新、リリースノート作成の際に使用すること。/web-previewFlutter Web版をビルドしてユーザーにプレビューURLを案内する。playwright-cliでアクセス確認も行う。
Agents
2README
1CC 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*. Alternatively, install the community-maintained AUR package with yay -S cc-pocket-bin. |
| 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>:8765from 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/bridge1.25.0or newer and anANTHROPIC_API_KEY. Claude subscription login via/loginis 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
File tree
1298K9i-0/ccpocketView on GitHub
.agents/
skills
.claude/
agents/
code-reviewer.md
e2e-verifier.md
hooks/
post-edit-analyze.sh
pre-stop-check.sh
settings.json
skills/
codex-guide/
references/
official-sources.md
SKILL.md
flutter-ui-design/
SKILL.md
flutter-upgrade/
SKILL.md
merge/
SKILL.md
mobile-automation/
SKILL.md
playwright-cli/
references/
request-mocking.md
running-code.md
session-management.md
storage-state.md
test-generation.md
tracing.md
video-recording.md
SKILL.md
release-app/
SKILL.md
release-bridge/
SKILL.md
release-card/
agents/
openai.yaml
SKILL.md
self-review/
SKILL.md
shorebird-patch/
patch.sh
promote.sh
SKILL.md
sim-preview/
scripts/
sim-preview.sh
SKILL.md
submit-store-review/
agents/
openai.yaml
references/
android.md
ios.md
SKILL.md
test-bridge/
SKILL.md
test-flutter/
SKILL.md
triage/
SKILL.md
update-store/
scripts/
sim-tap.swift
SKILL.md
web-preview/
scripts/
web-preview.sh
SKILL.md
.codex/
config.toml
rules/
default.rules
.firebaserc.example
.github/
dependabot.yml
ISSUE_TEMPLATE/
bug_report.yml
config.yml
feature_request.yml
prompt_request.yml
PULL_REQUEST_TEMPLATE.md
workflows/
android-patch.yml
android-release.yml
bridge-release.yml
bridge-windows-smoke.yml
daily-metrics.yml
inspect-store-state.yml
ios-patch.yml
ios-release.yml
linux-release.yml
macos-release.yml
pages.yml
submit-store-review.yml
sync-store-ppo.yml
test.yml
upload-metadata.yml
windows-release.yml
.gitignore
.gtrconfig
.mcp.json
.mise.toml
.vscode/
launch.json
tasks.json
AGENTS.md
apps/
menubar/
.gitignore
CCPocketMenubar/
CCPocketMenubar.xcodeproj/
project.pbxproj
project.xcworkspace/
contents.xcworkspacedata
App/
AppDelegate.swift
MenuBarApp.swift
CCPocketMenubar.entitlements
Info.plist
Localizable.xcstrings
Models/
BridgeHealth.swift
BridgeVersion.swift
ConnectionInfo.swift
DoctorReport.swift
UsageInfo.swift
Resources/
Assets.xcassets/
AppIcon.appiconset/
Contents.json
Contents.json
menubar-icon.svg
MenuBarIcon.png
MenuBarIcon@2x.png
Services/
BridgeClient.swift
BridgeProcessManager.swift
DoctorRunner.swift
MockDoctorScenarios.swift
NetworkDiscovery.swift
QRCodeGenerator.swift
ViewModels/
AppViewModel.swift
DoctorViewModel.swift
QRCodeViewModel.swift
UsageViewModel.swift
Views/
DoctorPage/
CheckResultRow.swift
DoctorPageView.swift
HeaderView.swift
OnboardingView.swift
PopoverContentView.swift
QRCodePage/
AddressRow.swift
QRCodePageView.swift
UsagePage/
UsageGaugeView.swift
UsagePageView.swift
project.yml
mobile/
.gitignore
.metadata
analysis_options.yaml
android/
.gitignore
app/
build.gradle.kts
src/
debug/
AndroidManifest.xml
main/
AndroidManifest.xml
kotlin/
com/
k9i/
ccpocket/
DeepLinkActivity.kt
MainActivity.kt
res/
drawable/
drawable-hdpi/
ic_launcher_foreground.png
ic_launcher_supporter_light_outline_foreground.png
ic_launcher_supporter_pro_copper_emerald_foreground.png
ic_notification.png
drawable-mdpi/
ic_launcher_foreground.png
ic_launcher_supporter_light_outline_foreground.png
ic_launcher_supporter_pro_copper_emerald_foreground.png
ic_notification.png
drawable-v21/
launch_background.xml
drawable-xhdpi/
ic_launcher_foreground.png
ic_launcher_supporter_light_outline_foreground.png
ic_launcher_supporter_pro_copper_emerald_foreground.png
ic_notification.png
drawable-xxhdpi/
ic_launcher_foreground.png
ic_launcher_supporter_light_outline_foreground.png
ic_launcher_supporter_pro_copper_emerald_foreground.png
ic_notification.png
drawable-xxxhdpi/
ic_launcher_foreground.png
ic_launcher_supporter_light_outline_foreground.png
ic_launcher_supporter_pro_copper_emerald_foreground.png
ic_notification.png
launch_background.xml
mipmap-anydpi-v26/
ic_launcher_supporter_light_outline.xml
ic_launcher_supporter_pro_copper_emerald.xml
launcher_icon.xml
mipmap-hdpi/
ic_launcher_supporter_light_outline.png
ic_launcher_supporter_pro_copper_emerald.png
ic_launcher.png
launcher_icon.png
mipmap-mdpi/
ic_launcher_supporter_light_outline.png
ic_launcher_supporter_pro_copper_emerald.png
ic_launcher.png
launcher_icon.png
mipmap-xhdpi/
ic_launcher_supporter_light_outline.png
ic_launcher_supporter_pro_copper_emerald.png
ic_launcher.png
launcher_icon.png
mipmap-xxhdpi/
ic_launcher_supporter_light_outline.png
ic_launcher_supporter_pro_copper_emerald.png
ic_launcher.png
launcher_icon.png
mipmap-xxxhdpi/
ic_launcher_supporter_light_outline.png
ic_launcher_supporter_pro_copper_emerald.png
ic_launcher.png
launcher_icon.png
values/
values-ja/
strings.xml
values-ko/
strings.xml
values-night/
styles.xml
values-zh-rCN/
strings.xml
colors.xml
strings.xml
styles.xml
profile/
AndroidManifest.xml
build.gradle.kts
gradle/
gradle.properties
wrapper/
gradle-wrapper.properties
keystore.properties.example
settings.gradle.kts
assets/
docs/
auth-troubleshooting.en.md
auth-troubleshooting.ja.md
auth-troubleshooting.ko.md
auth-troubleshooting.zh-CN.md
fonts/
code/
DejaVuSansMono.ttf
IoskeleyMono-Regular.ttf
JetBrainsMono-Regular.ttf
LICENSES.md
icon_foreground.png
icon_light_outline.png
icon_notification.png
icon_pro_copper_emerald.png
icon.png
store/
checkout_mcp_preview.png
devtools_options.yaml
fastlane/
Appfile
Fastfile
metadata/
android/
en-US/
changelogs/
default.txt
full_description.txt
images/
featureGraphic.png
icon.png
phoneScreenshots/
01_session_list.png
02_recent_sessions.png
03_approval_list.png
04_multi_question.png
05_explorer.png
06_git_actions.png
07_images_screenshots.png
08_network_resilience.png
short_description.txt
title.txt
ja-JP/
changelogs/
default.txt
full_description.txt
images/
featureGraphic.png
icon.png
phoneScreenshots/
01_session_list.png
02_recent_sessions.png
03_approval_list.png
04_multi_question.png
05_explorer.png
06_git_actions.png
07_images_screenshots.png
08_network_resilience.png
short_description.txt
title.txt
ko-KR/
changelogs/
default.txt
full_description.txt
images/
featureGraphic.png
icon.png
phoneScreenshots/
01_session_list.png
02_recent_sessions.png
03_approval_list.png
04_multi_question.png
05_explorer.png
06_git_actions.png
07_images_screenshots.png
08_network_resilience.png
short_description.txt
title.txt
zh-CN/
changelogs/
default.txt
full_description.txt
images/
featureGraphic.png
icon.png
phoneScreenshots/
01_session_list.png
02_recent_sessions.png
03_approval_list.png
04_multi_question.png
05_explorer.png
06_git_actions.png
07_images_screenshots.png
08_network_resilience.png
short_description.txt
title.txt
copyright.txt
en-US/
description.txt
name.txt
privacy_url.txt
promotional_text.txt
release_notes.txt
screenshots/
01_session_list.png
02_coding_session.png
03_task_planning.png
04_approval_flow.png
05_ask_question.png
06_recent_sessions.png
ipad_01_session_list.png
ipad_02_coding_session.png
ipad_03_task_planning.png
ipad_04_approval_flow.png
ipad_05_ask_question.png
ipad_06_recent_sessions.png
subtitle.txt
support_url.txt
ja/
description.txt
name.txt
privacy_url.txt
promotional_text.txt
release_notes.txt
screenshots/
01_session_list.png
02_coding_session.png
03_task_planning.png
04_approval_flow.png
05_ask_question.png
06_recent_sessions.png
ipad_01_session_list.png
ipad_02_coding_session.png
ipad_03_task_planning.png
ipad_04_approval_flow.png
ipad_05_ask_question.png
... 1161 moreFAQ
ccpocket is a Claude Code plugin with 18 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes codex-guide, flutter-ui-design, flutter-upgrade. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is ccpocket?
- CC Pocket is a mobile and desktop app for controlling Codex and Claude coding-agent sessions.
- How do I install ccpocket?
- Run these in Claude Code: npx -y skills add K9i-0/ccpocket --agent claude-code. Then prompt normally.
- Does ccpocket auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is ccpocket free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.