Skip to content

Add CLI Reference Documentation (like Claude Code) for All Commands and Parameters #13042

@leochiu-a

Description

@leochiu-a

What would you like to be added?

I would like gemini-cli to provide a CLI reference similar to Claude Code, with a clear listing of all commands, options, and parameters, each with appropriate descriptions.

For example, for the --model parameter, clearly list all available values (such as gemini-2.5-pro, gemini-2.5-flash, etc.), and add notes for any aliases so users can refer to a complete official reference instead of having to experiment.

Please document all supported gemini-cli parameters, options, aliases, and command usages; markdown tables or documentation are preferred.

Why is this needed?

Currently, the Gemini CLI documentation does not fully list all available commands and parameters, nor does it mention any supported aliases. This is not user friendly. Claude Code provides a complete command and parameter value reference with explanations that greatly improves user onboarding. I hope Gemini CLI can also include such documentation to reduce the learning curve and make the tool more usable and clear.

Additional context

In the Claude Code documentation, the --model parameter is clearly explained, including all supported model aliases such as "sonnet", "opus", etc. However, gemini-cli only mentions --model without specifying the full list of supported values, which makes it difficult for users to quickly understand the options.

For example:
--model gemini-2.5-pro
--model gemini-2.5-flash

I suggest officially documenting all CLI options, parameters, and their supported values with detailed explanations.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area/coreIssues related to User Interface, OS Support, Core Functionalitypriority/p2Important but can be addressed in a future release.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions