OS Manuals

/usr/bin/gemini

AI agent that brings Google Gemini directly into your terminal

From gemini-cli 0.67.0-r0 (enterprise-packages), captured 2026-11-08 by running gemini --help (exit 0). permalink

Usage: gemini [options] [command]

Gemini CLI - Defaults to interactive mode. Use -p/--prompt for non-interactive (headless) mode.

Commands:
  gemini mcp                   Manage MCP servers
  gemini extensions <command>  Manage Gemini CLI extensions.  [aliases: extension]
  gemini skills <command>      Manage agent skills.  [aliases: skill]
  gemini hooks <command>       Manage Gemini CLI hooks.  [aliases: hook]
  gemini gemma                 Manage local Gemma model routing
  gemini models [command]      Manage or list Gemini models.
  gemini [query..]             Launch Gemini CLI  [default]

Positionals:
  query  Initial prompt. Runs in interactive mode by default; use -p/--prompt for non-interactive.

Options:
  -d, --debug                     Run in debug mode (open debug console with F12)  [boolean] [default: false]
  -m, --model                     Model  [string]
  -p, --prompt                    Run in non-interactive (headless) mode with the given prompt. Appended to input on stdin (if any).  [string]
  -i, --prompt-interactive        Execute the provided prompt and continue in interactive mode  [string]
      --skip-trust                Trust the current workspace for this session.  [boolean] [default: false]
  -w, --worktree                  Start Gemini in a new git worktree. If no name is provided, one is generated automatically.  [string]
  -s, --sandbox                   Run in sandbox?  [boolean]
  -y, --yolo                      Automatically accept all actions (aka YOLO mode, see https://www.youtube.com/watch?v=xvFZjo5PgG0 for more details)?  [boolean] [default: false]
      --approval-mode             Set the approval mode: default (prompt for approval), auto_edit (auto-approve edit tools), yolo (auto-approve all tools), plan (read-only mode)  [string] [choices: "default", "auto_edit", "yolo", "plan"]
      --policy                    Additional policy files or directories to load (comma-separated or multiple --policy)  [array]
      --admin-policy              Additional admin policy files or directories to load (comma-separated or multiple --admin-policy)  [array]
      --acp                       Starts the agent in ACP mode  [boolean]
      --experimental-acp          Starts the agent in ACP mode (deprecated, use --acp instead)  [boolean]
      --allowed-mcp-server-names  Allowed MCP server names  [array]
      --allowed-tools             [DEPRECATED: Use Policy Engine instead See https://geminicli.com/docs/core/policy-engine] Tools that are allowed to run without confirmation  [array]
  -e, --extensions                A list of extensions to use. If not provided, all extensions are used.  [array]
  -l, --list-extensions           List all available extensions and exit.  [boolean]
      --list-models               List available Gemini models and exit.  [boolean]
  -r, --resume                    Resume a previous session. Use "latest" for most recent or index number (e.g. --resume 5)  [string]
      --session-file              Load a session from a JSON file  [string]
      --session-id                Start a new session with a manually provided UUID.  [string]
      --list-sessions             List available sessions for the current project and exit.  [boolean]
      --delete-session            Delete a session by index number (use --list-sessions to see available sessions).  [string]
      --include-directories       Additional directories to include in the workspace (comma-separated or multiple --include-directories)  [array]
      --screen-reader             Enable screen reader mode for accessibility.  [boolean]
  -o, --output-format             The format of the CLI output.  [string] [choices: "text", "json", "stream-json"]
      --raw-output                Disable sanitization of model output (e.g. allow ANSI escape sequences). WARNING: This can be a security risk if the model output is untrusted.  [boolean]
      --accept-raw-output-risk    Suppress the security warning when using --raw-output.  [boolean]
  -v, --version                   Show version number  [boolean]
  -h, --help                      Show help  [boolean]
Options (30)
OptionDescriptionSource
-d, --debugRun in debug mode (open debug console with F12) [boolean] [default: false]help
-m, --modelModel [string]help
-p, --promptRun in non-interactive (headless) mode with the given prompt.help
-i, --prompt-interactiveExecute the provided prompt and continue in interactive mode [string]help
--skip-trustTrust the current workspace for this session.help
-w, --worktreeStart Gemini in a new git worktree.help
-s, --sandboxRun in sandbox? [boolean]help
-y, --yoloAutomatically accept all actions (aka YOLO mode, see https://www.youtube.com/watch?v=xvFZjo5PgG0 for more details)? [boolean] [default: false]help
--approval-modeSet the approval mode: default (prompt for approval), auto_edit (auto-approve edit tools), yolo (auto-approve all tools), plan (read-only mode) [string] [choices: "default", "auto_edit", "yolo",…help
--policyAdditional policy files or directories to load (comma-separated or multiple --policy) [array]help
--admin-policyAdditional admin policy files or directories to load (comma-separated or multiple --admin-policy) [array]help
--acpStarts the agent in ACP mode [boolean]help
--experimental-acpStarts the agent in ACP mode (deprecated, use --acp instead) [boolean]help
--allowed-mcp-server-namesAllowed MCP server names [array]help
--allowed-tools[DEPRECATED: Use Policy Engine instead See https://geminicli.com/docs/core/policy-engine] Tools that are allowed to run without confirmation [array]help
-e, --extensionsA list of extensions to use.help
-l, --list-extensionsList all available extensions and exit.help
--list-modelsList available Gemini models and exit.help
-r, --resumeResume a previous session.help
--session-fileLoad a session from a JSON file [string]help
--session-idStart a new session with a manually provided UUID.help
--list-sessionsList available sessions for the current project and exit.help
--delete-sessionDelete a session by index number (use --list-sessions to see available sessions).help
--include-directoriesAdditional directories to include in the workspace (comma-separated or multiple --include-directories) [array]help
--screen-readerEnable screen reader mode for accessibility.help
-o, --output-formatThe format of the CLI output.help
--raw-outputDisable sanitization of model output (e.g. allow ANSI escape sequences).help
--accept-raw-output-riskSuppress the security warning when using --raw-output.help
-v, --versionShow version number [boolean]help
-h, --helpShow help [boolean]help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.