THREE-MINUTE SETUP

Watch a real repository.

Terrarium runs locally, opens in your browser, and records the session as JSONL. You do not need an account for the local watch.

Install

npx terrarium-watch .

Requires Node 18.17 or newer. Python 3.9 or newer adds structural detail for Python files. The command prints a tokenized localhost URL; open it and keep working in Claude Code or Codex as usual.

Useful commands

terrarium .: Watch the current repository.
terrarium demo: Play the bundled documentary session.
terrarium replay file.jsonl: Replay a saved session.
terrarium init-hooks .: Opt in to lower-latency Claude Code hooks.
terrarium tail --live: Stream raw events for inspection.

What Terrarium reads

Terrarium reads the repository you point it at. It also scans ~/.claude/projects and ~/.codex, then filters events to that repository. Agent transcripts can contain your prompts and the agent's reasoning verbatim.

Recordings are written to ~/.terrarium/sessions. They can include absolute paths, agent quotes, and source-like labels, so treat them as sensitive. Delete ~/.terrarium to remove local recordings.

Language support

TypeScript, JavaScript, and Python receive full symbol-level anatomy today. Other files still appear as cells on the map, without structural detail.