Claude Session Manager

Manage your Claude Code conversation history with a beautiful web UI

Note: This is an enhanced fork of claude-run by Kamran Ahmed. Original project: https://github.com/kamranahmedse/claude-run

New in v0.4.0: Export sessions to markdown, rename sessions, and delete sessions

Run the project simply by executing

npx @bhala-srinivash/claude-session-manager

The browser will open automatically at http://localhost:12001.

Features

• Real-time streaming - Watch conversations update live as Claude responds
• Search - Find sessions by prompt text or project name
• Filter by project - Focus on specific projects
• Resume sessions - Copy the resume command to continue any conversation in your terminal
• Export sessions - Save conversations as markdown with full history, tool calls, and statistics (NEW ✨)
• Rename sessions - Update session names with inline editing (NEW ✨)
• Delete sessions - Remove unwanted sessions via UI or API (NEW ✨)
• Collapsible sidebar - Maximize your viewing area
• Dark mode - Easy on the eyes
• Clean UI - Familiar chat interface with collapsible tool calls

Usage

Install globally via npm:

npm install -g @bhala-srinivash/claude-session-manager

Then run it from any directory:

claude-session-manager

The browser will open automatically at http://localhost:12001, showing all your Claude Code conversations.

Export Sessions

Export any session to markdown format with full conversation history:

1. Select a session in the UI
2. Click the "Export Session" button in the header
3. File is saved to the project's .claude/conversation-logs/ directory

The exported markdown includes:

• Full conversation with timestamps
• Tool calls with inputs/outputs
• Thinking blocks
• Token usage statistics
• Tools used summary

Rename Sessions

Update session names directly in the UI:

1. Hover over a session in the list
2. Click the edit (pencil) icon
3. Type the new name and press Enter

Delete Sessions

Remove unwanted sessions via UI or API:

Via UI:

1. Hover over a session in the list
2. Click the delete (trash) icon
3. Confirm deletion

Via API:

curl -X DELETE http://localhost:12001/api/sessions/YOUR_SESSION_ID

See API.md for complete API documentation.

Command Options

claude-session-manager [options]

Options:
  -V, --version        Show version number
  -p, --port <number>  Port to listen on (default: 12001)
  -d, --dir <path>     Claude directory (default: ~/.claude)
  --no-open            Do not open browser automatically
  -h, --help           Show help

How It Works

Claude Code stores conversation history in ~/.claude/. This tool reads that data and presents it in a web interface with:

• Session list - All your conversations, sorted by recency
• Project filter - Focus on a specific project
• Conversation view - Full message history with tool calls
• Session header - Shows conversation title, project name, and timestamp
• Resume command - Copies the command to resume the conversation
• Real-time updates - SSE streaming for live conversations

Requirements

• Node.js 20+
• Claude Code installed and used at least once

Development

# Clone the repo
git clone https://github.com/Bhala-Srinivash/claude-session-manager.git
cd claude-session-manager

# Install dependencies
npm install

# Start development servers
npm run dev

# Build for production
npm run build

What's New in This Fork

v0.4.0 - Session Management Features

• 📤 Export to Markdown - Save sessions as markdown with full conversation history, tool calls, thinking blocks, and statistics
• ✏️ Rename Sessions - Update session names with inline editing (Enter/Escape shortcuts)
• 🗑️ Delete Sessions - Remove sessions via UI (hover menu) or API endpoint
• 🎯 Project-based Exports - Sessions export to their own project's .claude/conversation-logs/ directory
• 📊 Export Statistics - Token usage, message counts, and tools used summary in exports

v0.3.0 - Initial Fork

• 🗑️ DELETE /api/sessions/:id - Programmatically delete conversation sessions
• 📚 API Documentation - Complete API reference in API.md
• 🔧 npm compatibility - Build scripts work with npm (no pnpm required)

Contributing

This is a personal fork with enhancements. For the original project, see:

• Original repo: https://github.com/kamranahmedse/claude-run
• Original author: Kamran Ahmed

License

MIT © Kamran Ahmed (original), Bhala Srinivash (enhancements)