10000 GitHub - yuki-yano/ccresume: A CUI tool for browsing and resuming Claude Code conversations
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

yuki-yano/ccresume

 
 

Repository files navigation

ccresume

A character user interface (CUI) tool for browsing and resuming Claude Code conversations.

ccresume screenshot

⚠️ DISCLAIMER: This is an unofficial third-party tool not affiliated with or endorsed by Anthropic. Use at your own risk.

Overview

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.

Key Features

  • 📋 Browse all Claude Code conversations across projects
  • 🔍 View detailed conversation information
  • 📎 Copy session IDs to clipboard
  • 📁 Filter conversations to current directory with . argument

ccresume demo

Installation

Via npx (Recommended)

npx @sasazame/ccresume@latest

Global Installation

npm install -g @sasazame/ccresume

Usage

Run the command in your terminal:

ccresume

Or if using npx:

npx @sasazame/ccresume@latest

Passing Options to Claude

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 

⚠️ Warning: Since all arguments are passed to claude, avoid using options that conflict with ccresume's functionality:

  • Don't use options like --resume or something like that changes claude's interactive behavior

Requirements

  • Node.js >= 16
  • Claude Code - Must be installed and configured
  • Operating System - Works on macOS, Linux, and Windows (with WSL)

Development

Setup

# Clone the repository
git clone https://github.com/yourusername/ccresume.git
cd ccresume

# Install dependencies
npm install

Available Scripts

# 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

Project Structure

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

Contributing

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

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Performance Considerations

  • 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

License

MIT

Support

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.

About

A CUI tool for browsing and resuming Claude Code conversations

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 96.2%
  • JavaScript 3.8%
0