CrewDeck

Visual dashboard to manage your Claude Code agents — local-first with secure tunnel access.

CrewDeck gives you a web-based command center for all your Claude Code agents. Launch agents, assign tasks, chat in real-time, and capture ideas — all from a clean dashboard accessible locally or remotely via your phone.

Features

• Project Dashboard — Scan your git repos, see all projects at a glance with agent status
• Agent Management — Spawn, monitor, and stop Claude Code agents per project
• Live Streaming — Real-time SSE output from agents with color-coded events
• Task Board — Create tasks, assign them to agents, track progress (pending → in progress → done)
• Ideas Inbox — Capture ideas via the UI (Ctrl+I) or terminal (crewdeck idea "..."), convert to tasks
• Secure Tunnel — Access your dashboard from your phone via Cloudflare Tunnel with token auth + QR code
• CLI Tools — crewdeck status, crewdeck tasks, crewdeck idea for quick terminal access
• Local-first — Everything runs on your machine. SQLite database, no cloud dependency

Requirements

• Node.js 22+
• An active Claude Code subscription (Pro or Max)

Quick Start

npx crewdeck

This will:

1. Start the dashboard server on http://localhost:4200
2. Open your browser automatically
3. Scan for git projects in the current directory

Installation

npm install -g crewdeck

Usage

Launch the dashboard

crewdeck                    # Start on port 4200
crewdeck -p 3000            # Custom port
crewdeck --tunnel           # Enable remote access with QR code
crewdeck --no-open          # Don't open browser

CLI commands

crewdeck idea "Fix the auth bug"    # Capture an idea
crewdeck status                      # Show projects/agents summary
crewdeck tasks                       # List tasks by project
crewdeck --help                      # Full help

Remote access

crewdeck --tunnel

This creates a secure Cloudflare Tunnel with a one-time access token. A QR code is displayed in the terminal — scan it with your phone to access the dashboard remotely.

Tech Stack

| Layer | Technology | |-------|-----------| | Runtime | Node.js 22+ | | Backend | Hono (lightweight HTTP server) | | Frontend | Next.js (static export) + React 19 + Tailwind CSS 4 | | Database | SQLite (better-sqlite3 + drizzle-orm) | | Agents | @anthropic-ai/claude-agent-sdk | | Tunnel | cloudflared | | Animations | Framer Motion |

Development

git clone https://github.com/ThomasMeb/crewdeck
cd crewdeck
npm install
npm run build       # Build backend + frontend
npm run dev         # Dev mode with watch
npm run lint        # TypeScript check

License

MIT