https://github.com/lucasvtiradentes/better-claude-code
🤖 Toolkit to view, analyze and compact Claude Code sessions across projects. Available as CLI tool and VS Code extension.
https://github.com/lucasvtiradentes/better-claude-code
claude-code cli vscode-extension
Last synced: 3 months ago
JSON representation
🤖 Toolkit to view, analyze and compact Claude Code sessions across projects. Available as CLI tool and VS Code extension.
- Host: GitHub
- URL: https://github.com/lucasvtiradentes/better-claude-code
- Owner: lucasvtiradentes
- License: mit
- Created: 2025-11-02T05:41:21.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-11-17T12:24:54.000Z (3 months ago)
- Last Synced: 2025-11-17T14:26:19.389Z (3 months ago)
- Topics: claude-code, cli, vscode-extension
- Language: TypeScript
- Homepage:
- Size: 2.07 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## 🎺 Overview
Toolkit to view, analyze and compact Claude Code sessions across projects. Available as CLI tool and VS Code extension.
## ❓ Motivation
I was using Claude Code heavily for complex problems but disliked the native session compaction as it lost too much context. So I built this to run custom compaction prompts and continue work across sessions without losing track of where we were.
## ⭐ Features
- **Session Compaction** - Parse and summarize Claude Code sessions with AI
- **Web Dashboard** - Full UI for session analysis
- **VS Code Integration** - Native extension for managing sessions in your editor
- **Multi-project Support** - Track sessions across all your Claude Code projects
- **Custom Labels** - Organize sessions and projects with color-coded tags
- **Filtering** - Filter by date, tokens, labels, and content type
- **Real-time Updates** - File system watching for instant session detection
- **Git Integration** - Automatic project discovery with repository info
## 📦 Distributions
BCC is distributed in two forms:
### CLI Tool
Command-line interface for session management and web server control.
- **Package**: [`better-claude-code`](https://www.npmjs.com/package/better-claude-code)
- **Installation**: `npm install -g better-claude-code`
- **Binary**: `bcc`
- **Documentation**: [CLI README](./apps/cli/README.md)
### VS Code Extension
Native VS Code extension for editor integration.
- **Vscode extension**: [`better-claude-code-vscode`](https://marketplace.visualstudio.com/items?itemName=lucasvtiradentes.better-claude-code-vscode)
- **Installation**: Search "Better Claude Code" in VS Code Extensions
- **Documentation**: [Extension README](./apps/vscode-extension/README.md)
## 🚀 Quick Start
**CLI Quick Start:**
```bash
npm install -g better-claude-code
bcc server start # Launch web dashboard
bcc compact --latest # Summarize latest session
```
**VS Code Quick Start:**
1. Install extension from marketplace
2. Click BCC icon in activity bar
3. Browse sessions, right-click to compact
## 🔧 Development
```bash
pnpm install # Install dependencies
pnpm run dev # Start backend + frontend
pnpm run dev:cli # CLI development mode
pnpm run build # Build all packages
pnpm run typecheck # Type checking
pnpm run lint # Linting
pnpm run format # Code formatting
```
## 📜 License
MIT License - see [LICENSE](LICENSE) file for details.
