A character user interface (CUI) tool for browsing and resuming Claude Code conversations.
ccresume provides an interactive terminal interface to browse and manage your Claude Code conversation history. It reads conversation data from your local Claude Code configuration and displays them in an easy-to-navigate format.
- 📋 Browse all Claude Code conversations across projects
- 🔍 View detailed conversation information
- 📎 Copy session IDs to clipboard
- 📁 Filter conversations to current directory with
.
argument
npx @sasazame/ccresume@latest
npm install -g @sasazame/ccresume
Run the command in your terminal:
ccresume
Or if using npx:
npx @sasazame/ccresume@latest
Important: All command-line arguments are passed directly to the claude
command when resuming a conversation.
# Pass options to claude
ccresume --dangerously-skip-permissions
# Multiple options
ccresume --model opus --dangerously-skip-permissions
# Filter to current directory only
ccresume .
# Combine with claude options
ccresume . --model opus
- Don't use options like
--resume
or something like that changes claude's interactive behavior
- Node.js >= 16
- Claude Code - Must be installed and configured
- Operating System - Works on macOS, Linux, and Windows (with WSL)
# Clone the repository
git clone https://github.com/yourusername/ccresume.git
cd ccresume
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build the project
npm run build
# Run tests
npm test
# Run tests in watch mode
npm run test:watch
# Generate test coverage
npm run test:coverage
# Run linter
npm run lint
# Type check
npm run typecheck
ccresume/
├── src/ # Source code
│ ├── cli.tsx # CLI entry point
│ ├── App.tsx # Main application component
│ └── ... # Other components and utilities
├── dist/ # Compiled output
├── tests/ # Test files
└── package.json # Project configuration
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature
) - Commit your changes (
git commit -m 'Add some AmazingFeature'
) - Push to the branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
- ccresume currently loads all conversations on startup
- With a large number of conversations (1000+), initial loading may take a few seconds
- Future improvements may include:
- Pagination or lazy loading for better performance with large datasets
- Configurable limits on the number of conversations displayed
- Caching mechanisms for faster repeated access
MIT
For issues and feature requests, please use the GitHub issue tracker.
Remember: This is an unofficial tool. For official Claude Code support, please refer to Anthropic's documentation.