Skip to main content
Watchfire
Google

Gemini CLI

Google's Gemini coding agent on the command line.

What is Gemini CLI?

Gemini CLI is Google's command-line coding agent backed by Gemini models. It uses a shared global setup at `~/.gemini/` for auth and configuration, then accepts a per-invocation system prompt.

Vendor: github.com/google-gemini/gemini-cli

Gemini CLI + Watchfire

Watchfire writes a dedicated prompt file under `~/.watchfire/gemini-home/<session>/system.md` for each session and points `GEMINI_SYSTEM_MD` at it. Your Gemini login and shared CLI settings still come from `~/.gemini/`, but the Watchfire system prompt and task context stay isolated per session.

Install with Gemini CLI as default

Install Watchfire, then initialise a project that defaults to Gemini CLI. Make sure the agent CLI is installed and authenticated outside Watchfire first.

watchfire init --agent gemini

See the installation guide for platform installers and Homebrew taps.

Interop notes

  • Watchfire sets `GEMINI_SYSTEM_MD` to a per-session prompt file
  • Auth and shared settings live in `~/.gemini/`
  • Keep Gemini CLI working outside Watchfire first — Watchfire reuses the shared setup