Relic

Your Claude Code control deck.

A local-only SvelteKit app to browse, replay, rename, pin, and resume every conversation you've had with Claude Code, across every project on your machine.

Relic reads the JSONL session logs Claude Code writes to ~/.claude/projects/ and gives you:

• A grid of all your projects with session counts, total events, prompts, and disk usage
• Per-project session list with first-prompt previews, branch, duration, and token totals
• Full session transcripts: chat replay with markdown, expandable tool calls (Bash/Read/Edit/…), files-touched list, raw JSONL toggle
• Resume any session in your terminal of choice — Warp, iTerm, or Terminal.app — with one click
• Rename sessions (round-trips with Claude Code's /rename and claude --resume picker)
• Pin projects and individual sessions to the top (persisted to localStorage)
• Light + dark themes with a one-click switcher
• Smart breadcrumbs and per-page metric cards

All data stays on your machine — there's no server call out to anything.

Prerequisites

• Node.js ≥ 24
• pnpm 10+ — install with corepack enable or npm i -g pnpm
• A populated ~/.claude/projects/ directory (Claude Code writes here automatically)

Setup

git clone https://github.com/adarshpandey-cs21/relic.git
cd relic
pnpm install

Run

pnpm dev               # start the dev server
pnpm dev --open        # also open it in the browser

The dev server runs at http://localhost:5757 by default.

Build

pnpm build             # production build
pnpm preview           # preview the production build locally
pnpm check             # typecheck + svelte-check

Environment variables

All env vars are optional. Copy .env.example to .env to override defaults:

cp .env.example .env

Restart the dev server after editing .env.

How it works

• src/lib/server/history.ts — reads CLAUDE_PROJECTS_DIR, walks each project folder, and parses each *.jsonl line by line. JSONL events get normalized into a typed schema (user-text, assistant-text, assistant-tool-use, user-tool-result, system, meta, …). Custom titles are read from both custom-title events (written by /rename) and ~/.claude/sessions/<pid>.json's name field, with PID JSON winning over JSONL — the same precedence Claude /resume uses.
• src/routes/+page.svelte — projects grid (homepage)
• src/routes/projects/[projectId]/+page.svelte — sessions list for a project
• src/routes/projects/[projectId]/sessions/[sessionId]/+page.svelte — full transcript view
• src/routes/api/rename/+server.ts — append-only rename endpoint that mirrors /rename's behavior (writes custom-title + agent-name events, also patches the PID JSON name field if one exists).
• src/routes/api/resume/+server.ts — opens a session in Warp / iTerm / Terminal via AppleScript or URL schemes.
• src/lib/pinned.svelte.ts — reactive store for pinned projects + sessions, persisted to localStorage.

Tech stack

• SvelteKit 2 (Svelte 5 with runes)
• Tailwind CSS v4 with a custom ink/accent palette
• marked + isomorphic-dompurify for sanitized markdown rendering
• TypeScript end-to-end, type-checked with svelte-check

License

MIT — do whatever you want with it.