hivescan
v0.1.0
Published
Web-based terminal dashboard for managing Claude Code agents in a monorepo
Maintainers
Readme
hivescan
Web-based terminal dashboard for managing multiple Claude Code agents across your projects.
Quick Start
npx hivescanOr install globally:
npm install -g hivescan
hivescanHiveScan will scan your current directory for projects, start a local dashboard, and open it in your browser.
Requirements
- Node.js 18+
- Claude Code installed and available in your PATH
- macOS or Linux
Usage
hivescan # Scan current directory for projects
hivescan --dir ~/Sites # Scan a specific directory
hivescan --dir ~/work --dir ~/oss # Scan multiple directories
hivescan --port 5000 # Use a custom port (default: 4269)
hivescan --poll 10 # Port scan interval in seconds (default: 5)
hivescan --no-open # Don't open browser automaticallyHow It Works
- Scans directory children for projects (
package.jsonor.git) - Shows all discovered projects in a single dashboard UI
- Start/stop Claude Code agents per project with one click
- Streams live terminal output via WebSocket + xterm.js
- Polls for active dev server ports and links them in the UI
- Persists terminal history across restarts (
~/.hive/)
Features
- Real-time terminal streaming with xterm.js
- Model selection (Opus, Sonnet, Haiku)
- Status indicators (Thinking / Waiting / Idle / Stopped)
- Dark/light theme toggle
- Keyboard shortcuts (
Alt+1-9to switch projects) - Dev server preview panel
- Claude Code permission management
- Session persistence across restarts
License
MIT
