codeagent-mobile-clients

CodeAgent Mobile — Clients is the public repository for the client‑side bridges of CodeAgent Mobile, a workflow‑continuity layer that lets you supervise AI coding agents (Claude Code, Copilot, Cursor, Windsurf, JetBrains AI, OpenAI Codex, Vertex AI, etc.) from a mobile device or web dashboard. The repo contains three distinct clients: - **apps/cli** – `codeam-cli`, a terminal bridge that wraps Claude Code in a PTY and streams commands to any device. Installable via npm and used with a QR‑pairing flow. - **apps/vsc-plugin** – an extension for VS Code, Cursor, and Windsurf that connects to the same backend relay, allowing you to approve diffs, redirect prompts, and monitor sessions from your phone. - **apps/jetbrains-plugin** – a plugin for the IntelliJ family (IDEA, WebStorm, PyCharm, Rider, GoLand, …) that integrates the same mobile control capabilities. All clients share the same environment‑variable configuration (`CODEAM_API_URL` and `CODEAM_TEST_MODE=1`) to point to a production, staging, or self‑hosted API. They read these variables from the host process; the VS Code and JetBrains plugins also support an `apiBaseUrl` setting as a manual override. The repository layout follows a monorepo pattern with `apps/` for each client, a `packages/shared` TypeScript package that holds the chunk‑protocol parser and model‑pricing tables (inlined at build time), and root scripts for building, testing, and publishing. Build prerequisites are Node ≥ 18, Python 3 (for PTY handling), and JDK 17 for the JetBrains plugin. Releases are coordinated via a single version line (starting at 2.0.0). A tag `vX.Y.Z` triggers automated publishing of the CLI to npm, the VS Code extension to both the VS Code Marketplace and Open VSX, and the JetBrains plugin to the JetBrains Marketplace stable channel. Pre‑release tags skip the JetBrains marketplace push. Architecturally, the clients act as thin relays: they connect to the CodeAgent backend over REST/WebSocket, forward commands to the local AI agent (via PTY, IDE APIs, or terminal), and stream the session to the mobile/web UI for approval, redirection, and async oversight. Contributing follows a simple workflow: open an issue for non‑trivial changes, keep changes scoped per app, run the appropriate tests (`npm run test:cli`) and ensure builds succeed before submitting a pull request. The project is licensed under the MIT License. This repository is ideal for developers who want to extend AI coding workflows beyond the desktop, providing a unified control plane for multiple IDEs and terminal agents from a single mobile interface.