Gemini CLI reference - Subcommands
Gemini CLI commands and subcommands
Gemini CLI documents 28 subcommands, including gemini update, gemini extensions install and gemini extensions uninstall. These run as gemini <command> from your shell. Each row gives the docs' description, accepted values and an example where one is documented.
Last verified 5 official pagesFull Gemini CLI reference
| Command | Description | Example |
|---|---|---|
gemini update | Update to the latest version. Docs: gemini update | gemini update |
gemini extensions install | Install an extension from a GitHub URL or local path. <source> [--ref <ref>] [--auto-update] [--pre-release] [--consent] [--skip-settings] Docs: gemini extensions install | gemini extensions install https://github.com/user/my-extension |
gemini extensions uninstall | Uninstall one or more extensions. <name...> Docs: gemini extensions uninstall | gemini extensions uninstall my-extension |
gemini extensions list | List all installed extensions. Docs: gemini extensions list | gemini extensions list |
gemini extensions update | Update an extension, or all extensions with --all. <name> | --all Docs: gemini extensions update | gemini extensions update --all |
gemini extensions enable | Re-enable a disabled extension. <name> [--scope user|workspace] Docs: gemini extensions enable | gemini extensions enable my-extension |
gemini extensions disable | Disable an extension entirely or for a specific workspace. <name> [--scope user|workspace] Docs: gemini extensions disable | gemini extensions disable my-extension |
gemini extensions link | Symlink a local development directory into the extensions directory. <path> Docs: gemini extensions link | gemini extensions link /path/to/extension |
gemini extensions new | Create a new extension from a built-in template (for example mcp-server, context, custom-commands). <path> [template] Docs: gemini extensions new | gemini extensions new ./my-extension |
gemini extensions validate | Validate extension structure. <path> Docs: gemini extensions validate | gemini extensions validate ./my-extension |
gemini extensions config | Update an extension's settings. <name> [setting] [--scope <scope>] Docs: gemini extensions config | -no example |
gemini mcp add | Add an MCP server to user or project settings.json. Options: -s/--scope, -t/--transport, -e/--env, -H/--header, --timeout, --trust, --description, --include-tools, --exclude-tools. [options] <name> <commandOrUrl> [args...] Docs: gemini mcp add | gemini mcp add github npx -y @modelcontextprotocol/server-github |
gemini mcp list | List configured MCP servers with configuration and connection status. Has no flags. Docs: gemini mcp list | gemini mcp list |
gemini mcp remove | Delete a server from the mcpServers object in settings.json. <name> [-s, --scope] Docs: gemini mcp remove | gemini mcp remove my-server |
gemini mcp enable | Re-enable a disabled MCP server; --session applies only to this session. <name> [--session] Docs: gemini mcp enable | gemini mcp enable <name> [--session] |
gemini mcp disable | Temporarily disable an MCP server without removing its configuration. <name> [--session] Docs: gemini mcp disable | gemini mcp disable <name> [--session] |
gemini skills list | List all discovered agent skills. Docs: gemini skills list | gemini skills list |
gemini skills install | Install a skill from Git, a path, or a file. <source> [--scope] [--path] [--consent] Docs: gemini skills install | gemini skills install https://github.com/user/repo.git --consent |
gemini skills link | Link local agent skills via symlink. <path> Docs: gemini skills link | gemini skills link /path/to/my-skills |
gemini skills uninstall | Uninstall an agent skill. <name> [--scope user|workspace] Docs: gemini skills uninstall | gemini skills uninstall my-skill --scope workspace |
gemini skills enable | Enable an agent skill, or all skills with --all. <name> | --all Docs: gemini skills enable | gemini skills enable --all |
gemini skills disable | Disable an agent skill, or all skills with --all. <name> | --all Docs: gemini skills disable | gemini skills disable my-skill |
gemini trust | Trust the current folder, so stdio MCP servers are tested and shown as Connected. Docs: gemini trust | -no example |
gemini gemma setup | Full local Gemma routing install (binary, model, settings, server start). Flags: --port, --no-start, --force, --skip-model. [--port] [--no-start] [--force] [--skip-model] Docs: gemini gemma setup | gemini gemma setup --port 8080 # custom port |
gemini gemma status | Health check showing what is installed and running. Docs: gemini gemma status | -no example |
gemini gemma start | Start the LiteRT server (auto-starts on CLI launch by default). Docs: gemini gemma start | -no example |
gemini gemma stop | Stop the LiteRT server. Docs: gemini gemma stop | -no example |
gemini gemma logs | Tail the server logs to see routing requests live. Docs: gemini gemma logs | -no example |
The rest of the Gemini CLI reference
FAQ
How many subcommands does Gemini CLI have?
The official Gemini CLI docs list 28 subcommands, including gemini update, gemini extensions install and gemini extensions uninstall. All of them are in the table above, in the docs' order.
What does gemini update do in Gemini CLI?
Update to the latest version.
Where are Gemini CLI subcommands documented?
On 5 official docs pages at github.com, last read on October 17, 2026. Every row in the table links the exact section it came from.
More on Gemini CLI
Sources
Last verified . Names and examples are copied verbatim from the 5 official pages below, and every row above links the exact section it came from.
- github.com/google-gemini/gemini-cli/blob/main/docs/cli/cli-reference.md7 items
- github.com/google-gemini/gemini-cli/blob/main/docs/extensions/reference.md8 items
- github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md6 items
- github.com/google-gemini/gemini-cli/blob/main/docs/cli/skills.md2 items
- github.com/google-gemini/gemini-cli/blob/main/docs/core/gemma-setup.md5 items
Newsletter
Know when your tools change
One email per week. New coding agent releases, the flags and commands they add, and what they mean for how you work.