gemini-cli

Reference for Gemini CLI usage patterns. Consult before calling gemini via Bash.

⭐3stars🔀0forks📁View on GitHub🕐Updated Dec 21, 2025

When & Why to Use This Skill

This Claude skill provides a comprehensive reference for Gemini CLI usage patterns, enabling seamless integration of Gemini's generative AI capabilities into Bash environments. It offers standardized command structures, model selection guides, and troubleshooting protocols to ensure reliable execution and session continuity within automated developer workflows.

Use Cases

  • Automating AI-powered tasks within shell scripts by providing correct syntax for Gemini CLI commands.
  • Managing persistent AI conversations across multiple sessions using session listing and resume flags.
  • Debugging execution errors in sandboxed environments by applying recommended Bash execution notes and permission fixes.
  • Extracting structured JSON data from Gemini models for integration into downstream data processing pipelines.
  • Optimizing CLI performance by configuring appropriate timeouts and model parameters for complex generative tasks.
namegemini-cli
descriptionReference 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