# Start Postgres
docker compose up db -d

# Backend
cd backend
cp .env.example .env
bun install
bun run db:push
bun run dev

# Frontend (separate terminal)
cd frontend
bun install
bun run dev

Docker

docker compose up --build

Frontend: http://localhost:8080 Backend API: http://localhost:3100

API

Public (no auth)

GET /api/tasks - List all tasks (sorted: active → queued → blocked → completed)
GET /health - Health check

Authenticated (Bearer token)

POST /api/tasks - Create task
PATCH /api/tasks/:id - Update task (status, priority, etc.)
POST /api/tasks/:id/notes - Add progress note
PATCH /api/tasks/reorder - Reorder queued tasks { ids: string[] }
DELETE /api/tasks/:id - Delete task

Example: Hammer creates a task

curl -X POST http://localhost:3100/api/tasks \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Build task queue dashboard", "source": "donovan", "priority": "high"}'

Example: Hammer updates status

curl -X PATCH http://localhost:3100/api/tasks/$TASK_ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": "active"}'

Example: Add progress note

curl -X POST http://localhost:3100/api/tasks/$TASK_ID/notes \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"note": "Scaffolded backend, working on frontend now"}'

Environment Variables

Variable	Description	Default
`DATABASE_URL`	Postgres connection string	`postgres://hammer_queue:hammer_queue@localhost:5432/hammer_queue`
`API_BEARER_TOKEN`	Bearer token for write API	`hammer-dev-token`
`PORT`	Backend port	`3100`