session-dump

name

session-dump

description

Generate a continuation-ready markdown dump for an external coding-agent session, starting with Claude Code session IDs. Use when the user needs to continue prior work from a Claude session, inspect where session history is stored, dump tool calls/subagents/tasks/plans/teams metadata, or build a citation-heavy session handoff. The bundled Bun TypeScript CLI runs standalone and supports reference-first output with opt-in raw inclusion.

Session Dump

Use this skill when a user gives you a session id from another agent and wants a full, citation-heavy dump that another agent can use to continue work.

The bundled CLI is Bun-first TypeScript and currently supports:

• claude provider
• reference-first markdown dumps by default
• opt-in raw inclusion for referenced artifacts
• built-in heuristic redaction with no third-party runtime dependencies

Entry point

From the skill directory, run:

bun run session-dump --provider claude --session <session-id>

Or directly:

bun run ./src/index.ts --provider claude --session <session-id>

Defaults

• Main transcript is inlined
• Related artifacts are cited by absolute path
• Raw referenced file content is not embedded unless requested
• Redaction is enabled by default

Useful flags

• --output <file>: write the markdown dump to a file
• --include-raw: inline all discovered related artifacts
• --include-subagents: inline subagent transcripts
• --include-tool-results: inline spilled tool-result files
• --include-debug: inline debug log content