Skip to content

v0.1.0 — Claude Replay

Choose a tag to compare

View all tags
@constripacity constripacity released this 31 May 22:28
· 25 commits to main since this release
v0.1.0
77f9c01

First public release of Claude Replay — a passive session checkpoint and recovery layer for Claude Code. Hooks record every session to a local SQLite store, and a CLI, five MCP tools, a web dashboard, and a terminal UI read it back. Offline-first; nothing leaves your machine.

Install

pip install claude-replay

With the terminal UI:

pip install "claude-replay[tui]"

Then wire it into Claude Code and start the server:

claude-replay install     # merges the hooks into ~/.claude/settings.json (idempotent)
claude-replay serve       # dashboard + MCP tools on http://127.0.0.1:8766

What's included

  • Store — SQLite-backed sessions, events, and checkpoints, with per-session monotonic sequencing and 8 KB-per-event payload truncation. DB at ~/.claude-replay/sessions.db (overridable via CLAUDE_REPLAY_DB).
  • Hooks — PreToolUse / PostToolUse / Stop handlers that record tool calls, auto-checkpoint every 10 tool results, and write a final checkpoint on stop. Completes in well under 50 ms and never breaks the agent it records.
  • Recovery — generate a paste-ready resume brief (objective, work done, pending step, files touched) from any session.
  • Export — render a session as a self-contained HTML trace.
  • Server — Starlette app on port 8766: five replay_* MCP tools over SSE, a JSON API, and a static web dashboard.
  • Terminal UI — a Textual session browser over the JSON API, with one-key resume and export.
  • CLI — install, uninstall, status, sessions, resume, export, serve, tui, reset.
  • MCP tools — replay_status, replay_checkpoint, replay_resume, replay_sessions, replay_export.

Links

Assets 2
Loading