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

Non-Interactive Mode

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

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.

Related Pages

• Backends Overview
• Troubleshooting