Plan and track AI coding work as markdown boards — campaigns, missions, tasks and bugs — right inside VS Code, and install an Octobots pack that teaches CLI coding agents (Claude Code, Codex, Copilot) to drive them.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Plan and track AI coding work as plain‑markdown boards — campaigns → missions → tasks, plus
bugs — right inside VS Code. Octobots turns a workspace's .octobots/ directory into a living
project board with no database and no server: the markdown files on disk are the single source
of truth, so your plan is diffable, reviewable in pull requests, and safe for multiple agents (and
humans) to edit at the same time.
It also installs an Octobots pack that teaches CLI coding agents — Claude Code, OpenAI Codex,
GitHub Copilot CLI — how to read and drive the very same board.
Features
Board editor in the sidebar. Browse campaigns, missions, tasks, and bugs from the Octobots
activity‑bar view; open any item in its own editor tab.
Status, acceptance criteria, and docs. Set statuses from dropdowns, manage a task's
acceptance‑criteria checklist, and attach documents.
Disk is authoritative. Every change is written to markdown and the board is rebuilt from
disk. A single debounced, git‑aware watcher keeps the UI in sync through
git checkout / stash / rebase without churn.
Octobots pack installer. One command drops the Octobots skills (mission-planner,
mission-execution, mission-completion-gate, knowledge-explorer, octobots-doctor) and session hooks
into the workspace so your CLI agents understand the board model. Skills, the graph payload and
the hook registration go under .claude; hook scripts go to .octobots/hooks and tokenomics to
.octobots/tokenomics. Skills you changed locally are staged for an agent to merge rather than overwritten.
Getting started
Install the extension and open a folder (Octobots operates on the open workspace folder).
Open the Octobots view from the activity bar.
Create a campaign, then add missions and tasks under it. Every task gets at least
one acceptance criterion.
(Optional) Run “Octobots: Install Octobots Pack” from the Command Palette to let your CLI
coding agents drive the board too.
How the board is organized
Entity
What it is
Id
Campaign
Top‑level body of work; contains missions.
—
Mission
A milestone‑sized initiative; contains tasks.
M<n>
Task
The unit of execution; carries ≥1 acceptance criterion.
T<missionN>.<taskN>
Bug
A defect attached to a campaign or mission, with a severity.
—
Each item has a status: draft → executing → awaitingApproval → done, plus failed and
cancelled. The board lives as markdown under .octobots/, so it travels with your repo and shows
up in normal git diffs.
Commands
Octobots: New Campaign
Octobots: New Mission in this Campaign
Octobots: Install Octobots Pack
Octobots: Doctor
… plus per‑item status and delete actions in the tree context menus.
