Pre-alpha: Squadboard is under active development. Sharp edges, breaking changes, and incomplete flows ahead. Keep humans in the review loop.
Squadboard is the visual command center for Squad AI agents — built on top of Squad, not instead of it.
- Durable workflows — workflows that survive, are tracked, and can be resumed across sessions
- Live visualization — see all your agent work in one place, with real-time run tracking and board state
- Project templates — Squadboard apps and project templates that give agents structure and context
- App extensibility — apps that run on top of Squadboard to extend capabilities
Squad handles agent orchestration. Squadboard gives it a home — a live board where every run, workflow, and project is visible, trackable, and resumable. Without Squad, Squadboard is empty. With Squad, it's where your agent work lives.
Cast a Squad team onto a project using the Default Software Project template, then create the first backlog card.
Move the card to Ready, watch the Work Pickup ceremony assign it to an agent, follow the live agent run, see the Simple Review ceremony trigger automatically on completion, and watch the card land in Done with the Scribe ceremony wrapping things up.
Connect an existing project folder to Squadboard via the "Connect existing" flow, land on the board, then navigate to Settings → Squad Sync to wire up the Copilot CLI integration.
If you have Squad agents running, connect them to Squadboard:
-
Install Squadboard — Download from GitHub Releases, or via CLI:
npx @sabbour/squadboard-cli init
-
Connect to the board — Wire up MCP so Copilot CLI can talk to Squadboard:
squadboard connect
-
Launch the UI — Open Squadboard at
http://localhost:5173:squadboard start
(or use the desktop app if you downloaded it)
-
Run an agent from the CLI and watch it on the board:
squad run --workflow my-workflow
The run will stream to Squadboard in real-time.
-
From the UI, drag cards through columns to manage work, and click into runs to see live output.
-
Download Squadboard — Grab the desktop app from GitHub Releases for your platform:
- macOS:
Squadboard-*.dmg - Windows:
Squadboard-Setup-*.exe - Linux:
Squadboard-*.AppImage
Or use CLI:
npx @sabbour/squadboard-cli init
- macOS:
-
Launch — The desktop app or web UI opens automatically at
http://localhost:5173. -
Create your first project and board — Use the UI to set up a new board.
-
Install Squad CLI to unlock agent execution:
npx @bradygaster/squad-cli init
-
Connect Squadboard and Squad:
squadboard connect
-
Run your first agent from the CLI and watch it flow onto the board:
squad run --workflow my-workflow
| Capability | What it does |
|---|---|
| Durable workflows | Workflows survive across sessions, tracked and resumable |
| Live visualization | Board view with real-time agent output, all work in one place |
| Project templates | Squadboard apps and templates that structure agent work |
| Live run viewer | Stream agent output in real-time, step by step |
| Ceremonies | Optional versioned, auditable workflow automations (code review, bug fix, RFC) |
| Squad sync | State flows bidirectionally between board and .squad/ files |
| MCP broker | Connect Copilot CLI, VS Code, or any MCP client — agents can read/write the board |
| Zero setup | Embedded PGlite (WASM Postgres) — no Docker, no cloud account |
| GitHub sync | Link a repo → issues and PRs flow in automatically |
Full docs → sabbour.me/squadboard
- Getting Started
- MCP Installation & Configuration
- REST API Reference
- WebSocket Protocol
- Ceremonies Guide
- Squad Apps
Squadboard is built with pnpm workspaces. The repo contains:
| Package | Role |
|---|---|
packages/server |
Express + WebSocket API, PGlite, MCP server |
packages/client |
React + Fluent 2 UI |
packages/cli |
squadboard CLI (init, mcp, start) |
packages/docs-site |
Docusaurus docs at http://localhost:3002 |
pnpm test # unit tests
pnpm test:e2e # Playwright E2E (starts dev server automatically)
pnpm build # production buildMIT