Gemini CLI 命令行工具 速查备忘单

使用 Vertex AI 还需配置 GOOGLE_CLOUD_PROJECT 和 GOOGLE_CLOUD_LOCATION。

系统环境要求： Node.js 20+、macOS 15+、Windows 11 24H2+ 或 Ubuntu 20.04+

通过命令行参数 -m flash 或 GEMINI_MODEL 环境变量指定模型。

# MCP 服务器管理
$ gemini mcp add <name> <cmd-or-url>
$ gemini mcp remove <name>
$ gemini mcp list
$ gemini mcp enable <name>
$ gemini mcp disable <name>

# Extensions 扩展包管理
$ gemini extensions install <source>
$ gemini extensions uninstall <name>
$ gemini extensions list
$ gemini extensions update [name] [--all]
$ gemini extensions enable/disable <name>
$ gemini extensions link <path>
$ gemini extensions new <path>

# Skills 技能包管理
$ gemini skills list [--all]
$ gemini skills install <source>
$ gemini skills link <path>
$ gemini skills uninstall <name>
$ gemini skills enable/disable <name>

# 钩子 Hook 管理
$ gemini hooks migrate

退出状态码 (Exit codes): 0 成功 · 1 错误 · 42 非法输入 · 53 超过对话轮数限制

在 Prompt 提示词中直接引用文件或目录内容：

# 引用单个文件
@src/main.ts fix the bug on line 42

# 引用整个目录结构
@src/ what does this module do?

# 组合引用多个文件/路径
@package.json @src/ audit dependencies

支持 Git 感知：自动遵循 .gitignore 过滤目录文件。

# 直接执行单条 Shell 命令
!ls -la

# 切换进入/退出持续 Shell 模式
!

# 将 Shell 命令输出自动注入上下文对话
!git diff HEAD~1

所有 Shell 子进程环境变量中均自动注入 GEMINI_CLI=1。

输入 /rewind 或连按两次 Esc 键打开撤回对话框：

仅对 AI 自动作出的文件修改生效，不影响手动编辑与 ! shell 命令操作。

保存并恢复命名检查点，以便探索多种实现方案：

# 1. 保存当前状态检查点
/resume save my-decision-point

# 2. 尝试方案 A...

# 3. 回滚恢复至保存的检查点
/resume resume my-decision-point

# 4. 尝试方案 B...

# 显示当前所有已加载的上下文
/memory show

# 强制执行重新加载所有上下文文件
/memory reload

# 将规范规则追加至全局 GEMINI.md
/memory add "Always use TypeScript strict mode"

# 为当前项目生成初始 GEMINI.md
/init

在项目根目录创建 .geminiignore 文件（语法与 .gitignore 一致）：

# 忽略整个目录
/packages/

# 忽略特定敏感文件
apikeys.txt
*.log

# 忽略所有 markdown，但保留 README
*.md
!README.md

被忽略的文件对 CLI 工具不可见，但不影响 Git 与其他系统工具。

# 添加 stdio 类型的 MCP 服务器
$ gemini mcp add myserver npx -y my-mcp-package

# 添加 HTTP/SSE 类型的 MCP 服务器
$ gemini mcp add myserver https://api.example.com/mcp

# 带额外参数选项添加
$ gemini mcp add myserver cmd --transport http --trust --timeout 30000

# 列出所有注册的 MCP 服务器
$ gemini mcp list

# 移除指定 MCP 服务器
$ gemini mcp remove myserver

# 开启/禁用指定 MCP 服务器
$ gemini mcp enable myserver
$ gemini mcp disable myserver --session

在 Prompt 中直接引用 MCP 资源与预设指令：

# 引用 MCP 资源对象
@server://resource/path summarize this

# 执行 MCP 提供的斜杠指令
/prompt-name --arg=value

Skills 提供按需加载的领域专业知识——仅在调用 activate_skill 时才会装载进上下文。

技能包查找路径（优先级从高到低）：

# 列出所有可用的技能包
$ gemini skills list --all

# 从 Git 或本地路径安装技能包
$ gemini skills install https://github.com/org/skill
$ gemini skills install ./local-skill

# 开发者链接模式
$ gemini skills link ./my-skill

# 开启 / 禁用技能包
$ gemini skills enable my-skill
$ gemini skills disable my-skill

将可复用的 Prompt 提示词保存为自定义斜杠指令。

配置文件路径：

• 用户级：~/.gemini/commands/
• 项目级：.gemini/commands/

# .gemini/commands/git/commit.toml
description = "Generate commit message"
prompt = """
Generate a conventional commit message for:

!{git diff --staged}

{{args}}
"""

上述配置文件将生成 /git:commit 指令（子目录 / 自动转为 : 命名空间）。

占位符说明：

只读工具（无风险，全量开放）：

• read_file, list_directory, glob
• grep_search, google_web_search
• web_fetch (需要二次确认)
• codebase_investigator, cli_help
• ask_user

写入限制工具（严格受限）：

• write_file, replace — 仅允许修改 plans 目录下的 .md 文档

上下文与记忆工具：

• save_memory, activate_skill

1. 设定分析目标
   └─ 使用自然语言或 /plan <goal>

2. 讨论方案策略
   └─ Gemini 提出澄清问题与技术选型

3. 审查生成的 Plan 文档
   └─ 方案文档自动保存至 plans 目录
   └─ 按 Ctrl+X 在外部编辑器中修改

4. 审查通过或继续迭代方案

5. 切换模式至 YOLO / auto_edit 开始编码实现

模型自动路由：分析规划阶段使用 Pro 大模型 → 编码实现阶段切换为 Flash 模型。

可在 ~/.bashrc, ~/.zshrc 或 .gemini/.env 中持久化配置。

所有 Hook 脚本均通过 stdin 接收 JSON 数据输入：

{
  "session_id": "...",
  "transcript_path": "/path/to/transcript",
  "cwd": "/project/dir",
  "hook_event_name": "BeforeTool",
  "timestamp": "2026-01-01T00:00:00Z"
}

在 stdout 输出 JSON 结果响应：

BeforeTool 专属：可通过 hookSpecificOutput.tool_input 覆盖工具传入参数。

AfterTool 专属：可通过 hookSpecificOutput.additionalContext 向工具输出追加上下文。

BeforeAgent 专属：可通过 hookSpecificOutput.additionalContext 向用户提示词追加上下文。

脚本可用环境变量： GEMINI_PROJECT_DIR, GEMINI_SESSION_ID, GEMINI_CWD