For the complete documentation index, see llms.txt. This page is also available as Markdown.

Gemini CLI

Gemini CLI is useful for large-context cloud analysis and agent-style workflows.

Requirements

  • gemini CLI installed.

  • Authentication completed with gemini auth login.

Setup

  1. Install/verify the CLI from the official docs.

  2. Authenticate:

gemini auth login
  1. Verify locally:

gemini "hello"
  1. Configure in AI Backend settings tab.

Configuration

Setting
Value

Preferred Backend

Gemini CLI

Gemini CLI Command

gemini --output-format text --model gemini-2.5-flash --yolo

Notes

--yolo is used by default to avoid interactive approval prompts that can block embedded MCP workflows.

Notes

Windows

npm-installed CLI shims are resolved automatically on Windows. The extension detects .cmd siblings and uses them instead of shell script shims that Java cannot execute directly.

Troubleshooting

  • command not found: use full executable path if needed.

  • Windows: npm shim paths are resolved automatically. If auto-resolution fails, use the full .cmd path: C:\\Users\\<you>\\AppData\\Roaming\\npm\\gemini.cmd.

  • ModelNotFoundError / RESOURCE_EXHAUSTED: choose available model and update --model.

  • Auth errors: re-run gemini auth login.

Last updated