Skip to content

Commit 89cf7f9

Browse files
hannesrudolphhannesrudolph
authored
Add Gemini CLI provider documentation and update release notes for v3… (#241)
1 parent 63a1ea1 commit 89cf7f9

File tree

10 files changed

+234
-3
lines changed

10 files changed

+234
-3
lines changed

‎docs/providers/gemini-cli.md‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
sidebar_label: Gemini CLI
3+
---
4+
5+
# Using the Gemini CLI Provider With Roo Code
6+
7+
Use your personal Google account to access Gemini models for free without managing API keys. This provider authenticates using credentials from the official `gemini` command-line tool.
8+
9+
**Website:** [https://github.com/google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli)
10+
11+
---
12+
13+
## Why Use This Provider
14+
15+
- **No API Key Required**: Authenticates via the Gemini CLI's OAuth flow.
16+
- **Free Tier Access**: Leverages the free tier available to personal Google accounts.
17+
- **Simple Setup**: Install and authenticate with the Gemini CLI once.
18+
- **Secure**: Credentials are stored locally and refreshed automatically.
19+
20+
When you use the Gemini CLI provider, you simply log in once using Google's official command-line tool. Roo Code then securely uses those credentials, so you can start working right away.
21+
22+
---
23+
24+
## How It Works
25+
26+
The Gemini CLI provider integrates with Google's ecosystem:
27+
28+
1. **Installation & Login**: Install the `gemini` CLI tool and run `gemini auth` to log in to your Google account. This creates a secure OAuth credentials file on your local machine.
29+
2. **Credential Loading**: When you select this provider in Roo Code, it reads the credentials from the default location (`~/.gemini/oauth_creds.json`) or a custom path you provide.
30+
3. **Authentication**: Roo Code uses these credentials to obtain a temporary access token from Google's authentication servers.
31+
4. **API Calls**: The access token is used to make secure calls to Google's Code Assist API, which powers the Gemini models. The provider handles refreshing the token automatically when it expires.
32+
33+
---
34+
35+
## Prerequisites
36+
37+
Before using this provider, you must:
38+
39+
- Install the official [Gemini CLI tool](https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#quickstart).
40+
- Run `gemini auth` in your terminal and log in with your Google account.
41+
- **Note:** This provider works with **personal Google accounts** and is not compatible with Google Workspace accounts.
42+
43+
---
44+
45+
## Configuration in Roo Code
46+
47+
1. **Open Roo Code Settings:** Click the gear icon (<Codicon name="gear" />) in the Roo Code panel.
48+
2. **Select Provider:** Choose "Gemini CLI" from the "API Provider" dropdown.
49+
3. **Set OAuth Credentials Path (Optional):**
50+
- **Setting**: `geminiCliOAuthPath`
51+
- **Description**: The file path to your OAuth credentials JSON file. Leave this blank to use the default path.
52+
- **Default**: `~/.gemini/oauth_creds.json`.
53+
54+
---
55+
56+
## Common Questions
57+
58+
**"Where do I find the `oauth_creds.json` file?"**
59+
60+
After you run `gemini auth`, the file is automatically created. On macOS and Linux, it's typically located in `~/.gemini/oauth_creds.json`.
61+
62+
**"What if my authentication expires?"**
63+
64+
Roo Code will automatically use the refresh token to get a new access token. If the refresh token itself expires, you may need to run `gemini auth` again.
65+
66+
**"I'm getting an error about a 'bad request' or '401 Unauthorized'."**
67+
68+
This usually means your credentials have expired or are invalid. Try running `gemini auth` in your terminal again to re-authenticate. Ensure you are logged into a personal Google account, not a Google Workspace account.

‎docs/update-notes/index.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,9 @@ This section contains notes about recent updates to Roo Code, listed by version
55

66
## Version 3.22
77

8+
* [3.22.3](/update-notes/v3.22.3) (2025-06-27)
9+
* [3.22.2](/update-notes/v3.22.2) (2025-06-27)
10+
* [3.22.1](/update-notes/v3.22.1) (2025-06-27)
811
* [3.22](/update-notes/v3.22) (2025-06-25)
912
* [3.22.0](/update-notes/v3.22.0) (2025-06-25)
1013

‎docs/update-notes/temp_pr_analysis.md‎

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
# PR Analysis for Release Notes
2+
3+
## PR #5195: v3.22.2
4+
5+
**Author**: mrubens
6+
**Linked Issues**: None found
7+
**Category**: Security/Bug Fixes/Features (Mixed Release)
8+
**User Impact**: This is a comprehensive patch release that addresses a critical security vulnerability, fixes several UI and functionality bugs, and enhances Code Index capabilities. Users get improved security with XSS protection, better terminal integration, fixed checkpoint functionality, corrected Gemini CLI error messages, and more reliable Code Index service management.
9+
**Contributors**: mrubens
10+
11+
**Detailed Changes**:
12+
- **Security**: Fixed XSS vulnerability in CodeBlock component
13+
- **Bug Fixes**: Terminal keyboard shortcut errors, checkpoint popover issues, i18n Gemini CLI translation paths
14+
- **Features**: Code Index (Qdrant) service recreation on configuration changes
15+
16+
---
17+
18+
## PR #5194: fix(i18n): correct gemini cli error translation paths
19+
20+
**Author**: daniel-lxs
21+
**Linked Issues**: None
22+
**Category**: Bug Fix
23+
**User Impact**: Fixed error message display for Gemini CLI across all supported languages by correcting translation paths in locale files
24+
**Contributors**: daniel-lxs
25+
26+
---
27+
28+
## PR #5192: Fix checkpoint popover not opening due to StandardTooltip wrapper conflict
29+
30+
**Author**: daniel-lxs
31+
**Linked Issues**: #5173 (reporter: aprpure)
32+
**Category**: Bug Fix
33+
**User Impact**: Fixed checkpoint menu not opening when clicked, restoring access to checkpoint functionality that users thought had disappeared
34+
**Contributors**: daniel-lxs, aprpure
35+
36+
---
37+
38+
## PR #5157: fix: eliminate XSS vulnerability in CodeBlock component
39+
40+
**Author**: KJ7LNW
41+
**Linked Issues**: #5156 (reporter: KJ7LNW)
42+
**Category**: Security Fix
43+
**User Impact**: Eliminates cross-site scripting (XSS) vulnerability in code display by replacing unsafe HTML rendering with secure React element rendering
44+
**Contributors**: KJ7LNW
45+
46+
---
47+
48+
## PR #5152: Code Index (Qdrant) recreate services when change configurations
49+
50+
**Author**: catrielmuller
51+
**Linked Issues**: None (references external repo issue)
52+
**Category**: Bug Fix
53+
**User Impact**: Fixed Code Index connection reliability when updating Qdrant configuration settings - services now automatically recreate when configurations change, eliminating the need to manually restart connections
54+
**Contributors**: catrielmuller
55+
56+
---
57+
58+
## PR #5161: fix terminal keyboard shortcut error when adding content to context
59+
60+
**Author**: MuriloFP
61+
**Linked Issues**: #2276 (reporter: iamhenry)
62+
**Category**: Bug Fix
63+
**User Impact**: Fixed error when using keyboard shortcuts to add terminal content to context. Users can now use keyboard shortcuts reliably to add terminal output to their context without encountering "Cannot read properties of undefined" errors.
64+
**Contributors**: MuriloFP, iamhenry
65+
66+
---
67+
68+
## PR #5201: v3.22.3
69+
70+
**Author**: mrubens (excluded from acknowledgment per rules)
71+
**Linked Issues**: None found
72+
**Category**: Bug Fix
73+
**User Impact**: Fixed JSON backwards compatibility for `.roomodes` files to ensure older custom modes can be restored correctly without errors
74+
**Contributors**: None (author excluded per documentation rules)
75+
76+
---
77+
78+
## PR #5199: fix: restore JSON backwards compatibility for .roomodes files
79+
80+
**Author**: daniel-lxs
81+
**Linked Issues**: #5180 (reporter: domc66), #5139 (reporter: africa1207)
82+
**Category**: Bug Fix
83+
**User Impact**: Fixed compatibility issue where existing JSON .roomodes files caused YAML format errors and prevented custom modes from working after updating to v3.22.0. Users with JSON format custom mode files can now use them without errors.
84+
**Contributors**: daniel-lxs, domc66, africa1207
85+
86+
---

‎docs/update-notes/v3.22.0.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ This enables configuration management across projects and machines, perfect for
2929

3030
<img src="/img/v3.22.0/v3.22.0.png" alt="Enhanced mode selector interface showing improved highlighting and descriptive text for better user experience" width="400" />
3131

32-
* **Quick Fix Control**: Added setting to disable Roo Code quick fixes, preventing conflicts with other extensions (thanks OlegOAndreev!) ([#4878](https://github.com/RooCodeInc/Roo-Code/pull/4878)) - [Learn more](/features/code-actions#disabling-enabling-code-actions)
32+
* **Quick Fix Control**: Added setting to disable Roo Code quick fixes, preventing conflicts with other extensions (thanks OlegOAndreev!) ([#4878](https://github.com/RooCodeInc/Roo-Code/pull/4878)) - [Learn more](/features/code-actions#disablingenabling-code-actions)
3333

3434
<img src="/img/v3.22.0/v3.22.0-1.png" alt="VSCode settings showing the Enable Roo Code quick fixes toggle option" width="300" />
3535

‎docs/update-notes/v3.22.1.mdx‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# Roo Code 3.22.1 Release Notes (2025-06-27)
2+
3+
This release introduces free Gemini access via OAuth, fixes several bugs, and improves the overall user experience.
4+
5+
## Gemini CLI Provider (Free Access)
6+
7+
We've added a new Gemini CLI provider that enables free access to Google's Gemini models without requiring API keys ([#5137](https://github.com/RooCodeInc/Roo-Code/pull/5137)):
8+
9+
- **OAuth Authentication**: Sign in with your Google account to access Gemini models at no cost
10+
- **Automatic Project Discovery**: Seamlessly connects to your Google Cloud projects
11+
- **Streaming Responses**: Real-time response streaming for better interactivity
12+
- **Complete Integration**: Full UI support with comprehensive setup guidance
13+
14+
This gives you another powerful free option alongside local models and other free providers.
15+
16+
## Bug Fixes
17+
18+
* **MCP Server Display**: Fixed "undefined" text appearing in system prompts for HTTP SSE MCP servers like Figma MCP ([#5107](https://github.com/RooCodeInc/Roo-Code/pull/5107))
19+
* **Groq Model Limits**: Corrected maximum token limit for Qwen3-32B model from 131,072 to 40,960 tokens, preventing API errors (thanks KanTakahiro, Maxxoto!) ([#5138](https://github.com/RooCodeInc/Roo-Code/pull/5138))
20+
21+
## QOL Improvements
22+
23+
* **Consistent Tooltips**: Standardized tooltip delays to 300ms across the entire application for smooth, predictable behavior ([#5098](https://github.com/RooCodeInc/Roo-Code/pull/5098))
24+
* **Cost Transparency**: Improved OpenRouter BYOK cost calculation accuracy using official upstream costs and restored cached token count visibility ([#5145](https://github.com/RooCodeInc/Roo-Code/pull/5145))

‎docs/update-notes/v3.22.2.mdx‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Roo Code 3.22.2 Release Notes (2025-06-27)
2+
3+
This release includes important security fixes, bug fixes, and improvements to ensure a more reliable and secure experience.
4+
5+
## Security Fixes
6+
7+
* **Code Display**: Eliminated XSS vulnerability in code block rendering for enhanced security (thanks KJ7LNW!) ([#5157](https://github.com/RooCodeInc/Roo-Code/pull/5157))
8+
9+
## Bug Fixes
10+
11+
* **Checkpoint Menu**: Fixed checkpoint popover not opening when clicked, restoring access to checkpoint functionality (thanks daniel-lxs, aprpure!) ([#5192](https://github.com/RooCodeInc/Roo-Code/pull/5192))
12+
* **Terminal Integration**: Fixed keyboard shortcut errors when adding terminal content to context (thanks MuriloFP, iamhenry!) ([#5161](https://github.com/RooCodeInc/Roo-Code/pull/5161))
13+
* **Gemini CLI**: Corrected error message translation paths across all supported languages (thanks daniel-lxs!) ([#5194](https://github.com/RooCodeInc/Roo-Code/pull/5194))
14+
* **Code Index**: Fixed Qdrant service connection reliability when updating configuration settings - services now automatically recreate when configurations change (thanks catrielmuller!) ([#5152](https://github.com/RooCodeInc/Roo-Code/pull/5152))

‎docs/update-notes/v3.22.3.mdx‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# Roo Code 3.22.3 Release Notes (2025-06-27)
2+
3+
This release fixes compatibility issues with custom mode files to ensure a smooth experience for users upgrading from earlier versions.
4+
5+
## Bug Fixes
6+
7+
* **Custom Modes**: Fixed JSON backwards compatibility for `.roomodes` files, ensuring older custom modes work correctly after updating from previous versions (thanks daniel-lxs, domc66, africa1207!) ([#5199](https://github.com/RooCodeInc/Roo-Code/pull/5199))

‎docs/update-notes/v3.22.mdx‎

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Roo Code 3.22 Release Notes
22

3-
This major release introduces 1-click task sharing, global rule directories, enhanced mode discovery, and comprehensive bug fixes for memory leaks and provider integration.
3+
This major release introduces 1-click task sharing, global rule directories, free Gemini access, enhanced mode discovery, and comprehensive bug fixes for memory leaks and provider integration.
44

55
## 1-Click Task Sharing
66

@@ -23,18 +23,43 @@ We've added support for cross-workspace custom instruction sharing through globa
2323

2424
This enables configuration management across projects and machines, perfect for organizational onboarding and maintaining consistent development environments. [Learn how to set up global rules](/features/custom-instructions#setting-up-global-rules).
2525

26+
## Gemini CLI Provider (Free Access)
27+
28+
We've added a new Gemini CLI provider that enables free access to Google's Gemini models without requiring API keys:
29+
30+
- **OAuth Authentication**: Sign in with your Google account to access Gemini models at no cost
31+
- **Automatic Project Discovery**: Seamlessly connects to your Google Cloud projects
32+
- **Streaming Responses**: Real-time response streaming for better interactivity
33+
- **Complete Integration**: Full UI support with comprehensive setup guidance
34+
35+
This gives you another powerful free option alongside local models and other free providers.
36+
2637
## QOL Improvements
2738

2839
* **Mode Discovery**: Enhanced mode selector with highlighting for new users, redesigned interface, and descriptive text. Also moved the [Roo Code Marketplace](/features/marketplace) and [Mode configuration](/features/custom-modes) buttons out of the top menu for better organization (thanks brunobergher!) ([#4902](https://github.com/RooCodeInc/Roo-Code/pull/4902))
2940

3041
<img src="/img/v3.22.0/v3.22.0.png" alt="Enhanced mode selector interface showing improved highlighting and descriptive text for better user experience" width="400" />
3142

32-
* **Quick Fix Control**: Added setting to disable Roo Code quick fixes, preventing conflicts with other extensions (thanks OlegOAndreev!) ([#4878](https://github.com/RooCodeInc/Roo-Code/pull/4878)) - [Learn more](/features/code-actions#disabling-enabling-code-actions)
43+
* **Quick Fix Control**: Added setting to disable Roo Code quick fixes, preventing conflicts with other extensions (thanks OlegOAndreev!) ([#4878](https://github.com/RooCodeInc/Roo-Code/pull/4878)) - [Learn more](/features/code-actions#disablingenabling-code-actions)
3344

3445
<img src="/img/v3.22.0/v3.22.0-1.png" alt="VSCode settings showing the Enable Roo Code quick fixes toggle option" width="300" />
3546

47+
* **Consistent Tooltips**: Standardized tooltip delays to 300ms across the entire application for smooth, predictable behavior ([#5098](https://github.com/RooCodeInc/Roo-Code/pull/5098))
48+
* **Cost Transparency**: Improved OpenRouter BYOK cost calculation accuracy using official upstream costs and restored cached token count visibility ([#5145](https://github.com/RooCodeInc/Roo-Code/pull/5145))
49+
50+
## Security Fixes
51+
52+
* **Code Display**: Eliminated XSS vulnerability in code block rendering for enhanced security (thanks KJ7LNW!) ([#5157](https://github.com/RooCodeInc/Roo-Code/pull/5157))
53+
3654
## Bug Fixes
3755

56+
* **Custom Modes**: Fixed JSON backwards compatibility for `.roomodes` files, ensuring older custom modes work correctly after updating from previous versions (thanks daniel-lxs, domc66, africa1207!) ([#5199](https://github.com/RooCodeInc/Roo-Code/pull/5199))
57+
* **Checkpoint Menu**: Fixed checkpoint popover not opening when clicked, restoring access to checkpoint functionality (thanks daniel-lxs, aprpure!) ([#5192](https://github.com/RooCodeInc/Roo-Code/pull/5192))
58+
* **Terminal Integration**: Fixed keyboard shortcut errors when adding terminal content to context (thanks MuriloFP, iamhenry!) ([#5161](https://github.com/RooCodeInc/Roo-Code/pull/5161))
59+
* **Gemini CLI**: Corrected error message translation paths across all supported languages (thanks daniel-lxs!) ([#5194](https://github.com/RooCodeInc/Roo-Code/pull/5194))
60+
* **Code Index**: Fixed Qdrant service connection reliability when updating configuration settings - services now automatically recreate when configurations change (thanks catrielmuller!) ([#5152](https://github.com/RooCodeInc/Roo-Code/pull/5152))
61+
* **MCP Server Display**: Fixed "undefined" text appearing in system prompts for HTTP SSE MCP servers like Figma MCP ([#5107](https://github.com/RooCodeInc/Roo-Code/pull/5107))
62+
* **Groq Model Limits**: Corrected maximum token limit for Qwen3-32B model from 131,072 to 40,960 tokens, preventing API errors (thanks KanTakahiro, Maxxoto!) ([#5138](https://github.com/RooCodeInc/Roo-Code/pull/5138))
3863
* **Task File Corruption**: Fixed race condition that corrupted task files, eliminating "No existing API conversation history" errors (thanks KJ7LNW!) ([#4733](https://github.com/RooCodeInc/Roo-Code/pull/4733))
3964
* **Memory Leaks**: Fixed multiple memory leaks in chat interface and CodeBlock component that could cause crashes and grey screens (thanks kiwina, xyOz-dev!) ([#4244](https://github.com/RooCodeInc/Roo-Code/pull/4244), [#4190](https://github.com/RooCodeInc/Roo-Code/pull/4190))
4065
* **Task Names**: Fixed blank entries in task history - tasks now display meaningful names like "Task #1 (Incomplete)" (thanks daniel-lxs!) ([#5071](https://github.com/RooCodeInc/Roo-Code/pull/5071))

‎sidebars.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -131,6 +131,7 @@ const sidebars: SidebarsConfig = {
131131
'providers/deepseek',
132132
'providers/chutes',
133133
'providers/gemini',
134+
'providers/gemini-cli',
134135
'providers/glama',
135136
'providers/groq',
136137
'providers/human-relay',
@@ -205,6 +206,9 @@ const sidebars: SidebarsConfig = {
205206
type: 'category',
206207
label: '3.22',
207208
items: [
209+
{ type: 'doc', id: 'update-notes/v3.22.3', label: '3.22.3' },
210+
{ type: 'doc', id: 'update-notes/v3.22.2', label: '3.22.2' },
211+
{ type: 'doc', id: 'update-notes/v3.22.1', label: '3.22.1' },
208212
{ type: 'doc', id: 'update-notes/v3.22', label: '3.22 Combined' },
209213
{ type: 'doc', id: 'update-notes/v3.22.0', label: '3.22.0' },
210214
],

‎temp_pr_analysis.md‎

Whitespace-only changes.

0 commit comments

Comments
 (0)