Skip to content

Kropiunig/claude-explorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Claude Explorer

A web UI for browsing, searching, and managing your Claude Code chat sessions. Dark-themed, fast, and works entirely offline.

Features

  • Browse all sessions -- grouped by project in a collapsible tree view
  • Full-text deep search -- search across every message in every conversation, with highlighted snippets
  • Persistent search index -- built once, updated incrementally, instant results
  • Rename sessions -- give chats meaningful names that persist across reloads
  • Delete sessions -- remove JSONL files and associated data with confirmation
  • Continue sessions -- resume any chat in a new terminal window with one click
  • Project tree grouping -- nested projects are displayed hierarchically based on file paths
  • Settings -- toggle dangerous mode (--dangerously-skip-permissions) for resumed sessions

Quick Start

git clone https://github.com/Kropiunig/claude-explorer.git
cd claude-explorer
npm install
npm start

Open http://localhost:3000 in your browser.

How It Works

Claude Explorer reads from your ~/.claude/ directory (where Claude Code stores session data). It scans:

  • ~/.claude/projects/ -- JSONL conversation files and session caches
  • ~/.claude/history.jsonl -- command history with prompt text

All data access is read-only against Claude's files. Claude Explorer stores its own metadata (custom names, settings, search index) in separate files alongside server.js.

On first launch, a search index is built from all conversation files. Subsequent starts only re-index changed files, making startup fast.

Platform Support

Platform Status Notes
Windows Full support Opens cmd.exe for continued sessions
macOS Full support Opens Terminal.app via osascript
Linux Full support Auto-detects terminal (gnome-terminal, konsole, xfce4-terminal, xterm)

Note: File system watching uses fs.watch({ recursive: true }), which works reliably on Windows and macOS. On Linux, recursive watching has limited support -- the UI will still work, but you may need to refresh manually to see new sessions.

Settings

Access settings via the gear button in the header:

  • Dangerous mode -- When enabled, resumed sessions launch with --dangerously-skip-permissions, skipping all Claude Code permission prompts. Enabled by default.

Configuration

Environment Variable Default Description
PORT 3000 Server port

License

MIT

About

Web UI to browse, search, rename, delete, and continue Claude Code chat sessions

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors