ccbox
Inspect and summarize local Codex/Claude session logs using the ccbox CLI (projects, sessions, history). Use when asked to list discovered projects, find sessions for the current repo/folder, print a session timeline, or produce an evidence-based “what happened” report from a session .jsonl log under CODEX_SESSIONS_DIR.
How do I install this agent skill?
npx skills add https://github.com/diskd-ai/ccbox --skill ccboxIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill allows an agent to inspect and analyze local Codex/Claude session logs using the ccbox CLI tool. It presents a low risk of indirect prompt injection because it parses historical session data that could contain adversarial content. It also executes local shell commands, including a self-update mechanism.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
5/5 files flagged
What does this agent skill do?
ccbox
Inspect local agent session logs via ccbox CLI and produce quick, evidence-based insights.
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)
- Confirm
ccboxis available and up to date:ccbox --helpccbox update(printsup-to-date:orupdated:; self-update is supported on macOS/Linux)
- Gather facts first (do not guess):
- Use
ccbox sessionsto select the latest session for the current folder, orccbox sessions "/abs/project/path"for an explicit project. - Copy the
log_pathfrom the first line. - Run
ccbox history "/abs/log.jsonl" --fullto capture evidence (tool calls, tool outputs, errors).
- Use
- 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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/diskd-ai/ccbox/ccbox">View ccbox on skillZs</a>