CLI 参考 (CLI Reference)

快速查阅所有 TUI 斜杠命令、默认键盘快捷键和 JSON 配置参数。

核心斜杠命令 (Core slash commands)

在提示框内输入 / 即可打开自动补全命令选择菜单。

命令 (Command)	类别 (Category)	别名 (Alias)	执行用途 (Execution Purpose)
/add-dir <path>	实用工具	—	向活跃工作空间添加目录路径。
/agents	工具与任务	—	打开 Agent 管理器面板以监控后台子 Agent。
/btw <query>	实用工具	—	在后台提问一个旁侧问题，而不打断主对话。
/clear	实用工具	—	清空终端并重置活跃的对话上下文。
/config	配置	/settings	打开交互式设置编辑器浮层。
/diff	实用工具	—	显示所有被修改工作空间文件的统一 Diff。
/exit	核心	—	关闭 TUI 会话并恢复您的宿主 Shell。
/fast	配置	—	启用快速模式（跳过推理规划）以执行快速操作。
/fork	对话	/branch	将当前对话线程克隆到一个新的并行会话中。
/hooks	工具与任务	—	浏览活跃的预检/后置格式化脚本钩子。
/keybindings	配置	—	打开交互式快捷键编辑器。
/logout	账户	—	断开您的个人资料连接并从安全密钥环中清除认证 Token。
/mcp	工具与任务	—	打开模型上下文协议 (MCP) 服务端管理器。
/model	配置	—	选择您偏好的推理模型（跨会话持久化）。
/open <path>	实用工具	—	强制在您系统默认的编辑器中打开路径。
/permissions	配置	—	在全局权限预设（request-review、always-proceed、strict）之间进行切换。
/planning	配置	—	启用针对复杂工程任务的多轮计划生成模式。
/rename <name>	对话	—	重命名当前会话线程。
/resume	对话	/switch, /conversation	打开对话选择器浮层以选择并加载先前的线程。
/rewind	对话	/undo	将您的对话历史回滚到先前的消息。
/skills	工具与任务	—	浏览已加载的本地和全局 Agent 技能包。
/statusline	配置	—	打开状态栏自定义浮层。
/tasks	工具与任务	—	打开任务管理器面板以监控后台 Shell 执行日志。
/title [on/off]	配置	—	切换或设置终端窗口标题更新。
/usage	实用工具	—	在终端内启动离线开发者帮助手册。

默认按键绑定 (Default keybindings)

键盘快捷键命令涵盖了全局控制、提示框输入、导航以及审批操作。

全局控制

无论当前聚焦的是哪个面板、浮层或提示框，这些快捷键始终处于活动状态。

按键 (Key)	TUI 命令	动作行为 (Action Behavior)
Esc	cli.escape	关闭活动面板、中止活动流，或清空空白提示词。
Ctrl+C	cli.exit	终止 CLI 会话（如果 Agent 正在工作，则提示确认）。
Ctrl+L	cli.clear_screen	刷新并清除可视终端缓冲区。

提示框输入按键

在提示框内编写指令时，这些按键处于活动状态。

按键 (Key)	TUI 命令	动作行为 (Action Behavior)
Enter	prompt.submit	将您的提示词或活动菜单选择提交给 Agent。
Shift+Enter / Ctrl+J	prompt.newline	插入一个干净的换行符而不提交。
Ctrl+V	prompt.paste	将图形媒体文件或剪贴板内容粘贴到提示词中。
Ctrl+O	prompt.toggle_trajectory	展开或折叠详细的工具推理输出。
Ctrl+R	prompt.open_review	打开产物审查面板。
Ctrl+G	prompt.external_editor	启动您默认的 $EDITOR Shell 来撰写提示词。
Alt+J	prompt.teleport_agent	立即将焦点切换到下一个等待确认的子 Agent。
Ctrl+K	prompt.fast_approve	立即批准状态警报中列出的待处理子 Agent 操作。
Ctrl+A	prompt.cursor_start	将提示词插入光标移动到行首。
Ctrl+E	prompt.cursor_end	将提示词插入光标移动到行尾。
Ctrl+Z	prompt.undo_text	撤销上一次编辑。
Ctrl+Shift+Z	prompt.redo_text	重做上一次撤销的文本操作。

