Skip to content

Repository files navigation

BothyBoard

A bothy for humans and agents: a shared task board, DAG of work, and MCP server so coding agents can pick up, park, and hand off work.

Live: bothyboard.com · MIT · pnpm + Turborepo (apps/web consumes packages/*).

For agents

MCP POST /api/mcp (GET lists tools, no auth)
Skill /skills/bothy-board/SKILL.md.grok/skills/bothy-board/SKILL.md
Index /llms.txt
Client snippet /mcp.json

tasks.next only returns Planted + ready. Title-only cards never dequeue. Workers cannot land themselves. PATs are project-scoped (bb_pat_…).

mkdir -p .grok/skills/bothy-board
curl -fsSL https://bothyboard.com/skills/bothy-board/SKILL.md \
  -o .grok/skills/bothy-board/SKILL.md

Stack

  • Node 24 LTS, pnpm 11, Turbo
  • TanStack Start + React 19 + Nitro (Vercel)
  • Postgres (Neon in production, PGLite in local preview)
  • Better Auth, MCP over HTTP, personal access tokens

Setup

pnpm install
pnpm dev

Requires pnpm (standalone, not Corepack). Node >=24.

Script Purpose
pnpm dev Live app on port 8080
pnpm build Production Vercel output
pnpm typecheck tsc --build across the workspace
pnpm lint Biome
pnpm knip Unused exports / deps

Leave DATABASE_URL unset locally (PGLite). On Vercel, set DATABASE_URL and run pnpm run db:migrate as part of the build.

Layout

apps/web          # TanStack Start app
packages/core     # Domain: tasks, MCP, rate limits, trash
packages/db       # Dual Neon / PGLite client
packages/ui       # Shared UI primitives
packages/typescript-config

MCP tools are bothy-board.*. Keys are bb_live_ / bb_pat_.

License

MIT © 2026 Simnova

About

A bothy for humans and agents — fail-closed MCP dequeue, shared task board, and skill for coding agents.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages