Claude Code Conversation Manager

Browse and manage your Claude Code conversation history with an interactive CLI.

Features

• 📊 Statistics - View breakdown of all conversation files
• 🔍 Fork Detection - Automatically identifies and deduplicates forked conversations
• ⌨️ Interactive Menu - Arrow key navigation to browse conversations
• 🚀 Quick Resume - Instantly resume any conversation with claude -r
• 🎯 Auto-Detection - Automatically detects current project or lets you choose
• 📅 Sorted by Date - Conversations ordered by when they started

Installation

NPX (Recommended - No Installation)

npx @dennisk/claude-conv-manager

Global Install

npm install -g @dennisk/claude-conv-manager

Then run with:

claude-convs

Usage

Run the command from any directory:

npx @dennisk/claude-conv-manager

The tool will:

1. Auto-detect your current Claude Code project, or
2. Let you select from all available projects
3. Display statistics about your conversations
4. Show an interactive list of conversations
5. Let you select one to resume with arrow keys

How It Works

Project Detection

The tool automatically detects Claude Code projects by:

• Checking if you're in a directory that matches a project in ~/.claude/projects/
• If not found, it shows all available projects for selection

Fork Handling

When you fork conversations in Claude Code, multiple files can share the same conversation history. This tool:

• Groups conversations by their first message
• Identifies the "canonical" version (the one with most messages)
• Shows only canonical conversations to avoid duplicates

Statistics

The tool analyzes your conversation files and categorizes them:

• FULL-CONVERSATIONS - Files with actual user/assistant messages
• SNAPSHOT-ONLY - Files containing only file history snapshots
• SUMMARY-ONLY - Files with only conversation summaries
• EMPTY - Empty files
• MIXED-NO-MESSAGES - Files with metadata but no messages
• AGENT-FILES - Sub-agent conversation files

Example Output

=== STATISTICS ===

Total files: 594
  FULL-CONVERSATIONS: 78
  SNAPSHOT-ONLY: 106
  SUMMARY-ONLY: 10
  EMPTY: 13
  MIXED-NO-MESSAGES: 21
  AGENT-FILES: 366

Canonical conversations: 56
Fork groups: 10
Total forks: 22

=== CONVERSATIONS ===

Use arrow keys to navigate, Enter to select

  1 | 224 msgs   | 11/15/2025, 5:12:08 PM
  2 | 4 msgs     | 11/15/2025, 4:36:02 PM
  3 | 2 msgs     | 11/14/2025, 4:35:02 AM
  ...

Requirements

• Node.js >= 16.0.0
• Claude Code installed and configured

License

MIT

Author

Dennis K