board

# BOARD — shared task board `BOARD.md` lives at the workspace root. Every active agent (`nova`, `kitty`, `cody`, `pi`, `codex`) and Val read and write to it. The activity log at the bottom is **append-only** — never rewrite it. Use the `bin/board` CLI instead of editing the file directly. It preserves the schema, restamps timestamps, and writes a matching activity-log row for every mutation. ## When to use - Proposing a new task → `board add` - Picking up someone else's task → `board claim` - Finishing work that's on the board → `board done` - Checking what's active before starting work → `board list` - Auditing recent agent activity → `board log` ## When NOT to use - One-off TODOs that only matter to your current session → use the conversation's todo tool, not BOARD.md - Long-form reflection / dream entries → `DREAMS.md` - Repo-specific implementation plans → `plans/{org}/{repo}/<file>.md` ## Commands ```bash # show one section (or all) board list board list today # add a task to a section board add today "Move demo script to plans/" --agent nova --ctx "It's at workspace root after demo." # reassign a task's "by" agent board claim "demo script" --agent kitty # flip checkbox to done, move to "Done this week", log it board done "demo script" --agent kitty # tail the activity log (default 10 rows, newest first) board log board log -n 30 ``` ## Agent identity The `--agent` flag wins. If absent, the CLI reads `$OPENCLAW_AGENT`. If that's also unset, it defaults to `...