whatisgithub

What is recensa?

s40911120/recensa — explained in plain English

Analysis updated 2026-05-18

65TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

Recensa is a self-hosted web viewer that indexes Claude Code session transcripts locally, giving you full-text search, diff views of edits, and multi-agent auditing without uploading anything.

Mindmap

mindmap
  root((recensa))
    What it does
      Views Claude Code transcripts
      Full text search
      Diff view of edits
    Tech stack
      TypeScript
      Docker
      SQLite
    Use cases
      Search past sessions
      Review file diffs
      Audit multi agent runs
    How it runs
      Self hosted
      Local only
      Docker Compose

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Search across every Claude Code session you have ever run instead of just the last few shown by the resume picker.

USE CASE 2

Review a proper before and after diff of every file an AI coding agent edited during a session.

USE CASE 3

Audit multi-agent sessions by seeing every subagent that was spawned and jumping into its own transcript.

What is it built with?

TypeScriptDockerSQLite

How does it compare?

s40911120/recensaboring-software-inc/dither-kitcompdf/compdf-self-hosted
Stars656565
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Docker and an existing ~/.claude directory with session transcripts, first index build can take minutes to tens of minutes.

Use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

So what is it?

Recensa is a self-hosted web viewer for reading, searching, and reviewing the conversation transcripts that Claude Code, the AI coding assistant, saves to your computer every time you use it. Normally those transcripts sit as raw, hard to read files on disk, Recensa indexes them into a local database and displays them in a browser at a local web address, without uploading anything to an outside server. Once running, Recensa gives you full text search across every session you have ever run, not just the handful shown by Claude Code's own resume picker, so you can find something like "how did I fix that bug last month" in one search. Long sessions with thousands of tool calls can be folded down into a simplified view that hides tool activity and internal thinking, leaving just your prompts and the model's replies, and a focus mode strips away the surrounding interface for distraction free reading. Every file edit an agent made during a session is rendered as a proper before and after diff, so you can review exactly what changed without leaving the viewer. Each session also shows statistics such as which tools were used, how many files were created, edited, or deleted, which AI models were involved, and an estimated dollar cost for that session. When a session spawns multiple subagents working together, Recensa rebuilds the full roster of agents involved and lets you jump directly into any subagent's own transcript and back again. Recensa runs as a Docker container, reading your local .claude folder and serving the viewer at localhost:7788. It can be started directly from a prebuilt Docker Hub image, through Docker Compose, or built from source after cloning the repository. The first time it runs, it builds its search index in the background, which can take anywhere from minutes to tens of minutes depending on how many past sessions you have, while the interface stays usable in the meantime. The project is written in TypeScript and released under the MIT License.

Copy-paste prompts

Prompt 1
Help me start Recensa with Docker and point it at my ~/.claude folder.
Prompt 2
Explain what Recensa's Main toggle and Focus mode do differently when reading a long session.
Prompt 3
Walk me through setting up Recensa from source using Docker Compose.
Prompt 4
How does Recensa estimate the dollar cost of a Claude Code session?

Frequently asked questions

What is recensa?

Recensa is a self-hosted web viewer that indexes Claude Code session transcripts locally, giving you full-text search, diff views of edits, and multi-agent auditing without uploading anything.

What language is recensa written in?

Mainly TypeScript. The stack also includes TypeScript, Docker, SQLite.

What license does recensa use?

Use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is recensa to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is recensa for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.