ccbox

ccbox

Quick start

• List discovered projects:

ccbox projects

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

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

• Inspect the latest session for the current folder:

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

• Inspect a specific project or log file:

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

Workflow (recommended)

1. Confirm

   ccbox

   is available (

   ccbox --help

   ).
2. 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).
3. 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).

References

• CLI commands + output formats:

  references/cli.md

• Insights checklist + report template:

  references/insights.md