Interactive TUI dashboard for Claude Code sessions - like tig for git, but for your AI pair programming history
npm install claudashBrowse your Claude Code session history like a pro



Quick Start β’ Features β’ Keybindings β’ Why?
---
Ever thought:
- "What was I working on with Claude yesterday?"
- "I had a great session where we fixed that bug... where is it?"
- "How much have I used Claude across my projects?"
Your Claude Code history is a goldmine of context, but buried in JSON files. Until now.
---
cld is an interactive terminal dashboard for Claude Code sessions. Think tig for git, but for your AI pair programming history.
``bash`
cld
Browse hundreds of sessions. Jump to any project. Never lose context again.
---
`bashInstall
npm install -g claudash
That's it. You're browsing your Claude history.
Basic usage:
-
β β or j k - Navigate sessions
- Enter or β - View session details
- c - Copy project path to clipboard
- q - Quit---
π¨ Features
$3
- Like tig, but for Claude Code - Browse sessions with vim keybindings
- Smart grouping - Sessions organized by project
- Color-coded recency - Green (today), yellow (this week), gray (older)
- Lightning fast - Handles 10,000+ sessions without breaking a sweat$3
- First & Last Messages - See how sessions started and where they ended
- Rich Statistics:
- Message counts (user/assistant)
- Tools used (Bash, Edit, Write, etc.)
- Token consumption
- Session duration
- Git branch & working directory$3
- Clipboard integration - Copy paths with c
- Vim navigation - j/k, g/G, all the classics
- Arrow key navigation - β/β to navigate views
- LRU caching - Smart memory management for blazing speed$3
TUI Mode (Default)
`bash
cld # Interactive dashboard
`List Mode (Quick overview)
`bash
cld --list # Text-based list
cld --list 20 # Show 20 projects
`---
π‘ Use Cases
$3
"What was I doing in that project last week?"
`bash
cld # Browse sessions
β # View session details
See first/last messages, remember context
`$3
"Need the path to that project I worked on"
`bash
cld # Launch
β β β # Navigate to project
c # Copy path to clipboard
Paste wherever you need it
`$3
"How much Claude usage across all projects?"
`bash
cld --list 50 # See top 50 projects
Total sessions, message counts, last active times
`$3
"I asked Claude something about OAuth... find that session"
`bash
cld # Browse by project
β # View details
Read first/last messages to find it
`---
π₯ Why cld?
$3
| Tool | Purpose | Command |
|------|---------|---------|
|
git log | View commits | Plain text list |
| tig | Browse commits | Interactive TUI β¨ |
| cld --list | View sessions | Plain text list |
| cld | Browse sessions | Interactive TUI β¨ |$3
- Package:
claudash - Searchable on npm
- Binary: cld - Fast to type (like rg, fd, git)
- Mnemonic: CLaude DashboardJust like
ripgrep β rg and fd-find β fd, we follow the pattern of memorable packages with short binaries.---
π¦ Installation
$3
`bash
npm install -g claudash
`$3
`bash
npx claudash
`$3
`bash
git clone https://github.com/claudash/claudash.git
cd claudash
npm install
npm link
cld
`---
β¨οΈ Keybindings
$3
| Key | Action |
|-----|--------|
|
β β j k | Navigate sessions |
| Enter / β | View session details |
| c | Copy project path to clipboard |
| g / G | Jump to top / bottom |
| PageUp / PageDown | Scroll faster |
| ? | Show help |
| q | Quit |$3
| Key | Action |
|-----|--------|
|
β β j k | Scroll content |
| g / G | Jump to top / bottom |
| β ESC q | Back to list |---
π― Example Output
$3
`
π Recent Claude Code Sessionsπ ~/ideas/claudeboard
Last active: 2m ago
Sessions: 2 | Messages: 11
Latest: "Implement the following plan: # claudash TUI Dashboard..."
π ~/ideas/timea
Last active: 23m ago
Sessions: 1 | Messages: 59
Latest: "follow the links here and do a comprehensive summary..."
π ~/remote/github.com/rgbjs/docs
Last active: 56m ago
Sessions: 1 | Messages: 61
Latest: "do deep research for rgb 0.12 and create technical docs..."
`$3
Interactive dashboard showing:
- β
Sessions grouped by project
- β
Color-coded by recency
- β
Vim-style navigation
- β
Detailed session view with stats
(GIF demo coming soon)
---
π οΈ Technical Details
$3
- Fast Indexing - Parses
~/.claude/history.jsonl in <500ms for 10,000 sessions
- Lazy Loading - Session details loaded on-demand
- LRU Cache - Keeps 100 most recent sessions in memory
- Cross-Platform - Linux, macOS, Windows clipboard support$3
Reads from
~/.claude/ directory:
- history.jsonl - Fast session index
- projects/[encoded-path]/[session-id].jsonl - Full session data$3
- blessed - Terminal UI framework (only runtime dependency)
- Node.js β₯ 14
---
πΊοΈ Roadmap
- [ ] Search/Filter - Find sessions by keyword
- [ ] Sort Options - By date, messages, tools used
- [ ] Session Export - Export to markdown/JSON
- [ ] Timeline View - See message history within session
- [ ] Stats Dashboard - Aggregate usage analytics
- [ ] Fuzzy Finder - fzf-style quick jump
- [ ] Session Diff - Compare sessions side-by-side
---
π€ Contributing
Contributions welcome! Here's how:
1. Fork & Clone
`bash
git fork https://github.com/claudash/claudash.git
cd claudash
npm install
`2. Make Changes
`bash
git checkout -b feature/amazing-feature
# Hack away
npm link # Test locally
`3. Submit PR
`bash
git commit -m "Add amazing feature"
git push origin feature/amazing-feature
# Open PR on GitHub
`$3
- π‘ Feature requests β Open an issue
- π Bug reports β Open an issue
- π Docs improvements β PRs appreciated!
---
π License
MIT Β© Melvin Carvalho
---
π Star History
If you find
cld` useful, consider giving it a star! βIt helps others discover the tool and motivates continued development.
---
- Inspired by tig - The text-mode interface for git
- Built with blessed - Terminal UI library
- Created for the Claude Code community
---
Made with β€οΈ for Claude Code users everywhere