claudpit
v1.0.0
Published
Dashboard for monitoring Claude Code sessions
Readme
claudpit
A terminal dashboard for monitoring active Claude Code sessions in real-time.
Features
- Live session monitoring — auto-refreshing table of all Claude Code sessions on your machine
- Smart status detection — determines whether each session is running, waiting, idle, or inactive by analyzing session logs and process state
- Rich session info — shows project name, git branch, status, time since last activity, and message count
- Project detection — resolves project names from
package.json,Cargo.toml,pyproject.toml,go.mod, and Gradle configs - Keyboard shortcuts — press
qto quit,ito toggle inactive sessions
Prerequisites
- Node.js 18+
- Claude Code installed
- macOS or Linux
Installation
npm install -g claudpitUsage
claudpitStatus Indicators
| Indicator | Status | Meaning | |-----------|--------|---------| | 🟢 | Running | Claude is actively processing | | 🟡 | Waiting | Tool calls pending resolution | | 🔵 | Idle | Session completed work but remains active | | 🔴 | Inactive | Session process is no longer running |
Keyboard Shortcuts
| Key | Action |
|-----|--------|
| q | Quit |
| i | Toggle inactive sessions |
Development
git clone https://github.com/eshaham/claudpit.git
cd claudpit
npm installScripts
| Command | Description |
|---------|-------------|
| npm run dev | Start in development mode with live reload |
| npm run dummy | Launch with dummy data (no real sessions needed) |
| npm run build | Compile TypeScript to dist/ |
| npm run lint | Run ESLint |
| npm run lint:fix | Run ESLint with auto-fix |
| npm run format | Format source files with Prettier |
| npm run format:check | Check formatting without writing |
Contributing
Contributions are welcome! Here's how to get started:
- Fork the repository
- Create a branch for your change
- Make your changes
- Run
npm run lintandnpm run formatto ensure code quality - Open a pull request
Pre-commit hooks will automatically run Prettier, ESLint, and TypeScript type checking on staged files.
