Local-first session manager for Claude Code

See, search and manage every Claude Code session.

ClaudeKeep finds every session across all your projects, surfaces real titles and token spend, and lets you rename, move, export and clean them up — running entirely on your machine.

Quick start Star on GitHub
  • 100% local · 127.0.0.1
  • No dependencies — Python stdlib
  • Backups before every change

Claude Code quietly stores every conversation as .jsonl logs under ~/.claude/projects — undocumented, hard to browse, and easy to lose track of. ClaudeKeep turns that pile into a clean, searchable workspace.

Everything in one place

A real interface for your AI history

Browse, understand and tidy up months of Claude Code sessions — without ever touching a UUID.

Unified discovery

Every session across every project, grouped and color-coded — with Claude's own AI titles instead of raw UUIDs.

Cost & token insights

Estimated spend, token breakdown, cost-by-model, tool usage and an activity heatmap — computed from the usage your sessions already record.

Command palette & deep search

Hit ⌘K to jump to any session, run an action, or full-text search inside conversations with highlighted snippets.

Pin, filter & resume

Pin what matters, filter to Pinned / Empty / Large, and copy a ready-to-run claude --resume command in one click.

Export to claude.ai

One click to clean Markdown, JSON or plain text. Paste a full transcript into claude.ai and pick the conversation back up.

Safe by design

Rename, move, clear and delete — every destructive action backs up first, confirms twice, and never overwrites.

Flagship

See exactly where your tokens go

ClaudeKeep reads the usage recorded on every assistant turn and prices it against the current Claude rate card — input, output, and the cache-read / cache-write split — to give you a grounded estimate of spend per model, per project, and over time.

  • Per-model and per-project cost breakdowns
  • Token mix: input · cache write · cache read · output
  • GitHub-style activity heatmap
  • Top tools, busiest projects, and totals
Up and running in 30 seconds

Clone it. Run it. Done.

No build step, no pip install, no account. Just Python 3.8+ and your terminal.

1

Clone the repo

git clone https://github.com/ayushkcs/ClaudeKeep.git
cd ClaudeKeep
2

Start the local server

python3 server.py

Stdlib only — it binds to 127.0.0.1 and opens your browser automatically.

3

Open the dashboard

http://127.0.0.1:8765

Your sessions appear instantly. Nothing leaves your machine.

Prefer not to clone? Download the ZIP from GitHub, unzip it, and run python3 server.py inside the folder — same result.

Trust

Your data never leaves your machine

ClaudeKeep is deliberately conservative. It reads your real session files, so it treats them with care.

Local only

Binds to 127.0.0.1 and rejects non-local hosts. No cloud, no network, no telemetry.

Backups first

Every move, clear and delete copies the file into a timestamped backups/ folder before touching anything.

Path-traversal proof

Every path is resolved and verified to stay inside ~/.claude/projects. Deletes require a typed confirmation.

Unofficial format

The on-disk format is undocumented; ClaudeKeep adapts to what it finds and is fully recoverable from backups if a Claude update changes it.

Questions

Good to know

Does ClaudeKeep send my data anywhere?

No. It runs a local server on 127.0.0.1 with no external requests of any kind. Your conversations stay on disk, on your machine.

Do I need to install dependencies?

No. The backend is pure Python standard library and the frontend is vanilla HTML/CSS/JS — no pip install, no Node, no build step.

Can it break or lose my sessions?

It's built to avoid exactly that: read-only by default, a backup before every destructive action, conflict detection on moves, and a typed confirmation before deletes.

Are the cost numbers exact?

They're careful estimates from each turn's recorded token usage, priced against the current Claude rate card (including the 5-minute vs 1-hour cache-write split). Actual billing also depends on plan and tier.

Is this an official Anthropic product?

No — it's an independent, open-source tool that reads Claude Code's local files. The storage format is unofficial and could change between Claude Code versions.

Bring order to your Claude Code history

Clone it, run one command, and see every session in a workspace that's actually nice to use.

git clone https://github.com/ayushkcs/ClaudeKeep.git && cd ClaudeKeep && python3 server.py
Read the quick start View source ↗