JSPM

vaportrail

0.1.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 632
  • Score
    100M100P100Q88445F
  • License MIT

Your agents leave trails. vaportrail reads them — a local-first flight recorder for AI coding agent sessions.

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (vaportrail) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    vaportrail

    Your agents leave trails. vaportrail reads them.

    A local-first flight recorder for AI coding agent sessions. Every Claude Code session you run leaves a detailed transcript on disk — what you asked, what the agent did, every file it touched, every command it ran, every token it burned. vaportrail turns that pile of JSONL into something you can actually use.

    Zero runtime dependencies. Nothing leaves your machine. One command to try it:

    npx vaportrail
    ID        WHEN        PROJECT     TITLE                                            ❯    ⚒   OUT  MODEL
cca29f96  2h ago      wssh        Build SSH over WebSocket with agent enrollment  16  168  252k  opus-4-8
9063ce5a  3d ago      portfolio   Build dynamic themeable portfolio site          12  425  381k  opus-4-8
0bf9cc08  2026-05-29  zulip-tui   Build a Zulip TUI client                        14  348  255k  opus-4-7
...
27 sessions · vaportrail show <id> to replay one

    Why

    AI agents now do a meaningful share of the work in your repos, but their history is write-only: gigabytes of transcripts nobody can read. vaportrail answers the questions that data was always able to answer:

    • What did the agent actually do last Tuesday? → vaportrail show <id>
    • Where did we solve this exact problem before? → vaportrail search "jwt refresh"
    • Which files do agents churn on the most? What does a month of usage look like? → vaportrail stats

    Commands

    vaportrail / vaportrail list

    Recent sessions across every project — id, age, project, AI-generated title, prompt count, tool calls, output tokens, model.

    vaportrail show <id>

    Replay a session as a timeline: your prompts, the agent's narration, and every tool call with what it operated on.

    vaportrail · session cca29f96…
title    Build SSH over WebSocket with agent enrollment
project  ~/wssh (main)
when     2026-06-02 22:14 → 2026-06-03 00:04 (1h 49m)
activity 16 prompts · 183 turns · 168 tool calls · opus-4-8

22:14:30  ❯ So.. I have a cool ass idea. So... SSH.. but over websocket…
22:14:47  ⚒ Bash ls -la /Users/b/wssh && command -v go node python3…
22:15:40  ✦ Hell yes — this is a great idea, and it's very buildable…
22:17:03  ⚒ Write /Users/b/wssh/go.mod
22:17:15  ⚒ Write /Users/b/wssh/main.go
...

    Use --full for untruncated text.

    vaportrail search <query>

    Full-text search across your entire agent history — prompts and responses, with --regex for patterns and --tools to also match commands and file paths.

    vaportrail stats

    The big picture: sessions, prompts, turns, token totals (with cache split), a 30-day activity sparkline, a tool-usage leaderboard, per-model token tables, and the files your agents edit the most.

    Options

    flag meaning
    -p, --project <s> only sessions whose project path contains <s> (. = current dir)
    -n, --limit <n> max rows / matches
    -a, --all no limit
    -j, --json machine-readable output for every command
    -d, --dir <path> transcript root (default ~/.claude/projects, honors CLAUDE_CONFIG_DIR)
    --agents include subagent transcripts

    How it works

    Claude Code writes one JSONL file per session under ~/.claude/projects/. vaportrail stream-parses them (all known schema versions), deduplicates token usage that repeats across entries sharing a request, separates subagent sidechains from your own prompts, and filters out bookkeeping noise. ~100 MB of history parses in under half a second. Read-only: vaportrail never modifies a transcript.

    Roadmap

    • More agents: Codex CLI, opencode, Gemini CLI, Aider transcript formats
    • vaportrail export <id> — session → markdown / shareable gist
    • Cost estimates per session/model
    • Local web UI (vaportrail ui) with cross-session analytics
    • Watch mode — live tail of a running session

    License

    MIT © Brandon Bischoff