MediaMetz/gemini-cli
1
0
Fork 0
mirror of https://github.com/google-gemini/gemini-cli.git synced 2026-04-25 12:34:38 -07:00
Code Issues Packages Projects Releases Wiki Activity

Docs: Update Gemini 3 Documentation (#91)

Browse Source 
* Update docs.

* Update model docs.
This commit is contained in:
Jenna Inouye
2025-12-16 14:00:39 -08:00
committed by Tommaso Sciortino
parent c5109d7531
commit ce2eba283b
3 changed files with 60 additions and 79 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/cli/model.md
+30 -30
View File
@@ -1,12 +1,13 @@
# Gemini CLI model selection (`/model` command) # Gemini CLI model selection (`/model` command)
Select your Gemini CLI model. The `/model` command opens a dialog where you can Select your Gemini CLI model. The `/model` command lets you configure the model
configure the model used by Gemini CLI, giving you more control over your used by Gemini CLI, giving you more control over your results. Use **Pro**
results. models for complex tasks and reasoning, **Flash** models for high speed results,
or the (recommended) **Auto** setting to choose the best model for your tasks.
**Note:** The `/model` command (and the `--model` flag) does not override the > **Note:** The `/model` command (and the `--model` flag) does not override the
model used by sub-agents. Consequently, even when using the `/model` flag you > model used by sub-agents. Consequently, even when using the `/model` flag you
may see other models used in your model usage reports. > may see other models used in your model usage reports.
## How to use the `/model` command ## How to use the `/model` command
@@ -16,26 +17,25 @@ Use the following command in Gemini CLI:
/model /model
``` ```
Running this command will open a dialog with your model options: Running this command will open a dialog with your options:
| Option | Description | Models | | Option | Description | Models |
| ------------------ | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | | ----------------- | -------------------------------------------------------------- | ---------------------------------------------------------------------- |
| Auto (recommended) | Let the system choose the best model for your task. | gemini-3-pro-preview (if enabled), gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite | | Auto (Gemini 3) | Let the system choose the best Gemini 3 model for your task. | gemini-3-pro-preview (if enabled), gemini-3-flash-preview (if enabled) |
| Pro | For complex tasks that require deep reasoning and creativity. | gemini-3-pro-preview (if enabled), gemini-2.5-pro | | Auto (Gemini 2.5) | Let the system choose the best Gemini 2.5 model for your task. | gemini-2.5-pro, gemini-2.5-flash |
| Flash | For tasks that need a balance of speed and reasoning. | gemini-2.5-flash | | Manual | Select a specific model. | Any available model. |
| Flash-Lite | For simple tasks that need to be done quickly. | gemini-2.5-flash-lite |
### Gemini 3 Pro and preview features We recommend selecting one of the above **Auto** options. However, you can
select **Manual** to select a specific model from those available.
Note: Gemini 3 is not currently available on all account types. To learn more ### Gemini 3 and preview features
about Gemini 3 access, refer to
[Gemini 3 Pro on Gemini CLI](../get-started/gemini-3.md).
To enable Gemini 3 Pro (if available), enable > **Note:** Gemini 3 is not currently available on all account types. To learn
[**Preview features** by using the `settings` command](../cli/settings.md). Once > more about Gemini 3 access, refer to
enabled, Gemini CLI will attempt to use Gemini 3 Pro when you select **Auto** or > [Gemini 3 on Gemini CLI](../get-started/gemini-3.md).
**Pro**. Both **Auto** and **Pro** will try to use Gemini 3 Pro before falling
back to Gemini 2.5 Pro. To enable Gemini 3 Pro and Gemini 3 Flash (if available), enable
[**Preview Features** by using the `settings` command](../cli/settings.md).
You can also use the `--model` flag to specify a particular Gemini model on You can also use the `--model` flag to specify a particular Gemini model on
startup. For more details, refer to the startup. For more details, refer to the
@@ -46,16 +46,16 @@ Gemini CLI.
## Best practices for model selection ## Best practices for model selection
- **Default to Auto (recommended).** For most users, the _Auto (recommended)_ - **Default to Auto.** For most users, the _Auto_ option model provides a
model provides a balance between speed and performance, automatically balance between speed and performance, automatically selecting the correct
selecting the correct model based on the complexity of the task. Example: model based on the complexity of the task. Example: Developing a web
Developing a web application could include a mix of complex tasks (building application could include a mix of complex tasks (building architecture and
architecture and scaffolding the project) and simple tasks (generating CSS). scaffolding the project) and simple tasks (generating CSS).
- **Switch to Pro if you aren't getting the results you want.** If you think you - **Switch to Pro if you aren't getting the results you want.** If you think you
need your model to be a little "smarter," use Pro. Pro will provide you with need your model to be a little "smarter," you can manually select Pro. Pro
the highest levels of reasoning and creativity. Example: A complex or will provide you with the highest levels of reasoning and creativity. Example:
multi-stage debugging task. A complex or multi-stage debugging task.
- **Switch to Flash or Flash-Lite if you need faster results.** If you need a - **Switch to Flash or Flash-Lite if you need faster results.** If you need a
simple response quickly, Flash or Flash-Lite is the best option. Example: simple response quickly, Flash or Flash-Lite is the best option. Example:
docs/get-started/gemini-3.md
+29 -48
View File
@@ -1,56 +1,37 @@
# Gemini 3 Pro on Gemini CLI # Gemini 3 Pro and Gemini 3 Flash on Gemini CLI
We’re excited to bring Gemini 3 Pro to Gemini CLI. Gemini 3 Pro is **currently Gemini 3 Pro and Gemini 3 Flash are now available on Gemini CLI! Currently, most
available** on Gemini CLI to all of the following subscribers: paid customers of Gemini CLI will have access to both Gemini 3 Pro and Gemini 3
Flash, including the following subscribers:
- Google AI Ultra (except Google AI Ultra for Business). - Google AI Pro and Google AI Ultra (excluding business customers).
- Google AI Pro. - Gemini Code Assist Standard and Enterprise (requires
- Gemini Code Assist Standard (requires
[administrative enablement](#administrator-instructions)). [administrative enablement](#administrator-instructions)).
- Gemini Code Assist Enterprise (requires - Paid Gemini API and Vertex API key holders.
[administrative enablement](#administrator-instructions)).
- Paid Gemini API key holders.
- Paid Vertex API key holders.
For **everyone else**, we're gradually expanding access For free tier users:
[through a waitlist](https://goo.gle/geminicli-waitlist-signup). If you don't
have one of the listed subscriptions, sign up for the waitlist to access Gemini
3 Pro once approved.
**Note:** Whether you’re automatically granted access or accepted from the - If you signed up for the waitlist, please check your email for details. We’ve
waitlist, you’ll still need to enable Gemini 3 Pro onboarded everyone who signed up to the previously available waitlist.
[using the `/settings` command](../cli/settings.md). - If you were not on our waitlist, we’re rolling out additional access gradually
to ensure the experience remains fast and reliable. Stay tuned for more
details.
## How to join the waitlist ## How to get started with Gemini 3 on Gemini CLI
Users not automatically granted access will need to join the waitlist. Follow Get started by upgrading Gemini CLI to the latest version (0.21.1):
these instructions to sign up:
- Install Gemini CLI. ```bash
- Authenticate using the **Login with Google** option. You’ll see a banner that npm install -g @google/gemini-cli@latest
says “Gemini 3 is now available.” If you do not see this banner, update your ```
installation of Gemini CLI to the most recent version.
- Fill out this Google form:
[Access Gemini 3 in Gemini CLI](https://goo.gle/geminicli-waitlist-signup).
Provide the email address of the account you used to authenticate with Gemini
CLI.
Users will be onboarded in batches, subject to availability. When you’ve been After you’ve confirmed your version is 0.21.1 or later:
granted access to Gemini 3 Pro, you’ll receive an acceptance email to your
submitted email address.
**Note:** Please wait until you have been approved to use Gemini 3 Pro to enable 1. Use the `/settings` command in Gemini CLI.
**Preview Features**. If enabled early, the CLI will fallback to Gemini 2.5 Pro. 2. Toggle **Preview Features** to `true`.
3. Run `/model` and select **Auto (Gemini 3)**.
## How to use Gemini 3 Pro with Gemini CLI For more information, see [Gemini CLI model selection](../cli/model.md).
Once you receive your acceptance email–or if you are automatically granted
access–you still need to enable Gemini 3 Pro within Gemini CLI.
To enable Gemini 3 Pro, use the `/settings` command in Gemini CLI and set
**Preview Features** to `true`.
For more information, see [Gemini CLI Settings](../cli/settings.md).
### Usage limits and fallback ### Usage limits and fallback
@@ -68,10 +49,10 @@ There may be times when the Gemini 3 Pro model is overloaded. When that happens,
Gemini CLI will ask you to decide whether you want to keep trying Gemini 3 Pro Gemini CLI will ask you to decide whether you want to keep trying Gemini 3 Pro
or fallback to Gemini 2.5 Pro. or fallback to Gemini 2.5 Pro.
**Note:** The **Keep trying** option uses exponential backoff, in which Gemini > **Note:** The **Keep trying** option uses exponential backoff, in which Gemini
CLI waits longer between each retry, when the system is busy. If the retry > CLI waits longer between each retry, when the system is busy. If the retry
doesn't happen immediately, please wait a few minutes for the request to > doesn't happen immediately, please wait a few minutes for the request to
process. > process.
### Model selection and routing types ### Model selection and routing types
@@ -92,7 +73,7 @@ manage your usage limits:
To learn more about selecting a model and routing, refer to To learn more about selecting a model and routing, refer to
[Gemini CLI Model Selection](../cli/model.md). [Gemini CLI Model Selection](../cli/model.md).
## How to enable Gemini 3 Pro with Gemini CLI on Gemini Code Assist ## How to enable Gemini 3 with Gemini CLI on Gemini Code Assist
If you're using Gemini Code Assist Standard or Gemini Code Assist Enterprise, If you're using Gemini Code Assist Standard or Gemini Code Assist Enterprise,
enabling Gemini 3 Pro on Gemini CLI requires configuring your release channels. enabling Gemini 3 Pro on Gemini CLI requires configuring your release channels.
@@ -123,7 +104,7 @@ then:
- Use the `/settings` command. - Use the `/settings` command.
- Set **Preview Features** to `true`. - Set **Preview Features** to `true`.
Restart Gemini CLI and you should have access to Gemini 3 Pro. Restart Gemini CLI and you should have access to Gemini 3.
## Need help? ## Need help?
docs/sidebar.json
+1 -1
View File
@@ -24,7 +24,7 @@
"slug": "docs/get-started" "slug": "docs/get-started"
}, },
{ {
"label": "Gemini 3 Pro on Gemini CLI", "label": "Gemini 3 on Gemini CLI",
"slug": "docs/get-started/gemini-3" "slug": "docs/get-started/gemini-3"
}, },
{ {