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
- 🚀 Start new Claude sessions in selected project directories
- 📁 Filter conversations to current directory with
.argument - 🎭 Hide specific message types for cleaner display
- ⚙️ Edit Claude command options interactively before starting sessions
- 🔄 Toggle full conversation view to see complete message history
npx @sasazame/ccresume@latestnpm install -g @sasazame/ccresumeRun the command in your terminal:
ccresumeOr if using npx:
npx @sasazame/ccresume@latest# Hide specific message types
ccresume --hide # Default: hides tool and thinking messages
ccresume --hide tool # Hide only tool messages
ccresume --hide thinking # Hide only thinking messages
ccresume --hide user # Hide only user messages
ccresume --hide assistant # Hide only assistant messages
ccresume --hide tool thinking user # Hide multiple types
# Filter to current directory
ccresume .
# Show help
ccresume --help
ccresume -h
# Show version
ccresume --version
ccresume -vAll unrecognized 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
# Combine ccresume and claude options
ccresume --hide tool --model opus
ccresume . --hide --dangerously-skip-permissions- Don't use options like
--resumeor something like that changes claude's interactive behavior
- Node.js >= 18
- Claude Code - Must be installed and configured
- Operating System - Works on macOS, Linux, and Windows (both native & WSL)
Press - to open the command editor, where you can configure Claude CLI options before starting or resuming a session. The editor provides:
- Autocomplete suggestions - Type
-to see matching Claude options - Official help text - View all available Claude CLI options
- Interactive editing - Use arrow keys, Tab for autocomplete, Enter to confirm
The configured options will be passed to Claude when you start a new session (n) or resume a conversation (Enter).
Note: The options list is based on Claude's help text at a specific point in time. Please refer to claude --help for the latest available options. Some options like -r, -c, -h may interfere with ccresume's functionality.
| Action | Keys |
|---|---|
| Quit | q |
| Select Previous | ↑ |
| Select Next | ↓ |
| Confirm/Resume | Enter |
| Start New Session | n |
| Edit Command Options | - |
| Copy Session ID | c |
| Scroll Up | k |
| Scroll Down | j |
| Page Up | u, PageUp |
| Page Down | d, PageDown |
| Scroll to Top | g |
| Scroll to Bottom | G |
| Next Page | → |
| Previous Page | ← |
| Toggle Full View | f |
You can customize key bindings by creating a configuration file at ~/.config/ccresume/config.toml:
[keybindings]
quit = ["q", "ctrl+c", "esc"]
selectPrevious = ["up", "k"]
selectNext = ["down", "j"]
confirm = ["enter", "l"]
copySessionId = ["y"]
scrollUp = ["u", "ctrl+u"]
scrollDown = ["d", "ctrl+d"]
scrollPageUp = ["b", "ctrl+b"]
scrollPageDown = ["f", "ctrl+f"]
scrollTop = ["g"]
scrollBottom = ["shift+g"]
pageNext = ["right", "n"]
pagePrevious = ["left", "p"]
startNewSession = ["n"]
openCommandEditor = ["-"]
toggleFullView = ["f"]See config.toml.example in the repository for a complete example.
# 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 typecheckccresume/
├── 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
MIT
For issues and feature requests, please use the GitHub issue tracker.
Below are known issues and limitations. Contributions and suggestions are welcome!
| No. | Title | Description | Issue |
|---|---|---|---|
| 1 | Incomplete conversation history restoration on resume | When resuming with ccresume, sometimes, only the tail end of the history is restored. Although the interactive claude -r can restore full history. Workaround: use claude -r interactively or claude -c. |
#2 |
| 2 | ccresume leaves the chat selection interface visible and hides previous terminal content. |
#3 | |
| 3 | Resume ordering may be incorrect | For performance issue, ccresume sorts logs by file system timestamps (not chat content), so display order may not match actual chronology after migration. Workaround: preserve file timestamps. |
– |
| 4 | Windows native terminal limitations | On Windows native terminals, interactive features may have limited functionality due to terminal input handling differences. Temporarily, in the Windows native environment, a warning message will be displayed before startup. | #32 |
Remember: This is an unofficial tool. For official Claude Code support, please refer to Anthropic's documentation.