← ClaudeAtlas

handoverlisted

Use when a session is losing history to compaction, when taking over a project from an earlier session, or when the user asks to clean/import jsonl transcripts, build a context or handover pack, or wants a greppable record of past sessions instead of /compact. Also use to answer "when did this file change", "what did we already try", or "what did the user already reject" by grepping prior sessions. Builds and refreshes .handover/ from the project's Claude Code transcripts.
ahmad-saab/claude-code-handover · ★ 0 · AI & Automation · score 70
Install: claude install-skill ahmad-saab/claude-code-handover
# handover Compaction throws history away. The raw `.jsonl` transcripts keep all of it, but they are unreadable and enormous. This builds a small greppable pack from them so you can `/clear` instead of `/compact` and pull back only what you need. ## Build or refresh the pack ``` python ~/.claude/skills/handover/scripts/build_context.py ``` Run it from the project root. It finds that project's transcripts under `~/.claude/projects/<slugified-cwd>/` on its own and writes `.handover/` into the project. If `python` is not on PATH, use `py -3`. Flags, all optional: - `--project <dir>` project root, defaults to the current directory - `--in <dir>` transcript directory, when auto-discovery cannot find it - `--out <dir>` pack location, defaults to `<project>/.handover` - `--rebuild` discard the pack and import everything from scratch Reruns are cheap and safe. A manifest at `.handover/.state.json` records a byte offset per transcript, so a rerun reads only new bytes. The turn in flight when you run it is held back and rendered whole on the next run. ## What the pack contains - `TIMELINE.md` — every turn from every session, merged into one chronological stream. The entry point. Read this first on a cold start. - `INDEX.tsv` — one row per prompt, reply, file write, command, error and decision. Every row ends in a `sessions/<file>.md:<line>` jump target. - `FILES.tsv` — each project file, how often it was written, when, and by which sessions. - `sessions/<date>-<time>-<id