s40911120/recensa repository overview

⁠Recensa

See what your agents actually did. A local, self-hosted web viewer for your Claude Code session transcripts — read, search, replay, and audit every session you have ever run. Your transcripts stay on your machine; nothing is uploaded anywhere.

Recensa indexes the raw JSONL under ~/.claude/projects/ into a local SQLite database and serves a three-pane reader at http://localhost:7788: full-text search across all sessions, folded tool calls with real diffs, per-session token/cost statistics, subagent and teammate rosters with jump-to-call-site, compaction history with full-conversation reconstruction, live tail over WebSocket, and fourteen themes.

Reading never modifies your transcripts. The index is a disposable cache; your pins, tags, and notes live in a separate database that survives every rebuild.

⁠Quick start

# macOS / Linux
docker run -d --name recensa -p 127.0.0.1:7788:7788 \
  -v "$HOME/.claude:/data/claude" \
  -v recensa-data:/app/backend/data \
  -e RECENSA_PROJECTS_DIR=/data/claude/projects \
  s40911120/recensa

# Windows — use PowerShell, not Git Bash (MSYS rewrites the /data/... paths)
docker run -d --name recensa -p 127.0.0.1:7788:7788 `
  -v "$env:USERPROFILE\.claude:/data/claude" `
  -v recensa-data:/app/backend/data `
  -e RECENSA_PROJECTS_DIR=/data/claude/projects `
  s40911120/recensa

Then open http://localhost:7788⁠. The first index runs in a background worker; the UI is usable while it fills in.

⁠Tags and platforms

• latest — the most recent tagged release
• <version> (e.g. 0.1.0) — immutable release tags
• Multi-arch: linux/amd64 and linux/arm64 (Apple Silicon pulls a native image)

⁠Volumes and configuration

⁠Security

Built for single-machine, local use — no authentication is shipped. Publish the port to 127.0.0.1 only (as above). Do not expose it to a network without your own auth and reverse proxy in front. No telemetry, no external network calls.

⁠Links

• Source, README with screenshots, and issues: https://github.com/S40911120/recensa⁠
• Session engine (npm): https://www.npmjs.com/package/@recensa/claude-session⁠
• License: MIT