planviewer

README

planviewer

Browse the plans Claude Code, Codex and Antigravity write and search your past sessions to find the one to resume, from the terminal or a browser.

• Full-text search across titles, filenames, projects, session ids and plan bodies, with highlighted snippets
• Sort by updated, created, title, project or size
• Rendered markdown, plus raw view
• If ~/.claude/projects/ is present, session transcripts are used to recover each plan's exact creation time, originating project and the session that wrote it; otherwise creation time falls back to file mtime (shown as ~)
• Sessions: search transcripts by title (/rename or the generated one), project, git branch, your prompts and Claude's replies, then read the conversation and get the command to resume it. Tool calls, tool output and thinking are not indexed.
• Codex: if ~/.codex/sessions/ is present, Codex sessions and the plans proposed in plan mode are listed alongside Claude's. A Codex plan is named after its session id (<id>, then <id>-2, … for later plans in the same session). Subagent and review threads are skipped.
• Antigravity: if ~/.gemini/antigravity-cli/brain/ is present, Antigravity conversations are listed as sessions and every artifact it writes (implementation_plan.md, task.md, walkthrough.md, reports…) as a plan, named <conversation id>/<file>. Subagent and internal conversations are skipped. Titles and workspaces come from Antigravity's annotations, conversation cache and prompt history.
• When more than one tool is present, each item is labelled with its source; prefix the search with src:claude, src:codex or src:agy to show only one.
• Each plan shows what its transcript says happened to it: draft (a Claude plan written but never presented), pending (presented, not approved), rejected, approved, or worked on (approved, then the agent ran tools). worked on means work started after approval, not that it was finished. An Antigravity artifact gets a status only when the agent asked for a review, and a free-text reply counts once the agent acts on it. Prefix the search with status: to filter, e.g. status:worked or status:pending.

Install

go install github.com/nbr23/planviewer@latest

Or build from source: go build -o planviewer .

Both commands read Claude Code data from $CLAUDE_CONFIG_DIR, defaulting to ~/.claude (override with -claude-dir <dir>), Codex data from $CODEX_HOME, defaulting to ~/.codex (override with -codex-dir <dir>, disable with -codex-dir=), and Antigravity data from ~/.gemini/antigravity-cli (override with -agy-dir <dir>, pointing at either ~/.gemini or its antigravity-cli directory; disable with -agy-dir=). Any one of them is enough.

The parsed transcript index is cached in your user cache directory (~/.cache/planviewer on Linux), so later launches only read what was appended since. Change the location with -cache-dir <dir>, or disable caching with -cache-dir=.

CLI

planviewer          # same as: planviewer tui

List view: type to search, ↑/↓ move, enter open, tab cycle sort key, shift+tab reverse, ctrl+←/→ (or ctrl+t) switch between plans and sessions, ctrl+r reload, esc clear search / quit.

Search matches plan bodies and highlights the matching text in snippets:

Plan and session views use most-style keys: j/k, space/u, g/G (or t/b), / and ? to search, n/N next/previous match, % / J go to percent / line, h help, q back. In a session, the header shows the command to resume it (claude --resume <id>, codex resume <id> for Codex, agy --conversation=<id> for Antigravity, prefixed with cd ~/<project> &&), and r quits and prints it for you to run. A plan shows the same command for the session that wrote it, or just that session's ID if its transcript is gone.

Markdown style follows the terminal background; set GLAMOUR_STYLE (e.g. dark, light, dracula) to override.

Rendered plan with a table, syntax highlighting and a resume command

Web

planviewer serve                 # http://localhost:8080
planviewer serve -addr :9000     # or ADDR=:9000

/ focuses search, arrows + enter open a plan, column headers sort. On a plan page, r toggles raw view, and the id of the session that wrote the plan links to that session's page. /sessions lists sessions the same way; a session page shows the conversation and a copyable resume command. On either page, esc or backspace goes back.

The sessions pages serve your prompts and the agents' replies, so keep the listener on localhost unless you mean to share them.

Docker

docker compose up -d

Mounts read-only ${CLAUDE_CONFIG_DIR:-~/.claude}/{plans,projects}, ${CODEX_HOME:-~/.codex}/{sessions,session_index.jsonl} and ~/.gemini/antigravity-cli/{brain,cache,annotations,history.jsonl} (none of the tools' credentials), and binds to 127.0.0.1:${PORT:-8080}. Docker creates any missing mount source as an empty root-owned directory, so remove the lines for tools you don't use. Transcripts are mode 0600, so on Linux set HOST_UID/HOST_GID to their owner if it isn't 1000. The transcript cache is disabled in the container, so the index is rebuilt on each start.