功能

会话

Grok 会自动将每次对话保存到磁盘上 — 包括提示、响应、工具调用和文件快照 — 保存在 ~/.grok/sessions/ 目录下，按工作目录进行键值区分。在 TUI、无头模式和 ACP 中，会话功能的工作方式相同。

恢复

在 TUI 中，/resume 会打开一个选择器，列出当前工作区的最近会话；欢迎屏幕也会列出这些会话。在命令行中：

grok --resume <session-id>   # a specific session
grok --resume                # the most recent for this directory
grok -c                      # shorthand: continue the most recent

在无头模式下，从 JSON 输出中读取会话 ID 并将其传递给 -r，以构建多步骤自动化：

grok -p "Start the refactor" --output-format json | jq -r '.sessionId'

-s, --session-id 使用您提供的 UUID 命名一个新会话；它不会恢复现有的会话。如果要分支恢复的会话而不是继续它，请添加 --fork-session。

分支

/fork [directive] 将当前会话分支到一个对等会话，该会话从对话的副本开始。传递 --worktree 或 --no-worktree 来选择分支是否在仓库的隔离副本中运行，这样并行会话就不会相互覆盖文件 — 参见 Worktrees。

回退

/rewind（或在空闲时按 Esc Esc）会列出每个提示的回退点。选择一个回退点将所有文件恢复到该点的状态，并截断对话以匹配。回退会修改磁盘上的文件 — 未提交到 git 的更改将丢失。

压缩

/compact [context] 压缩对话历史以回收上下文窗口，并可选择保留哪些内容的说明。当上下文窗口填满时，Grok 也会自动压缩；使用 /context 或 /session-info 检查使用情况。

待办事项

对于多步骤工作，代理会维护一个结构化的待办事项列表，让您可以查看计划中的内容、正在进行的内容和已完成的内容。项目使用待处理、进行中、已完成和已取消（当步骤被丢弃时）等状态。

在代理屏幕上，按 Ctrl+T 查看待办事项面板。该列表是会话的一部分：恢复同一个会话，待办事项会带着它们最后的状态一起返回。

待办事项与 后台任务 是分开的，后台任务跟踪长时间运行的命令和监控。

维护

命令	功能
/sessions	切换、重命名或关闭活动会话
/rename <title>	重命名当前会话（别名 /title）
grok sessions list	列出此目录的最近会话
grok sessions search <query>	搜索会话标题和提示
grok sessions delete <id>	永久删除会话
grok export <id> [file]	将记录导出为 Markdown（使用 --clipboard 复制）