Source Code

PikaBoard

Agent-first task/kanban dashboard. PikaBoard is the source of truth for tasks.

Quick Start

After install, start the server:

cd pikaboard/backend && npm start

Access dashboard at http://localhost:3001

Configuration

Create backend/.env:

DATABASE_PATH=./pikaboard.db
API_TOKEN=your-secret-token
PORT=3001

Add to your TOOLS.md:

## PikaBoard
- **API:** http://localhost:3001/api/
- **Token:** your-secret-token

Task Commands

Reference tasks by ID:

task 12 or #12 → view task
move #12 to done → status change
create task "Fix bug" → new task

API Reference

See references/api.md for full endpoint documentation.

Common Operations

List tasks:

curl -H "Authorization: Bearer $TOKEN" $API/tasks

Create task:

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Fix bug","status":"inbox","priority":"high"}' \
  $API/tasks

Update status:

curl -X PATCH -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status":"done"}' \
  $API/tasks/123

Enums

Field	Values
status	`inbox`, `up_next`, `in_progress`, `in_review`, `done`
priority	`low`, `medium`, `high`, `urgent`

Multi-Agent Setup

Each agent can have their own board. Use board_id parameter:

curl "$API/tasks?board_id=6" -H "Authorization: Bearer $TOKEN"

Board assignments:

Board 1: Pika (main)
Board 2: Tortoise (personal)
Board 3: Sala (work)
Board 4: Evoli (VirtualPyTest)
Board 5: Psykokwak (EZPlanning)
Board 6: Bulbi (PikaBoard)
Board 7: Mew (Ideas)