Gemini CLI
Google Gemini CLI
- gemini
Headless -p mode, settings.json per scope, audio through read_file.
- Invoke
- 2 of 6 · official
- Models
- no listing
- MCP
- json · standard
- Agents file
- ~/.gemini/GEMINI.md
Access
- Get
getHarness("gemini") - CLI
harnesses paths gemini --json - Trygemini in the explorer
Gemini CLI is the one harness with a %PROGRAMDATA% path, for the managed settings on Windows, and one of two with a verified native audio route: its read_file tool accepts audio files. Video is not documented and is recorded as false. The request that asked for it: google-gemini/gemini-cli#27194.
Sessions are JSON under ~/.gemini/history/<project-id>/, where the id is a slug from projects.json rather than the path, so the note is there. Custom commands are TOML files. The global instructions file is ~/.gemini/GEMINI.md, and syncAgentsFiles links it like any other.
Capabilities and invocation
- mcp: yes
- vision: yes
- audio: yes
- video: no
- tools: yes
- streaming: yes
Binary gemini, evidence official. Non-interactive (headless) mode. Model selection appends --model {model}.
- advisor{}rejected
- advisor · json{ structured: true }rejected
- read-only{ readOnly: true }rejected
- read-only · json{ readOnly: true, structured: true }rejected
- agent{ tools: true }
-p {prompt} - agent · json{ tools: true, structured: true }
-p {prompt} --output-format json
Paths
Templates as the registry stores them. ~, ${HOME}, ${TMPDIR} and %VAR% expand in resolve(); entries tagged with a platform are dropped on the others. Open in the explorer to see them expanded for a home directory of your choice.
config
~/.gemini/settings.json.gemini/settings.json/etc/gemini-cli/settings.json/Library/Application Support/GeminiCli/settings.json%PROGRAMDATA%/gemini-cli/settings.json
sessions
~/.gemini/history/<project-id>/Conversation history per project (project-id is a slug from projects.json).
~/.gemini/tmp/<project-id>/chats/Active chat session data.
instructions
GEMINI.md~/.gemini/GEMINI.mdGlobal instruction/memory file.
skills
.gemini/skills/.agents/skills/~/.gemini/skills/~/.agents/skills/
commands
.gemini/commands/Custom commands in TOML format.
~/.gemini/commands/Global custom commands in TOML format.
promptTemplates
.gemini/commands/Custom commands in TOML format.
~/.gemini/commands/Global custom commands in TOML format.
Empty
hookstempThat is not the same as the feature being missing.
MCP servers
~/.gemini/settings.jsonuser · json · standard · mcpServers.gemini/settings.jsonproject · json · standard · mcpServers
Detection
envVars
- GEMINI_CLI
projectMarkers
- .gemini
- GEMINI.md
Persistence
- JSON - Settings files. (official)
- JSON - Session and history records. (official)
syncAgentsFiles links ~/.gemini/GEMINI.md to the master bundle.