青蛙小白
博客 / 2025/06

Gemini CLI支持的命令

2025/06/27 · — 字 · 阅读约 — 分钟 ·
目录

Gemini CLI Commands


💬 斜杠命令(/)

斜杠命令用于控制 Gemini CLI 本身的行为。

/bug

说明:提交有关 Gemini CLI 的问题报告。默认提交到 GitHub 仓库。你在 /bug 后输入的内容会成为问题标题。行为可通过 .gemini/settings.json 中的 bugCommand 设置进行修改。

/chat

说明:保存和恢复对话历史,用于状态分支或会话恢复。 子命令:

  • save:保存当前对话历史。需添加 <tag> 标签。 用法:/chat save <tag>

  • resume:恢复指定标签的历史会话。 用法:/chat resume <tag>

  • list:列出所有可用标签。

/clear

说明:清除终端屏幕和当前可见会话历史。底层历史数据可能仍被保留。 快捷键:按下 Ctrl+L 执行清屏。

/compress

说明:将整个聊天上下文替换为摘要,节省 token,同时保留内容概要。

/editor

说明:打开编辑器选择对话框。

/extensions

说明:列出当前会话中所有激活的扩展。详见“Gemini CLI 扩展”文档。

/help/?

说明:显示 Gemini CLI 的帮助信息,包括所有命令及其用法。

/mcp

说明:列出已配置的 Model Context Protocol (MCP) 服务器及工具。

子命令:

  • desc / descriptions:显示工具详细描述。
  • nodesc / nodescriptions:隐藏工具描述,仅显示名称。
  • schema:显示每个工具的参数 JSON schema。

快捷键:Ctrl+T 可切换显示/隐藏工具描述。

/memory

说明:管理 AI 的记忆上下文(由 GEMINI.md 文件加载的分层记忆)。

子命令:

  • add <内容>:添加记忆内容。
  • show:显示当前加载的完整分层记忆内容。
  • refresh:重新从 GEMINI.md 文件中加载所有记忆内容。

/restore

说明:将项目文件恢复到某个工具执行前的状态。用于撤销工具执行所做的更改。 用法:/restore [tool_call_id] 仅在启用 --checkpointing 参数或配置时可用。

/stats

说明:显示当前会话的详细统计信息,包括 token 使用量、节省的 token(如有)和会话时长。 注意:仅 API Key 身份验证时支持缓存 token 统计,OAuth 不支持。

/theme

说明:打开界面主题选择对话框。

/auth

说明:打开身份验证方法选择对话框。

/about

说明:显示版本信息。提交问题时建议提供。

/tools

说明:显示当前可用工具列表。

子命令:

  • desc / descriptions:显示每个工具的详细信息。
  • nodesc / nodescriptions:仅显示工具名称。

/privacy

说明:显示隐私声明,并允许选择是否同意收集数据用于改进服务。

/quit/exit

说明:退出 Gemini CLI。


📄 @命令(@)

@命令用于将文件或目录的内容注入到你的提示中。它支持 Git 忽略文件过滤。

@<文件或目录路径>

说明:读取并注入指定文件或目录的文本内容,用于向 Gemini 询问或分析文件内容。

示例:

  • @path/to/file.txt Explain this text.
  • @src/my_project/ Summarize the code in this directory.
  • What is this file about? @README.md

细节说明:

  • 可读取单个文件或目录(递归子目录)。
  • 路径中有空格请用 \ 转义(如 @My\ Documents/file.txt)。
  • 使用 read_many_files 工具实现内容读取。
  • 默认忽略 Git 忽略的文件(如 node_modules/.env 等),可通过 fileFiltering 设置修改。
  • 适用于文本文件。二进制或超大文件可能被跳过或截断。
  • 终端会显示哪些文件被处理、跳过或读取失败。

错误处理

  • 若路径不存在或无权限,会显示错误,可能不会注入内容或直接发送原始查询。

🖥️ Shell模式与!命令

!命令允许直接从Gemini CLI运行系统shell命令。

!<shell 命令>

说明:执行系统 shell 命令,并在终端显示输出或错误。

示例:

  • !ls -la:列出当前目录。
  • !git status:查看 Git 状态。

!(单独使用)

说明:切换进入/退出 Shell 模式。

进入后:

  • 使用不同颜色显示提示。
  • 所有输入都被解释为shell 命令。

退出后:

  • 恢复正常Gemini CLI输入状态。

注意:Shell模式下执行的命令拥有与在终端中执行相同的权限,请谨慎操作。

评论