Skip to main content
Watchfire
AgentsFirst-class

Gemini CLI

Google's Gemini coding agent on the command line.

github.com/google-gemini/gemini-cli

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.

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.

  • 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
See the full Gemini CLI backend page

Setup

Install Watchfire and initialise a project that defaults to Gemini CLI. Make sure the agent CLI itself is installed and signed in first.

watchfire init --agent gemini

Related docs

Other agents integrations

First-class

Claude Code

Anthropic's CLI coding agent — the original Watchfire backend.

Read more
First-class

Codex

OpenAI's Codex CLI — long-running coding sessions with isolated homes.

Read more
First-class

opencode

Open-source coding agent — bring your own provider.

Read more

See all integrations

Ready to go

Get started with Watchfire

Install in seconds. Define tasks. Let agents ship code for you.

Download for macOS

Available for macOS, Linux, and Windows

install
# Install via Homebrew (macOS)
$brew tap watchfire-io/tap
$brew install --cask watchfire-io/tap/watchfire
# Set up your project and go
$watchfire init
$watchfire task add "Build the login page"
$watchfire start --all

Includes GUI, CLI, and daemon. Also available via Homebrew.

View on GitHubRead the Docs