rewindx 0.1.0

Time-travel debugger and shareable replay for Claude Code sessions.

rewind

Time-travel debugger and shareable replay for Claude Code sessions.

Capture every event in a Claude Code session, scrub through the timeline, roll back the file system to any point in seconds, and export a shareable transcript. Local-first, no API keys, MIT licensed.

pip install rewindx       # PyPI package; binary is `rewind`
rewind cc setup           # wire up Claude Code hooks (idempotent)
# ...use Claude Code normally...
rewind tui                # browse the most recent session
rewind goto 31            # restore the file system to just before event #31
rewind export --format markdown --out session.md

Why

Claude Code does dozens of tool calls per session. The agent's transcripts are JSONL, hard to read, and impossible to replay. git diff shows files but not the reasoning. When the agent breaks something subtle, you have nothing to fall back on. rewind closes that loop:

• Observability — every prompt, tool call, file edit, and cost recorded in a per-session SQLite + content-addressed blob store.
• Recovery — rewind goto <seq> restores the file system to any prior point. Every rollback creates a checkpoint so rewind undo is one command.
• Shareable replay — rewind export renders the session as a Markdown transcript (text, GIF, and MP4 backends are scaffolded for V0.2). Privacy filters mask file contents and env-shaped secrets by default.

Status

Pre-launch alpha (v0.1.0). The core pipeline is production-grade: 131 tests, 87% branch coverage, mypy strict, ruff clean. The interactive TUI ships in V0.2; V0.1 prints the timeline and event detail to the terminal.

What it captures

Hook	Stored event	Snapshots
SessionStart	session_start	—
UserPromptSubmit	user_prompt	—
PreToolUse	pre_tool	before-content of every Edit / Write path
PostToolUse	post_tool	after-content + classification (productive / wasted / neutral)
Stop	session_end	totals (cost, tokens, events)

CLI

rewind --version
rewind cc {setup,uninstall,status} [--scope user|project]
rewind capture {session-start,user-prompt,pre-tool,post-tool,session-end}    # reads stdin
rewind sessions {list,show,delete}
rewind tui [SESSION_ID] [--seq N]
rewind goto SEQ [--session ID] [--cwd PATH] [--force] [--dry-run]
rewind undo
rewind stats [SESSION_ID] [--json]
rewind export [SESSION_ID] [--format text|markdown] [--out PATH] [--no-mask]

Storage layout

~/.rewind/
├── config.toml                  # optional, all fields have defaults
├── current_session.txt          # active session id
├── checkpoints/                 # one JSON per rollback (used by `rewind undo`)
└── sessions/
    └── <session_id>/
        ├── events.db            # SQLite, WAL mode, schema v1
        └── blobs/<aa>/<bb>/<sha256>

Per-session storage isolates blast radius: deleting one session is one rm -rf, nothing else is affected.

Privacy

• Local-only: zero network calls. No telemetry. Ever.
• rewind export masks file contents to head/tail and redacts env-shaped secrets by default. Use --no-mask to opt out explicitly.
• .gitignore template: add .rewind/ if you keep a per-project home.

Documents

• PLAN.md — product plan and pitch
• docs/ARCHITECTURE.md — schemas, data flow, modules
• docs/ROADMAP.md — six-phase roadmap
• docs/LAUNCH.md — pre-launch + launch playbook
• docs/DECISIONS.md — ADRs
• docs/NAMING.md — name candidates and verification
• CHANGELOG.md
• CONTRIBUTING.md

Sister projects

rewind is one corner of an ecosystem of open-source tools for Claude Code:

Project	Concern	Repo
spent	cost tracking	https://github.com/loplop-h/spent
debtx	code quality	https://github.com/loplop-h/debtx
mcpguard	MCP security	https://github.com/loplop-h/mcpguard
rewind	observability + recovery	(this repo)

License

MIT.