ccpocket

CC Pocket은 Codex 및 Claude 코딩 에이전트 (coding-agent) 세션을 제어하기 위한 모바일 및 데스크톱 앱입니다. 본인의 Mac 또는 Linux 머신에서 자체 호스팅되는 브리지 서버 (Bridge Server)를 통해 에이전트를 실행한 다음, iPhone, iPad, Android 또는 네이티브 macOS 앱을 통해 세션을 시작하고, 작업을 승인하고, 질문에 답하고, 변경 사항을 검토하며, 작업을 이어갈 수 있습니다. 실험적인 Linux 데스크톱 빌드 또한 GitHub Releases에서 사용할 수 있습니다.

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

• 세션을 실행할 머신에 최소 하나 이상의 에이전트 CLI를 설치하세요: Codex 또는 Claude Code.
• 동일한 머신에 Node.js 18 이상 버전을 설치하세요.
• CC Pocket 브리지 서버 (Bridge Server)를 시작하세요:

npx @ccpocket/bridge@latest

• CC Pocket을 설치하고 브리지 서버에서 출력된 QR 코드를 스캔하세요.
• 프로젝트를 선택하고, Codex 또는 Claude를 선택한 후 앱에서 코딩을 시작하세요.

플랫폼	설치
iOS / iPadOS
Android
macOS	GitHub Releases에서 최신 .dmg 파일을 다운로드하세요. macos/v* 태그가 붙은 릴리스를 찾으세요.
Linux (실험적)	GitHub Releases에서 최신 .tar.gz 파일을 다운로드하세요. linux/v* 태그가 붙은 릴리스를 찾으세요.

CC Pocket은 무료로 사용할 수 있습니다. 만약 이 앱이 귀하의 워크플로 (workflow)에 도움이 된다면, 앱 내에서 후원자 (Supporter)가 되는 것을 고려해 주세요. 후원 구매는 개발 및 AI 도구 비용을 충당하는 데 도움이 됩니다.

모바일 코딩 에이전트가 처음이신가요? iPhone 또는 Android에서 Codex를 실행하는 방법을 확인하세요.

어디서나 Codex와 Claude 제어: 앱에서 세션을 시작하고, CLI 또는 앱에서 생성된 최근 세션을 재개하며, 컨텍스트 (context)를 잃지 않고 휴대폰, 태블릿, Mac 사이를 이동하세요.

승인 루프 (approval loop) 유지: 키보드로 돌아갈 필요 없이 모바일 우선 UI (mobile-first UI)에서 명령, 파일 수정, MCP 요청 및 에이전트 질문을 승인하세요.

워크스페이스 탐색 및 검토: Explorer로 프로젝트 파일을 찾아보고, git diff 및 이미지 diff를 검사하며, 변경 사항을 스테이징 (stage), 커밋 (commit), 푸시 (push) 또는 되돌리기 (revert) 하세요.

모바일에서 풍부한 프롬프트 작성: Markdown, 자동 완성 (completions), 음성 입력 및 이미지 첨부 기능을 사용하세요.

불안정한 네트워크에서도 작업 지속: 놓친 스트리밍 업데이트를 복구하고, 오프라인 상태에서 나가는 메시지를 대기열 (queue)에 저장하며, 재연결 후 자동으로 다시 전송하세요.

안전하게 병렬 작업 수행: 별도의 git worktree에서 세션을 실행하여 오래 걸리는 작업을 격리된 상태로 유지하세요.

머신 관리: 호스트를 저장하고, QR 코드 또는 mDNS 검색으로 연결하며, Tailscale을 사용하고, SSH를 통해 시작/중지/업데이트를 수행하며, 푸시 알림을 받으세요.

필요할 때 더 큰 화면 사용: CC Pocket은 채팅, Git, Explorer, 스크린샷 및 이미지를 위한 워크스페이스 레이아웃을 갖추어 iPad, macOS 및 Linux에 적응합니다.

CC Pocket은 두 부분으로 구성됩니다:

CC Pocket 앱 <-> 사용자의 머신에 있는 Bridge Server <-> Codex / Claude

앱은 사용자가 사용하는 인터페이스입니다. Bridge Server는 프로젝트, 셸 (shell), git 저장소 및 에이전트 CLI (agent CLI)에 접근할 수 있는 머신에서 로컬로 실행됩니다. 코드는 호스팅된 IDE (hosted IDE)로 이동하는 대신 사용자의 머신에 그대로 유지됩니다.

동일한 네트워크 내에서는 QR 코드, mDNS 검색 또는 수동 ws:// / wss:// URL을 통해 연결하세요.

집이나 사무실 외부에서 접속하려면 Tailscale 설정을 권장합니다:

• 호스트 머신과 휴대폰에 Tailscale을 설치합니다.
• 동일한 tailnet에 참여합니다.
• CC Pocket에서 ws://<host-tailscale-ip>:8765로 연결합니다.

항상 켜져 있는 호스트의 경우, Bridge Server를 백그라운드 서비스로 등록할 수도 있습니다:

npx @ccpocket/bridge@latest setup

서비스 설정은 macOS launchd 및 Linux systemd를 지원합니다.

• Claude 세션에는 @ccpocket/bridge 1.25.0 버전 이상과 ANTHROPIC_API_KEY가 필요합니다.

새로운 Bridge 설치 시 /login을 통한 Claude 구독 로그인은 지원되지 않습니다. Claude 인증 문제 해결(Claude authentication troubleshooting)을 참조하세요. - CC Pocket은 셀프 호스팅 (self-hosting) 및 최소한의 데이터 수집을 기반으로 설계되었습니다. 후원자(Supporter) 구매 내역은 동일한 Apple ID 또는 Google 계정 내에서 복구되지만, 스토어 간에는 동기화되지 않습니다. 후원자 / 구매 (Supporter / Purchases) 섹션을 참조하세요.

• macOS에서 스크린샷 캡처를 하려면 Bridge Server를 실행하는 터미널 앱에 화면 기록 (Screen Recording) 권한이 필요합니다.
• CC Pocket은 Anthropic 또는 OpenAI와 제휴, 보증 또는 연관되어 있지 않습니다.

git clone https://github.com/K9i-0/ccpocket.git
cd ccpocket
npm install
...

일반적인 명령어:

명령어	설명
npm run bridge	개발 모드에서 Bridge Server 시작
npm run bridge:build	Bridge Server 빌드
npm run dev	Bridge를 재시작하고 Flutter 앱 실행
npm run test:bridge	Bridge Server 테스트 실행
cd apps/mobile && flutter test	Flutter 테스트 실행
cd apps/mobile && dart analyze	Dart 정적 분석 (static analysis) 실행

기여 가이드라인은 CONTRIBUTING.md를 참조하세요.

FSL-1.1-MIT: 소스 공개 (Source available). 2028-03-17에 MIT 라이선스로 전환됩니다.

이 리포지토리에는 @ccpocket/bridge에 대한 Bridge 재배포 예외 (Bridge Redistribution Exception) 조항이 포함되어 있습니다.
비공식적인 Bridge 재배포 및 환경별 포크 (forks)는 명확하게 비공식적이며 지원되지 않음을 명시하는 한 허용됩니다.