gemini-cli

name	gemini-cli
description	Reference for Gemini CLI usage patterns. Consult before calling gemini via Bash.

Gemini CLI Reference

Quick reference for Gemini CLI commands.

Basic Command

gemini "[prompt]" -m gemini-3-flash-preview -o text 2>&1

Common Flags

Flag	Purpose
-m gemini-3-flash-preview	Model selection
-o text	Human-readable output
-o json	Structured output with stats
-r [index]	Resume session by index
--allowed-tools	Restrict available tools
--list-sessions	List available sessions

Session Continuation

# List sessions
gemini --list-sessions

# Resume by index
echo "follow-up prompt" | gemini -r 1 -m gemini-3-flash-preview -o text 2>&1

Bash Execution Notes

• Use dangerouslyDisableSandbox: true for Bash calls
• Always append 2>&1 to capture all output
• Use timeout of 300000ms (5 min) or longer for complex tasks

Troubleshooting

EPERM errors: Gemini needs write access to ~/.gemini/tmp/ - use dangerouslyDisableSandbox: true

File access: Gemini can only read files in the workspace directory (project root)

Rate limits: Free tier is 60/min, 1000/day. CLI auto-retries with backoff.

More Information

• CLI reference: gemini --help
• Official docs: https://github.com/google-gemini/gemini-cli