claude-replay: developer tool for Hermes Agent

Turns Hermes Agent, Claude Code, Codex and other coding agent sessions into self-contained HTML replays

What claude-replay does

claude-replay auto-detects the transcript format of Claude Code, Cursor, Codex CLI, Gemini CLI, OpenCode, Kimi Code and Hermes Agent and converts it into a single HTML file with no external dependencies. For Hermes Agent it reads ~/.hermes/state.db live through SQLite, or you can use hermes sessions export. Playback is interactive with speed control, and tool calls and thinking blocks can be collapsed or expanded.

Other features include bookmarks and chapters, secret redaction before export, color themes, a file activity sidebar, iframe embedding, and a live watch mode started with --serve --watch to monitor sessions as they run. Running claude-replay with no arguments opens a web editor for browsing, editing and exporting. A Docker image serves the editor on port 7331. The README labels it a community tool that is not affiliated with Anthropic.

Key features

Single self-contained HTML replay with no external dependencies
Auto-detects Claude Code, Cursor, Codex CLI, Gemini CLI, OpenCode, Kimi Code and Hermes Agent formats
Reads Hermes Agent sessions from ~/.hermes/state.db or hermes sessions export
Secret redaction before export
Live watch mode with --serve --watch
Web editor and Docker image for visual editing and export

When to use it

Sharing a Hermes Agent debugging session in a blog post or documentation page
Attaching a replay to a bug report instead of long logs
Watching an agent session on a remote machine or container in real time

Who it is for: Developers who want to share or review coding agent sessions as interactive replays.

How it fits with Hermes Agent

Hermes Agent is one of seven supported agent formats, read from its SQLite state database or an export. It is a general tool, and the repository carries the hermes-agent topic.

How to install claude-replay

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

npm install -g claude-replay
npx claude-replay

FAQ

What is claude-replay?

claude-replay turns AI coding agent session logs into interactive, shareable HTML replays. Each replay is a single self-contained HTML file you can email, host or embed.

Does claude-replay work with Hermes Agent?

Yes, Hermes Agent is one of the supported sources. It reads the ~/.hermes/state.db SQLite database live, or you can feed it the output of hermes sessions export.

How do I install claude-replay?

Run npm install -g claude-replay, or run it without installing using npx claude-replay. A Docker image is also available, which serves the web editor on port 7331.