CodeAgent Mobile — Clients
Public source for the client-side bridges of CodeAgent Mobile — the workflow-continuity layer for AI coding agents.
- apps/cli — codeam-cli, the terminal bridge that wraps Claude Code in a PTY and streams it to any device
- apps/vsc-plugin — extension for VS Code, Cursor, and Windsurf
- apps/jetbrains-plugin — plugin for the IntelliJ family (IntelliJ IDEA, WebStorm, PyCharm, Rider, GoLand, …)
What is CodeAgent Mobile? The supervision layer for agents already running in your IDE. Now that AI agents run for hours, not seconds, you no longer need to stare at a terminal — CodeAgent streams the session to your phone or web dashboard so you can approve diffs, redirect prompts, and stay in the loop async. Works with Claude Code, Copilot, Cursor, Windsurf, JetBrains AI, OpenAI Codex, Vertex AI, and any agent in your editor. Install once in your IDE, pair with a QR, your workflow follows you across devices. See codeagent-mobile.com.
---
Install (users)
CLI — codeam-cli
npm install -g codeam-cli
codeam pair # generates a 6-character code
codeam # starts Claude Code with mobile controlVS Code / Cursor / Windsurf
- VS Code Marketplace → search for CodeAgent Mobile · listing
- Cursor / Open VSX → CodeAgentMobile/codeagent-mobile
JetBrains
- JetBrains Marketplace → CodeAgent-Mobile
---
Environment variables
Every client (CLI + both plugins) reads the same two env vars to pick which API host it talks to. Priority order — first match wins:
| Variable | Effect | |---|---| | CODEAMAPIURL | Full URL override. Use when pointing at a custom staging endpoint or a self-hosted instance. Example: CODEAMAPIURL=https://staging-api.example.com codeam pair. | | CODEAMTESTMODE=1 | Shortcut that routes every request at the dev preview (https://dev-api.codeagent-mobile.com) without you having to know the URL. Use this when pairing from dev.codeagent-mobile.com. | | (none) | Defaults to production (https://api.codeagent-mobile.com). |
The shortcut exists because prod + dev share Redis: a code generated against prod-api is also valid against dev-api, so a pair started in the dev webapp completes silently against prod (heartbeats keep going to the wrong host). CODEAMTESTMODE=1 flips every endpoint — pairing, command relay, SSE, chunk uploads, file watcher, history — in lockstep.
# Quick check it's active:
CODEAM_TEST_MODE=1 codeam doctor
# api https://dev-api.codeagent-mobile.com
# mode TEST_MODE — using dev preview