session-debuggerlisted
Install: claude install-skill baremetallabs-ai/shipper
# Session Debugger
Skill for investigating Claude Code and Codex CLI session transcripts produced by shipper runs.
The primary session store is `~/.shipper/sessions/`, with native agent transcript directories used
only as fallback for older runs or when deeper Codex structure is required.
## Skill Location
This skill is installed at `.claude/skills/session-debugger/` relative to the repo root.
From the repo root, run scripts with the installed path:
```bash
.claude/skills/session-debugger/scripts/find-sessions.sh <issue-number>
```
If you've already changed into `.claude/skills/session-debugger/`, use the same relative form shown in Quick Reference:
```bash
./scripts/find-sessions.sh <issue-number>
```
From the repo root, read reference docs with the installed path:
```bash
cat .claude/skills/session-debugger/references/transcript-format.md
```
## Quick Reference
| Need | Script |
| ----------------------------------- | ---------------------------------------------------------- |
| **Find sessions for an issue** | `./scripts/find-sessions.sh <issue-number>` |
| **Classify a session by stage** | `./scripts/classify-session.sh <jsonl-path>` |
| **List all tool calls** | `./scripts/extract-tool-calls.sh <jsonl-path>` |
| **Find errors (including hidden)** | `./scripts/extract-errors.sh <jsonl-path>` |
| **Dri