| 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: truefor Bash calls - Always append
2>&1to 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