| name | gemini.quickstart |
| description | Agent workflow for running Gemini CLI in deterministic headless mode with JSON outputs. |
| tags | gemini,ai,automation,headless,json |
gemini Quickstart
Use this when you need Gemini in scripts or agent workflows without interactive prompts.
1) Install plugin and dependency
supercli plugins learn gemini
supercli plugins install gemini --json
npm install -g @google/gemini-cli
2) Validate setup
supercli gemini cli version
3) Headless modes
supercli gemini task text --prompt "Summarize this repository"
supercli gemini task ask --prompt "Summarize this repository as JSON"
supercli gemini task stream --prompt "Plan and execute test workflow"
4) Full passthrough for upstream flags
supercli gemini -p "Explain the architecture" --output-format json
supercli gemini -p "Run diagnostics" --output-format stream-json
5) Caveats
- Prefer non-interactive auth for automation (for example
GEMINI_API_KEY) to avoid login prompts.
task stream returns JSONL event lines; consume line-by-line.
- Use passthrough commands for advanced options not covered by wrappers.