Install the CLI — CodeAgent Mobile Wiki
The CodeAgent Mobile Wiki

Every feature, explained — organized by the path you actually take: set up, launch a session, supervise the run, ship the PR.

Free

Install the CLI

The codeam CLI wraps your terminal AI agent so your phone becomes the remote control — install it, pair with a QR code, and run.

01 · INSTALLOne command
npm i -g codeam-cli
  • Requires Node.js 18+
02 · PAIRPairing
codeam pair
  • QR + 6-char code, 5 min TTL
03 · RUNOnline
codeam
  • Agent runs with mobile control

codeam-cli is an npm package that wraps your terminal AI agent (Claude Code, Codex, Gemini CLI, Aider, and more) so your phone becomes the remote control. It runs anywhere Node.js does — your laptop, an SSH session, tmux, Docker, or a GitHub Codespace.

bash
npm i -g codeam-cli
codeam pair
codeam
One npm install

npm install -g codeam-cli — no separate runtime, just Node.js 18 or newer.

Pair in seconds

codeam pair prints a QR code and a 6-character fallback code, both expiring after 5 minutes.

Works anywhere Node runs

SSH sessions, tmux/screen, Docker containers, remote servers, and Codespaces are all supported.

Your own credentials

The agent runs with your existing API key or subscription — CodeAgent never sees your repository.

  1. 1
    Install

    Run npm install -g codeam-cli in your terminal.

  2. 2
    Pair

    Run codeam pair and scan the QR (or type the 6-character code) in the mobile app or web dashboard.

  3. 3
    Run your agent

    Run codeam to launch the agent with mobile control instead of the bare agent binary.

  4. 4
    List or switch sessions

    Use codeam sessions to list pairings and codeam sessions switch to change the active one across multiple machines.

TIP

Pairing once binds the session by ID — after that, the 6-character code is no longer needed until you pair a new session.

FAQ

Related

QR pairingIDE pluginsLocal execution

Ready to try it?

Start freeSee pricing