Why Agent Board?¶
The Problem¶
Modern AI-assisted development workflows rely on:
- Chat-based copilots — powerful but stateless, you drive every step manually
- Terminal-based agents — run once, no visibility into progress, no persistent task tracking
- Issue trackers + manual handoff — context lost between planning, implementation, and review
- Multiple disconnected tools — switch between IDE, browser, terminal, and chat for every task
None of these give you a visual, persistent board where AI agents autonomously move tasks from idea to merged code — all inside your editor.
What Makes Agent Board Different¶
| Capability | Agent Board | Chat Copilot | Terminal Agents | Issue Trackers |
|---|---|---|---|---|
| Visual task board | Kanban in VS Code | Browser only | ||
| Autonomous workflow | Agents drive stages | Manual prompts | Single run | |
| Multi-agent collaboration | Planner + Developer + Reviewer | |||
| Multi-backend support | Copilot, Claude, Cline | Single provider | Single provider | N/A |
| Persistent state | Markdown + YAML | Session only | ||
| Configurable workflow | YAML-defined stages | |||
| Code review loop | Built-in agent review | Separate tool | ||
| Lives in the IDE | VS Code native | Terminal | Browser | |
| Setup time | ~2 minutes | Built-in | Varies | N/A |
| Cost | Free (open-source, MIT) | Subscription | Varies | Varies |
Deep Dive: Autonomous Workflow — From Idea to Merged Code¶
With chat copilots, you are the orchestrator — copy-pasting context, deciding what to do next, manually triggering each step.
With Agent Board, you describe the task and agents handle the rest:
- Drop a task into the board
- A Planner agent breaks it into implementation steps
- A Developer agent writes the code
- A Reviewer agent checks quality and requests changes
- Approved tasks are ready to merge
All transitions happen automatically based on agent decisions, with full visibility on the kanban board.
flowchart LR
Idea["💡 Idea"] --> Planning["📋 Planning<br/>(Planner Agent)"]
Planning --> Implementation["🔨 Implementation<br/>(Developer Agent)"]
Implementation --> Review["🔍 Review<br/>(Reviewer Agent)"]
Review -->|"Approved"| Done["✅ Done"]
Review -->|"Changes requested"| Implementation
What Makes It Unique¶
- Visual progress — see every task's status at a glance on the kanban board
- Agent decisions — agents parse structured decisions (approve, request changes, needs clarification) and act on them
- Feedback loops — reviewers can send tasks back with specific feedback; developers iterate automatically
- Configurable stages — define your own workflow in
board.yaml— add QA, staging, or any custom stage - Persistent state — every task is a Markdown file in
.tasks/with YAML frontmatter, version-controlled alongside your code - Multi-backend — swap between Copilot, Claude CLI, or Cline without changing your workflow
Deep Dive: Multi-Backend Architecture — Your Agent, Your Choice¶
Most AI tools lock you into a single provider. Agent Board is backend-agnostic by design.
Three Backends, One Workflow¶
graph TB
subgraph "Agent Board"
Board["Kanban Board<br/>(Vue 3)"]
Host["Extension Host"]
Registry["Backend Registry"]
end
Registry -->|"VS Code LM API"| Copilot["GitHub Copilot"]
Registry -->|"CLI subprocess"| Claude["Claude CLI"]
Registry -->|"Extension API"| Cline["Cline Extension"]
| Backend | Best For | How It Works |
|---|---|---|
| GitHub Copilot | Zero-config, already installed | Uses VS Code Language Model API directly |
| Claude CLI | Power users, long-context tasks | Spawns claude as a subprocess with structured output |
| Cline | Custom prompts, existing Cline workflows | Communicates via the Cline extension API |
Switch backends per task or globally — the workflow stays the same.
The Bottom Line
Agent Board doesn't force a provider choice. Use Copilot for quick tasks, Claude for complex refactors, and Cline for specialized workflows — all from the same board.
Deep Dive: Configurable Workflow — Your Process, Your Stages¶
Default workflows won't fit every team. Agent Board lets you define your own pipeline in board.yaml:
workflow:
stages:
- id: backlog
label: Backlog
- id: design
label: Design Review
- id: implementation
label: Implementation
- id: qa
label: QA Testing
- id: staging
label: Staging
- id: done
label: Done
transitions:
- from: backlog
to: design
label: Start Design
- from: design
to: implementation
label: Approved
- from: implementation
to: qa
label: Submit for QA
- from: qa
to: staging
label: QA Passed
effects: [notify]
- from: qa
to: implementation
label: QA Failed
- from: staging
to: done
label: Ship It
effects: [notify, archive]
5 minutes to match your team's process — not weeks of tool customisation.
Workflow Configuration Guide →
Ideal Use Cases¶
Solo Developers¶
Let agents handle the boring parts — planning, boilerplate, code review — while you focus on architecture and creative decisions.
Feature Development¶
Describe a feature, watch agents plan, implement, and review it. Iterate via the feedback loop until quality matches your standards.
Bug Fixing¶
Drop a bug report on the board. Agents analyse the issue, propose a fix, implement it, and self-review before you merge.
Learning & Exploration¶
Use the board to explore unfamiliar codebases. Agents explain, refactor, and document — with every step visible on the board.
What You Get Out of the Box¶
- Kanban board — drag-and-drop tasks across configurable stages, all inside VS Code
- Multi-agent orchestration — Planner, Developer, and Reviewer agents collaborate automatically
- Three AI backends — GitHub Copilot, Claude CLI, Cline — switch anytime
- Persistent tasks — Markdown files with YAML frontmatter in
.tasks/, version-controlled - Configurable workflow — define stages, transitions, and effects in
board.yaml - Agent feedback loops — structured decisions drive automatic transitions and iterations
- Comment threads — discuss tasks with agents and team members
- Git integration — workspace scanning, branch awareness, diff context
- YAML settings — board-level configuration without touching code
- Full type safety — TypeScript throughout, shared protocol types between host and webview
Open Source & Extensible¶
Agent Board is licensed under MIT. You can:
- Define custom workflows that match your team's process
- Switch between AI backends depending on the task
- Extend the agent configuration with custom skills and prompts
- Fork, modify, and self-host with zero restrictions
Getting Started
Ready to try it? Follow the Installation Guide to have Agent Board running in under 2 minutes.