Does CodeAgent Mobile work with the Gemini CLI?

Yes. Gemini CLI is ACP-native, so CodeAgent Mobile drives it over the Agent Client Protocol — you get typed streaming of the agent's tool calls and diffs on your phone, not just raw terminal text.

Do I need a Google account or Gemini API key?

Yes. Gemini CLI runs on your own machine with your existing Google sign-in or Gemini API key. CodeAgent Mobile is a relay — it never replaces the model provider and never sees your key.

Does the 1M-token context still work from my phone?

Yes. Gemini runs locally with its full context window; your phone supervises the session. Nothing about the model's capabilities changes — you're just driving it remotely.

Does my code leave my computer?

No. Gemini CLI runs locally and reads and writes files on your machine. The relay only carries the message stream between your phone and the terminal — your repository stays local.

How do I launch Gemini instead of another agent?

Pick Gemini in the interactive agent picker when you run `codeam pair`, or pair it directly with `codeam pair --agent gemini`. After that, `codeam` starts your Gemini session with mobile control.

Is there a free tier?

Yes — CodeAgent Mobile has a free plan with no credit card: a daily task allowance, up to 2 paired devices, and 1 linked agent. Pro removes the daily caps and adds Team Spaces, the self-hosted deploy plane, Agent Toolkit integrations, and built-in cost-saving compression. See the pricing page at codeagent-mobile.com/pricing for current Pro pricing.

For Gemini CLI users

Control Gemini CLI from your phone

CodeAgent Mobile is a mobile companion app that lets you control Google's Gemini CLI from your phone. Install codeam-cli, pair your terminal with the app, then drive Gemini's prompts, streamed responses, and tool calls directly from iOS or Android while it runs locally with your own Google credentials — over the ACP protocol Gemini CLI speaks natively.

Download for iOS Download for Android Install codeam-cli

How it works

Pair your phone with Gemini CLI once. After that, every prompt and response flows between the two automatically.

1
Run `npm install -g codeam-cli` in your terminal (requires Node.js 18 or newer, plus the Gemini CLI installed and authenticated with your Google account or Gemini API key).
2
Run `codeam pair` and pick Gemini in the agent picker (or run `codeam pair --agent gemini`) to generate a 6-character code and a QR.
3
Open CodeAgent Mobile on your phone, tap "Pair Device", and scan the QR or enter the code.
4
Run `codeam` — Gemini runs locally over ACP and streams its responses, diffs, and tool calls back to your phone.

npm install -g codeam-cli

Why developers use it

A real remote control for your AI coding agent — not a chat fallback.

Real-time streaming

Token-by-token output streams from your laptop straight to your phone — diffs, file lists, and the agent's reasoning all render live.

Secure end-to-end relay

The CodeAgent backend is a thin relay. Your code never leaves your machine, and the AI agent runs with your existing API key or subscription.

Works with your existing setup

No changes to your IDE settings, Anthropic key, GitHub Copilot subscription, or Cursor account. Pair once and start sending prompts.

Approve interactive prompts

When the agent stops to ask y/n or pick an option, the prompt appears on your phone. Tap to approve, reject, or pick — without going back to the keyboard.

Frequently asked questions

Specific to Gemini CLI users.

Get started in under a minute

Install the Gemini CLI client, pair your phone, and start sending prompts from anywhere.

Install codeam-cli npm install -g codeam-cli