{"id":51011949,"url":"https://github.com/maksandre/debrief","last_synced_at":"2026-06-21T04:01:25.545Z","repository":{"id":364069178,"uuid":"1238802111","full_name":"Maksandre/debrief","owner":"Maksandre","description":"A local UI for inspecting Claude Code session logs. Useful when developing subagents and skills","archived":false,"fork":false,"pushed_at":"2026-06-11T17:42:08.000Z","size":964,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-11T19:19:43.776Z","etag":null,"topics":["agents","claude","claude-code","llm-tools","observability","trace-viewer"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Maksandre.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-14T13:19:11.000Z","updated_at":"2026-06-11T17:36:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Maksandre/debrief","commit_stats":null,"previous_names":["maksandre/claude-traceviewer","maksandre/debrief"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Maksandre/debrief","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maksandre%2Fdebrief","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maksandre%2Fdebrief/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maksandre%2Fdebrief/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maksandre%2Fdebrief/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Maksandre","download_url":"https://codeload.github.com/Maksandre/debrief/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maksandre%2Fdebrief/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34593129,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","claude","claude-code","llm-tools","observability","trace-viewer"],"created_at":"2026-06-21T04:01:22.551Z","updated_at":"2026-06-21T04:01:25.537Z","avatar_url":"https://github.com/Maksandre.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Debrief\n\nA local inspector for Claude Code sessions. Reads the `.jsonl` trace files Claude Code writes under `~/.claude/` and turns them into readable conversations plus analytics — cost, prompt-cache health, context-window headroom, where the time went, and where things went wrong.\n\nUseful when developing custom subagents and skills: the delegation tree, per-agent transcripts, prompts, tool calls, and per-agent spend are all visible side by side, and every insight links back to the exact message that produced it.\n\n![Conversation view](docs/img/conversation.png)\n\n## What it shows\n\n- The full transcript of a session: user messages, assistant turns, thinking blocks, tool calls, and tool results.\n- A sidebar listing every project and session found on disk.\n- Live sessions, refreshed every 5 seconds.\n- In-conversation search.\n- Light and dark themes.\n\n## Stats per session\n\n![Stats](docs/img/stats.png)\n\nCost, token volume, wall-clock duration, peak context vs the model's window, and a per-agent breakdown. Interactive panels surface the actionable detail:\n\n- **Prompt caching** — a context-over-time chart marking every cache rebuild, what each cost, and why (idle TTL expiry, model switch, prefix change), each clickable to the message.\n- **Cost \u0026 models** — spend per model.\n- **Where the time went** — a chronological strip of agent-working vs waiting-on-you vs idle/away time, with clickable spans.\n- **Friction** — tool errors and interruptions, grouped and linked.\n\n## Subagent delegation\n\n![Agents](docs/img/agents.png)\n\nIf the session used subagents, the delegation tree is shown with each agent's prompt, model, tool calls, duration, and cost. Click a row to open that agent's transcript.\n\n## Run\n\n```bash\nnpm install\nnpm run dev\n```\n\nThen open [http://localhost:5173](http://localhost:5173).\n\nSingle-port production build:\n\n```bash\nnpm run build\nnpm start                  # http://localhost:3099\n```\n\nDocker:\n\n```bash\ndocker compose up          # http://localhost:3099 — mounts ~/.claude read-only\n```\n\nSessions are read from `~/.claude` by default. Override with the `CLAUDE_DIR` environment variable.\n\n## Cost numbers\n\nCosts are **notional**: every session is priced as if the tokens were billed at the public Anthropic API rates, regardless of how you actually pay. If you're on a Claude Pro/Max subscription, no money was charged per token — the figure shown is what the same usage would have cost on the metered API, which is a useful proxy for comparing sessions, agents, and runs against each other.\n\nRates come from a bundled snapshot covering Opus, Sonnet, and Haiku 3 → 4.x. Bedrock and Vertex routing are not modeled.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaksandre%2Fdebrief","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaksandre%2Fdebrief","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaksandre%2Fdebrief/lists"}