装好 Grok Build、在仓库里敲下 grok 之后,全屏 TUI 就是日常工作面。鼠标能点,但切换模式、找命令、回看对话,靠键盘更快。这套交互其实就三条路:快捷键、命令面板、斜杠命令。Shift+Tab 循环里的 Plan 最容易和权限档搅在一起,单独拆开讲。
三种入口:键盘、命令面板、斜杠命令
忘了某个动作时,先打开两张表。Ctrl+P 或 ? 打开命令面板,里面按会话、上下文、模型和工具把动作归了组。Ctrl+. 打开快捷键表;Windows,以及不支持 Kitty keyboard protocol 的终端,改按 Ctrl+X。当前用不上的项会变暗,不用在表里逐条猜。
想直接下手,在输入框打 /。TUI 自己带一套 pager 本地斜杠命令,xai-grok-shell 再补一小部分;可调用的 skill 也会出现在斜杠菜单里,写成 /<skill-name>。名字撞了用限定写法,例如 /local:commit。只想浏览有哪些命令和快捷键,用 /help。
按面板的分组,日常会反复碰到的是这些:
| 分组 | 典型命令 |
|---|---|
| 会话 | /new、/resume、/sessions、/fork、/rewind、/home |
| 上下文 | /context、/compact、/find、/copy、/export |
| 模型 | /model、/effort |
| 工具 / 模式 | /plan、/view-plan、/auto、/always-approve |
有些命令只在对应功能开启时才出现,例如 /imagine、/loop。扩展相关的 /hooks、/plugins、/marketplace、/skills、/mcps 打开的是同一张扩展面板,只是预选的标签不同。
用 Shift+Tab 理解会话模式
输入框里按 Shift+Tab,会话模式按这条循环:Normal → Plan → Auto(功能开启时才进这一档)→ Always-approve,再回到 Normal。从 Normal 按一下就落到 Plan。
Plan 的意思是先规划再改代码。批准之前,agent 只能改会话计划文件,其他编辑工具一律拒绝。这道门和权限档无关:就算已经开了 ask、auto 或 always-approve,批准前也只能改计划文件。读、跑 bash、调 MCP 仍走原来的权限档;Plan 卡的是编辑工具,不是 shell,所以 bash 仍可能通过重定向写文件。
Auto 用分类器自动放行安全工具,危险的仍可能弹确认。开关是 /auto,或在功能开启时继续按 Shift+Tab。Always-approve 跳过工具权限提示,deny 规则和 hooks 仍然生效。开关是 /always-approve、Shift+Tab,启动时也可以直接带上:
grok --always-approve
Ctrl+O 也能切换 Always-approve。权限档怎么配、和沙箱怎么叠,是另一件事;在 TUI 里先分清:Shift+Tab 走的是会话模式循环,Plan 管的是「批计划之前能不能改文件」。
会话与上下文相关命令
新开一轮用 /new,别名 /clear。快捷键是 Ctrl+N,要按两次。回到以前的会话用 /resume;Ctrl+S 打开会话列表。当前这几个活动会话要切换、改名或关掉,用 /sessions。想从现在这条对话分出一条对等 agent,用 /fork。回到欢迎屏是 /home,退出应用是 /quit(别名 /exit),键盘上是 Ctrl+Q 或 Ctrl+D,同样要按两次。
说错了、想退回某一轮,用 /rewind。输入框里连按两下 Esc 也能做这件事:框里有字时清空输入,框是空的就打开 rewind。单按一下 Esc 是取消正在跑的那一轮;Ctrl+C 也是取消当前轮。
上下文不够用时,先看占用,再决定压不压:
/context
/compact
/compact keep the auth flow
/context 看当前窗口怎么被吃掉。/compact 压缩对话历史,后面可以跟一段说明,告诉它压缩时要留下什么。
Plan Mode 的进入与审批
架构含糊、需求说不清、改动面大的重构,适合开 Plan。路径已经明确的小改、一眼能改的 bug、改名、格式化,以及纯调研,不必绕这一档。
自己进 Plan 有两种写法。只敲 /plan,模式会在你下一条提示词发出时生效;带上描述则进入并立刻开一轮:
/plan
/plan Redesign the data pipeline
Shift+Tab 从 Normal 按一下同样进 Plan。任务看起来含糊时,agent 也可能自己切进来,这不是一张权限确认。空闲时再按 Shift+Tab 可以离开;审批屏上按 q 也会退出并关掉 Plan。
规划结束,TUI 弹出计划预览。Auto 和 Always-approve 都不会跳过这张审批。空计划同样打开这张面。Plan 会一直保持到你批准或退出。之后要再看已保存的预览:
/view-plan
别名是 /show-plan、/plan-view。审批屏上这几个键够用:
| 按键 | 作用 |
|---|---|
a |
批准并开工;有未提交批注时,带批注一起批准 |
s |
要求修改:写备注,再按 Enter |
c |
对选中的行或范围加批注 |
q |
退出计划,并关掉 Plan |
Tab |
在计划预览和输入框之间切换焦点 |
规划中状态显示 plan,审批屏显示 plan approval。Plan 结束后,原来的 auto 或 Always-approve 标记会回来。子代理不受父会话这道编辑门约束,但会继承父会话的权限档,包括 auto 和 Always-approve。
输入与回滚区操作
发送、换行、插话和 shell 模式
默认 Enter 发送当前输入。需要换行时按 Shift+Enter;终端吃不掉 Shift+Enter 就用 Alt+Enter。Ctrl+M 打开多行模式之后,Enter 变成换行,Shift+Enter(或不支持时的 Alt+Enter)才发送。斜杠命令是 /multiline,别名 /ml。
agent 还在跑,想插一句话,用 Ctrl+Enter 或 Ctrl+I。Ctrl+R 搜提示词历史。输入框是空的时候敲 !,进入 shell 模式。
在 VS Code、Cursor、Windsurf、Zed 这类 VS Code 系终端里,插话改成 Ctrl+L,退出只认 Ctrl+D,换行用 Alt+Enter。这里的 Ctrl+L 不会打开扩展,扩展走 /plugins。Apple Terminal 上 Ctrl+O 也可以插话。WezTerm 要用 Ctrl+Enter 和 Shift+Enter,得在 WezTerm 自己的配置里打开:
enable_kitty_keyboard = true
在回滚区里看、折、复制
Tab 在输入框和回滚区之间切换焦点。焦点在回滚区时,方向键就能上下选条目、左右折叠或展开。单字母键(j / k、h / l、y、/ 这类)要先打开 vim mode,否则会落到输入框里当普通字符。开关是 /vim-mode,或写进配置:
[ui]
vim_mode = true
打开之后,回滚区里这些键才按字面工作:
| 按键 | 作用 |
|---|---|
j / ↓,k / ↑ |
下一条 / 上一条 |
h / ←,l / → |
折叠 / 展开当前条目 |
e,Shift+E |
切换一条 / 切换全部 |
y,Shift+Y |
复制内容 / 复制命令或路径 |
/ |
搜索回滚区(仅 vim mode) |
Enter 或 Ctrl+F |
用全屏查看器打开当前块 |
方向键等价操作在未开 vim mode 时同样可用。VS Code 系终端里,半页下滚是 Shift+D,不是默认的 Ctrl+D——那个键已经留给退出了。