Back to Details

ccbox

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

ccbox

ccbox

Inspect local agent session logs via

ccbox

CLI and produce quick, evidence-based insights.

通过

ccbox

CLI检查本地Agent会话日志，快速生成基于证据的洞察报告。

Quick start

快速开始

List discovered projects:

bash

ccbox projects

List sessions for the current folder (auto-detect project):

bash

ccbox sessions
ccbox sessions --limit 50 --offset 0 --size

Inspect the latest session for the current folder:

bash

ccbox history
ccbox history --full
ccbox history --limit 200 --offset 0 --full --size

Inspect a specific project or log file:

bash

ccbox sessions "/abs/path/to/project"
ccbox history "/abs/path/to/project" --full
ccbox history "/abs/path/to/session.jsonl" --full

列出已发现的项目：

bash

ccbox projects

列出当前文件夹的会话（自动检测项目）：

bash

ccbox sessions
ccbox sessions --limit 50 --offset 0 --size

检查当前文件夹的最新会话：

bash

ccbox history
ccbox history --full
ccbox history --limit 200 --offset 0 --full --size

检查特定项目或日志文件：

bash

ccbox sessions "/abs/path/to/project"
ccbox history "/abs/path/to/project" --full
ccbox history "/abs/path/to/session.jsonl" --full

Workflow (recommended)

推荐工作流程

Confirm
```
ccbox
```
is available (
```
ccbox --help
```
).
Gather facts first (do not guess):
- Use
```
ccbox sessions
```
  to select the latest session for the current folder, or
```
ccbox sessions "/abs/project/path"
```
  for an explicit project.
- Copy the
```
log_path
```
  from the first line.
- Run
```
ccbox history "/abs/log.jsonl" --full
```
  to capture evidence (tool calls, tool outputs, errors).
Produce an insights report:
- What the user wanted (first USER prompt).
- What the agent did (sequence of tool calls + key outputs).
- What changed (files/commands visible in tool outputs).
- What failed or is risky (warnings, truncated timelines, panics/errors in outputs).
- Next steps (concrete verification commands and follow-ups).

确认
```
ccbox
```
可用（执行
```
ccbox --help
```
）。
先收集事实（不要猜测）：
- 使用
```
ccbox sessions
```
  选择当前文件夹的最新会话，或使用
```
ccbox sessions "/abs/project/path"
```
  指定明确的项目。
- 复制第一行的
```
log_path
```
  。
- 运行
```
ccbox history "/abs/log.jsonl" --full
```
  来获取证据（工具调用、工具输出、错误信息）。
生成洞察报告：
- 用户需求（第一条USER提示）。
- Agent执行的操作（工具调用序列 + 关键输出）。
- 发生的变更（工具输出中可见的文件/命令）。
- 失败或有风险的内容（警告、截断的时间线、输出中的崩溃/错误）。
- 后续步骤（具体的验证命令和跟进事项）。

References

参考资料

CLI commands + output formats:
```
references/cli.md
```
Insights checklist + report template:
```
references/insights.md
```

CLI命令 + 输出格式：
```
references/cli.md
```
洞察检查清单 + 报告模板：
```
references/insights.md
```