Claude Resume Tool

Enhanced session resume for Claude Code with AI-generated summaries.

Problem

When using Claude Code, the native /resume command shows sessions that all look similar, making it difficult to identify which conversation to continue.

Solution

This tool displays your recent Claude Code sessions with AI-generated summaries, making it easy to find and resume the right conversation.

Features

• 📋 Shows your 10 most recent Claude Code sessions
• 🤖 AI-generated summaries (5-8 words each) based on actual conversation content
• ⚡ Single API call for all summaries (fast!)
• 🔧 Uses your existing Claude Code configuration (no additional API keys needed)
• 🎯 Works with any Claude Code project

Installation

Local Development

# Clone the repo
git clone https://github.com/yourusername/claude-resume-tool.git
cd claude-resume-tool

# Make executable
chmod +x index.js

# Run directly
node index.js

Global Installation (coming soon)

npm install -g claude-resume-tool
claude-resume

Usage

Simply run the tool:

node index.js

You'll see a menu like this:

📋 Recent Claude Code Sessions:

1. Deploy K3s cluster with Traefik
   10/4/2025, 5:30 PM (45 messages)

2. Fix MarketService API integration issues
   10/3/2025, 2:15 PM (32 messages)

3. Alpaca trading API research
   10/2/2025, 9:08 AM (18 messages)

0. Cancel

Select session (1-3, 0 to cancel):

Enter the number of the session you want to resume, and the tool will launch claude --resume with that session.

How It Works

1. Session Discovery: Scans ~/.claude/projects/ for recent session files
2. Message Extraction: Reads the last 5 messages from each session
3. AI Summarization: Uses claude --print to generate summaries in one call
4. Interactive Menu: Displays sessions with summaries and timestamps
5. Resume: Launches claude --resume <session-id> for your selection

Requirements

• Node.js >= 18
• Claude Code CLI installed and configured
• Active Claude Code sessions in ~/.claude/projects/

Configuration

The tool automatically:

• Uses your existing Claude Code model configuration (AWS Bedrock, Anthropic API, etc.)
• Respects your API keys and billing settings
• Works with whatever model you have configured

No additional configuration needed!

Development

# Run locally
node index.js

# Test in different project
cd ~/Projects/your-project
node ~/Projects/claude-resume-tool/index.js

Future Enhancements

• Caching summaries with modification time validation
• Cross-project session search
• Date range filtering
• Fuzzy search through summaries
• Custom summary length preferences
• Better JSON parsing from Claude responses

Contributing

Contributions welcome! Please feel free to submit a Pull Request.

License

MIT

Author

Built to solve a real problem from this Reddit discussion.