导航与滚动

用于选择面板、菜单和可滚动的文本框中。

按键 (Key)	TUI 命令	动作行为 (Action Behavior)
↑ / ↓	navigation.up / navigation.down	将高亮选择项向上或向下滚动一个条目。
PgUp / Shift+↑	navigation.page_up	将活动文本视口向上滚动一个页面块。
PgDn / Shift+↓	navigation.page_down	将活动文本视口向下滚动一个页面块。
← / →	navigation.left / navigation.right	在多页结构（如会话选择器）内切换页面。
Tab	navigation.tab	确认高亮的斜杠命令自动填充选项。

工具确认

在确认提示期间处于活动状态。

按键 (Key)	TUI 命令	动作行为 (Action Behavior)
y	confirm.yes	授权所提议的工具、命令或活动产物。
n	confirm.no	拒绝所提议的工具、命令或活动产物。
A	—	（在审查面板内）一键批准所有生成的产物（内置快捷键）。

配置项键名 (settings.json)

主要的设置键名、数据类型、系统默认值和预期参数。

配置键名 (Option Key Name)	值类型 (Value Type)	系统默认值 (System Default)	参数特性与选项 (Parameter Characteristics & Options)
colorScheme	string	"terminal"	配色方案："light"、"solarized light"、"colorblind-friendly light"、"dark"、"solarized dark"、"colorblind-friendly dark"、"tokyo night" 或 "terminal"（继承原生 Shell 颜色）。
altScreenMode	string	"default"	屏幕缓冲区使用："default"（原生终端行内模式）、"always"（使用备用屏幕无闪烁缓冲区）。
toolPermission	string	"request-review"	全局安全预设："request-review"（对写入/Bash/网页工具进行提示）、"proceed-in-sandbox"（在沙箱内自动执行）、"always-proceed"（从不提示）或 "strict"（对所有非读取工具进行提示）。
artifactReviewPolicy	string	"asks-for-review"	代码审查策略："asks-for-review"（在写入代码前始终提示）、"agent-decides"（动态提示）或 "always-proceed"（从不提示）。
notifications	boolean	false	在任务完成时发出系统桌面和终端铃声通知。
showTips	boolean	true	在生成轮次期间在提示面板上方显示有用的 Agent 提示。
showFeedbackSurvey	boolean	true	在活动任务完成时定期显示质量反馈调查。
editor	string	"auto"	目标文本编辑器工具："auto"（参考系统 $EDITOR）、"vim"、"emacs" 或自定义文本标识。
allowNonWorkspaceAccess	boolean	false	允许 Agent 的文件读取和写入工具导航到已识别的 Git/工作空间根目录之外。
enableTerminalSandbox	boolean	false	将 Agent 启动的所有本地执行命令限制在操作系统容器化隔离环内。
enableTelemetry	boolean	true	允许收集指标和崩溃日志流，以提高工具的可靠性。
verbosity	string	"high"	视觉详细程度："high"（呈现完整的思考和工具输出）或 "low"（仅显示最少的视觉进度指示器）。
runningLightSpeed	string	"medium"	视觉跑马灯进度动画速度："fast"、"medium"、"slow" 或 "off"。

下一步 (Next Steps)

了解如何安全地部署权限策略、沙箱以及自定义插件：

• 权限与沙箱 (Permissions & Sandbox)：强制执行命令行隔离规则。
• 插件与技能 (Plugins & Skills)：创建您自己的自定义斜杠命令。
• 安装与身份验证 (Installation & Auth)：更新您的 CLI 安装。