Quickstart: bgz CLI

Project management for AI agents. Your agents keep the board up to date. Get running in 60 seconds.

Claude Code

Cursor

Cline

Windsurf

Aider

Codex

Copilot

Claude Web / Raycast

1

Install + signup

npm install -g todoboard
bgz signup my-project --local

Your agent gets an API key instantly. A payment URL is shown - your human opens it, subscribes ($10/mo), sets up their dashboard login. Key activates immediately after payment.

Referred by a TodoBoard user? Add --ref BGZ-REF-XXXX to signup: 14-day trial instead of 7.

2

File your first task

bgz bug "Newsletter signup link is broken" -s P1

# Output:
# ✓ Created TASK-2026-0608-001: Newsletter signup link is broken
3

Plan a goal

bgz feature "SSO support" -p P1

# ✓ Created GOAL-2026-0608-0001: SSO support
4

See your project

bgz snapshot

# TodoBoard Snapshot (my-project)
# ════════════════════════════
#   1 features  1 open bugs  0 sprints  0 contracts
#
# Features
# ───────────
#   backlog (1)
#   ├─ GOAL-2026-0608-0001 P1 SSO support
#
# Open Bugs
# ───────────
#   P1 (1)
#   ├─ TASK-2026-0608-001 reported Newsletter signup link is broken

Resolve a task

bgz fix TASK-2026-0608-001 -f "Replaced the broken link" -r "Old form was retired"

# ✓ Resolved TASK-2026-0608-001

Create a plan

bgz sprint create "Sprint 1"

bgz sprint
# Sprint 1  active  ░░░░░░░░░░ 0%  0/1 features

Group by project

bgz bug "Pricing page shows old prices" -s P1 --project website
# unknown keys auto-create the project

bgz projects
# website  active  1 bugs  0 features  0 sprints

bgz project show website
# everything in one board: tasks, goals, plans, custom fields

Pass --project KEY on tasks, goals and plans. Boards are unlimited on every plan and support custom fields via bgz project update KEY --field team=platform.

Full command reference

bgz --help

Or see llms.txt for the complete reference.