功能

Sessions

Grok 会自动将每次对话(prompts、responses、tool calls 和 file snapshots)保存到磁盘的 ~/.grok/sessions/ 下,并按工作目录建立索引。Sessions 在 TUI、headless 模式和 ACP 中的行为相同。

恢复

在 TUI 中,/resume 会打开当前 workspace 最近 sessions 的选择器;欢迎界面也会列出这些 sessions。通过命令行:

Bash

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

在 headless 模式中,从 JSON output 读取 session ID,并将其传给 -r 以构建多步骤自动化:

Bash

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

-s, --session-id 使用你提供的 UUID 命名新 session;它不会恢复已有 session。如需从已恢复 session 创建分支而不是继续,请添加 --fork-session

Fork

/fork [directive] 将当前 session 分支成一个同级 session,新 session 从对话副本开始。传递 --worktree--no-worktree,选择 fork 是否在 repository 的隔离副本中运行,以防并行 sessions 覆盖彼此文件;请参阅 Worktrees

回退

/rewind(或空闲时按 Esc Esc)为每个 prompt 列出一个 rewind point。选择后会将所有文件恢复到该时间点的状态,并截断对话以匹配。Rewind 会修改磁盘文件,除非已提交到 git,否则被回退的更改会丢失。

压缩

/compact [context] 压缩对话历史以释放 context window,可附加关于要保留内容的 instructions。Context window 即将用尽时 Grok 也会自动压缩;使用 /context/session-info 查看用量。

Todos

对于多步骤工作,Agent 会维护结构化 todo list,让你看到哪些内容已规划、正在进行和已经完成。条目使用 pending、in progress、completed 和 cancelled 状态(步骤被放弃时)。

在 Agent 界面按 Ctrl+T 查看 todo pane。该列表属于 session:恢复同一个 session 后,todos 会恢复到上次状态。

Todos 与后台任务不同,后者跟踪长时间运行的命令和 monitors。

清理

命令作用
/sessions切换、重命名或关闭活动 sessions
/rename <title>重命名当前 session(别名 /title
grok sessions list列出当前目录最近的 sessions
grok sessions search <query>搜索 session 标题和 prompts
grok sessions delete <id>永久删除 session
grok export <id> [file]将 transcript 导出为 Markdown(使用 --clipboard 复制)