Agent Board — AI skill for Claude Code

Agent Board

**English** · [Português](./README.pt-BR.md)

Local-first Kanban for delegating and tracking tasks given to AI agents. You interact through a visual board in the browser; agents interact through a CLI. Everything is stored locally in SQLite — no servers, no accounts.

Built from `SPEC.md` and the visual prototype in `Prototype-·-5_18_2026/`.

Stack

Layer	Tech
Frontend	Next.js 16 (App Router, React 19)
Backend	Next.js Server Actions + REST Route Handlers
Database	SQLite via Prisma 7 (@prisma/adapter-better-sqlite3)
Real-time	Server-Sent Events (/api/events)
CLI	Node script over the HTTP API (kanban)

Data lives at `~/.agent-kanban/data.db`.

Requirements

• Node.js >= 20.19 (Node 18 not supported by Prisma 7)
• npm

Install

# from the project directory
bash install.sh --local

The installer syncs the code to `~/.agent-kanban-app`, installs dependencies, generates the Prisma client, creates/syncs the database, seeds initial data **only if the DB is empty**, and links the `kanban` CLI globally.

Flags:

• --local [src] — install from a local checkout (default: current dir)
• --seed — force (re)seed even if data exists (overwrites)
• --no-link — skip the global kanban CLI link

Manual setup

npm install
npm run db:generate     # prisma generate
npm run db:push         # create/sync schema at ~/.agent-kanban/data.db
npm run db:seed         # initial data (PROJ-001 …)
npm run dev             # http://localhost:3000

Running

The transparent way — starts the server (if down) and opens the browser. Idempotent; works for a human **or** an AI agent:

kanban start            # start + open http://localhost:3000
kanban start --no-open  # start without opening a browser (agents)
kanban status