Skip to main content

Gemini

Gemini CLI is Google's command-line interface for Gemini AI models.

Setup​

[ai.harness.gemini]
enabled = true
install = true

Run aibox apply, then inside the container:

gemini   # Launches Gemini CLI

API Key​

[container.environment]
GOOGLE_API_KEY = "..."

Configuration​

Gemini's configuration is persisted in .aibox-home/.gemini/, mounted at /home/aibox/.gemini/.

MCP Integration​

Gemini CLI reads .gemini/settings.json. aibox generates this file automatically on aibox apply, merging processkit built-in servers, team servers from aibox.toml [ai.mcp], and personal servers from .aibox-local.toml [mcp].

.gemini/settings.json is gitignored — it is regenerated on every aibox apply and must not be committed.

To add MCP servers:

# aibox.toml — team-shared servers
[[mcp.servers]]
name    = "github"
command = "npx"
args    = ["-y", "@modelcontextprotocol/server-github"]

# .aibox-local.toml — personal servers
[[mcp.servers]]
name    = "my-internal-tool"
command = "npx"
args    = ["-y", "@acme/internal-mcp-server"]

Installation​

Gemini CLI is installed via npm (npm install -g @google/generative-ai-cli), with a pip fallback.