Skip to content

An AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.

docs: fix gemini-cli authentication documentation (#923)

Ben Vargas5b9416f673a7
diff --git a/docs/providers/gemini-cli.md b/docs/providers/gemini-cli.md
index 79f290a4..c4e9f7a8 100644
--- a/docs/providers/gemini-cli.md
+++ b/docs/providers/gemini-cli.md
@@ -4,11 +4,11 @@ The Gemini CLI provider allows you to use Google's Gemini models through the Gem
## Why Use Gemini CLI?
-The primary benefit of using the `gemini-cli` provider is to leverage your existing Gemini Pro subscription or OAuth authentication configured through the Gemini CLI. This is ideal for users who:
+The primary benefit of using the `gemini-cli` provider is to leverage your existing Personal Gemini Code Assist license/usage Google offers for free, or Gemini Code Assist Standard/Enterprise subscription you may already have, via OAuth configured through the Gemini CLI. This is ideal for users who:
-- Have an active Gemini subscription
+- Have an active Gemini Code Assist license (including those using the free tier offere by Google)
- Want to use OAuth authentication instead of managing API keys
-- Have already configured authentication via `gemini auth login`
+- Have already configured authentication via `gemini` OAuth login
## Installation
@@ -26,11 +26,11 @@ npm install -g @google/gemini-cli
The Gemini CLI provider is designed to use your pre-configured OAuth authentication:
```bash
-# Authenticate with your Google account
-gemini auth login
+# Launch Gemini CLI and go through the authentication procedure
+gemini
```
-This will open a browser window for OAuth authentication. Once authenticated, Task Master will automatically use these credentials when you select the `gemini-cli` provider.
+For OAuth use, select `Login with Google` - This will open a browser window for OAuth authentication. Once authenticated, Task Master will automatically use these credentials when you select the `gemini-cli` provider and models.
### Alternative Method: API Key
@@ -42,8 +42,18 @@ export GEMINI_API_KEY="your-gemini-api-key"
**Note:** If you want to use API keys, consider using the standard `google` provider instead, as `gemini-cli` is specifically designed for OAuth/subscription users.
+More details on authentication steps and options can be found in the [gemini-cli GitHub README](https://github.com/google-gemini/gemini-cli).
+
## Configuration
+Use the `task-master init` command to run through the guided initialization:
+
+```bash
+task-master init
+```
+
+**OR**
+
Configure `gemini-cli` as a provider using the Task Master models command:
```bash
@@ -54,14 +64,44 @@ task-master models --set-main gemini-2.5-pro --gemini-cli
task-master models --set-main gemini-2.5-flash --gemini-cli
```
-You can also manually edit your `.taskmaster/config/providers.json`:
+You can also manually edit your `.taskmaster/config.json`:
```json
{
- "main": {
- "provider": "gemini-cli",
- "model": "gemini-2.5-flash"
- }
+ "models": {
+ "main": {
+ "provider": "gemini-cli",
+ "modelId": "gemini-2.5-pro",
+ "maxTokens": 65536,
+ "temperature": 0.2
+ },
+ "research": {
+ "provider": "gemini-cli",
+ "modelId": "gemini-2.5-pro",
+ "maxTokens": 65536,
+ "temperature": 0.1
+ },
+ "fallback": {
+ "provider": "gemini-cli",
+ "modelId": "gemini-2.5-flash",
+ "maxTokens": 65536,
+ "temperature": 0.2
+ }
+ },
+ "global": {
+ "logLevel": "info",
+ "debug": false,
+ "defaultNumTasks": 10,
+ "defaultSubtasks": 5,
+ "defaultPriority": "medium",
+ "projectName": "Taskmaster",
+ "ollamaBaseURL": "http://localhost:11434/api",
+ "bedrockBaseURL": "https://bedrock.us-east-1.amazonaws.com",
+ "responseLanguage": "English",
+ "defaultTag": "master",
+ "azureOpenaiBaseURL": "https://your-endpoint.openai.azure.com/"
+ },
+ "claudeCode": {}
}
```
@@ -75,45 +115,11 @@ The gemini-cli provider supports only two models:
### Basic Usage
-Once authenticated with `gemini auth login` and configured, simply use Task Master as normal:
+Once gemini-cli is installed and authenticated, and Task Master simply use Task Master as normal:
```bash
# The provider will automatically use your OAuth credentials
-task-master new "Create a hello world function"
-```
-
-### With Specific Parameters
-
-Configure model parameters in your providers.json:
-
-```json
-{
- "main": {
- "provider": "gemini-cli",
- "model": "gemini-2.5-pro",
- "parameters": {
- "maxTokens": 65536,
- "temperature": 0.7
- }
- }
-}
-```
-
-### As Fallback Provider
-
-Use gemini-cli as a fallback when your primary provider is unavailable:
-
-```json
-{
- "main": {
- "provider": "anthropic",
- "model": "claude-3-5-sonnet-latest"
- },
- "fallback": {
- "provider": "gemini-cli",
- "model": "gemini-2.5-flash"
- }
-}
+task-master parse-prd my-prd.txt
```
## Troubleshooting
@@ -122,9 +128,9 @@ Use gemini-cli as a fallback when your primary provider is unavailable:
If you get an authentication error:
-1. **Primary solution**: Run `gemini auth login` to authenticate with your Google account
-2. **Check authentication status**: Run `gemini auth status` to verify you're logged in
-3. **If using API key** (not recommended): Ensure `GEMINI_API_KEY` is set correctly
+1. **Primary solution**: Run `gemini` to authenticate with your Google account - use `/auth` slash command in **gemini-cli** to change authentication method if desired.
+2. **Check authentication status**: Run `gemini` and use `/about` to verify your Auth Method and GCP Project if applicable.
+3. **If using API key** (not recommended): Ensure `GEMINI_API_KEY` env variable is set correctly, see the gemini-cli README.md for more info.
### "Model not found" Error
@@ -146,23 +152,9 @@ npm install -g @google/gemini-cli
gemini --version
```
-### Custom Endpoints
-
-Custom endpoints can be configured if needed:
-
-```json
-{
- "main": {
- "provider": "gemini-cli",
- "model": "gemini-2.5-pro",
- "baseURL": "https://custom-endpoint.example.com"
- }
-}
-```
-
## Important Notes
-- **OAuth vs API Key**: This provider is specifically designed for users who want to use OAuth authentication via `gemini auth login`. If you prefer using API keys, consider using the standard `google` provider instead.
+- **OAuth vs API Key**: This provider is specifically designed for users who want to use OAuth authentication via gemini-cli. If you prefer using API keys, consider using the standard `google` provider instead.
- **Limited Model Support**: Only `gemini-2.5-pro` and `gemini-2.5-flash` are available through gemini-cli.
- **Subscription Benefits**: Using OAuth authentication allows you to leverage any subscription benefits associated with your Google account.
- The provider uses the `ai-sdk-provider-gemini-cli` npm package internally.
diff --git a/src/ai-providers/gemini-cli.js b/src/ai-providers/gemini-cli.js
index a96cb048..1b7a4474 100644
--- a/src/ai-providers/gemini-cli.js
+++ b/src/ai-providers/gemini-cli.js
@@ -67,8 +67,7 @@ export class GeminiCliProvider extends BaseAIProvider {
apiKey: params.apiKey
};
} else {
- // Expected case: Use gemini CLI authentication
- // Requires: gemini auth login (pre-configured)
+ // Expected case: Use gemini CLI authentication via OAuth
authOptions = {
authType: 'oauth-personal'
};