프로젝트 소개

CodeAgent Mobile — Clients는 CodeAgent Mobile의 클라이언트 측 브리지를 위한 공개 저장소입니다. CodeAgent Mobile은 모바일 기기나 웹 대시보드에서 AI 코딩 에이전트(Claude Code, Copilot, Cursor, Windsurf, JetBrains AI, OpenAI Codex, Vertex AI 등)를 감독할 수 있게 하는 워크플로 연속성 계층입니다. 저장소에는 세 가지 클라이언트가 있습니다. - apps/cli – codeam-cli. Claude Code를 PTY로 감싸고 명령을 모든 기기로 스트리밍하는 미널 브리지입니다. npm으로 설치할 수 있으며 QR 페어링 흐름과 함께 사용됩니다. - apps/vsc-plugin – VS Code, Cursor, Windsurf용 확장으로, 동일한 백엔드 릴레이에 연결되어 휴대폰에서 diff를 승인하고 프롬프트를 리디렉션하며 세션을 모니터링할 수 있습니다. - apps/jetbrains-plugin – IntelliJ 제품군(IDEA, WebStorm, PyCharm, Rider, GoLand 등)용 플러그인으로, 동일한 모바일 제어 기능을 통합합니다. 모든 클라이언트는 동일한 환경 변수 구성(CODEAM_API_URL 및 CODEAM_TEST_MODE=1)을 공유하여 프로덕션, 스테이징 또는 자체 호스팅 API를 가리킵니다. 이 변수들은 호스트 프로세스에서 읽습니다. VS Code 및 JetBrains 플러그인은 수동 재정의로 apiBaseUrl 설정도 지원합니다. 저장소 레이아웃은 모노레포 패턴을 따르며, 각 클라이언트용 apps/, chunk-protocol 파서와 model-pricing 테이블(드 시 인라인됨)을 보관하는 packages/shared TypeScript 패키지, 빌드·테스트·게시를 위한 트 스크립트로 구성됩니다. 빌드 전제 조건은 Node 18 이상, Python 3(PTY 처리용), JetBrains 플러그인용 JDK 17입니다. 릴리스는 단일 버전 라인(2.0.0에서 시작)으로 조정됩니다. vX.Y.Z 태그는 CLI를 npm에, VS Code 확장을 VS Code Marketplace와 Open VSX 모두에, JetBrains 플러그인을 JetBrains Marketplace 안정 채널에 자동 게시하도록 트리거합니다. 사전 릴리스 태그는 JetBrains Marketplace 푸시를 건너뜁니다. 아키텍처적으로 클라이언트는 은 릴레이 역할을 합니다. REST/WebSocket을 통해 CodeAgent 백엔드에 연결하고, 명령을 로컬 AI 에이전트(PTY, IDE API 또는 터미널을 통해)로 전달하며, 세션을 모바일/웹 UI로 스트리밍하여 승인, 리디렉션, 비동기 감독을 수행합니다. 기여는 간단한 워크플로를 따릅니다. 사소하지 않은 변경에는 이슈를 열고, 앱별로 변경 범위를 유지하며, 적절한 테스트(npm run test:cli)를 실행하고, 빌드가 성공하는지 확인한 뒤 풀 리퀘스트를 제출합니다. 이 프로젝트는 MIT License에 따라 라이선스됩니다. 이 저장소는 데스크톱을 넘어 AI 코딩 워크플로를 확장하려는 개발자에게 이상적이며, 단일 모바일 인터이스에서 여러 IDE와 미널 에이전트를 위한 통합 제어 평면을 제공합니다.