Skip to main content

​
A project board that lives with the code

Octobots is a VS Code extension for planning and running AI coding work. It turns a repository’s .octobots/ directory into a project board made of campaigns, missions, tasks, bugs, and workflows. There is no database or separate server. The YAML files are the board, making plans diffable, reviewable, portable across machines, and accessible to both people and CLI agents.
Octobots campaign tree, mission acceptance criteria, workflow gates, and mission signals

Campaigns, acceptance criteria, workflow gates, architecture signals, and cost stay visible together.

The public repository is currently named octoshell, while the product and README use the name Octobots. This page follows the product name and links to the existing repository.

View the repository

Explore the VS Code extension, board model, workflows, architecture graph, and tokenomics packages.

Read the project guide

Learn how campaigns, missions, tasks, workflows, and agent gates fit together.

​
What it provides

Durable plans

Campaigns, missions, tasks, bugs, and attached documents remain in the repository instead of a temporary chat transcript.

Acceptance criteria

Every task carries a checkable definition of done that planning, QA, review, and completion gates can enforce.

Agent workflows

Install skills and hooks that let CLI agents plan work, execute tasks, record provenance, and run completion gates.

Architecture and cost insight

Octograph finds files that change together, while Tokenomics reports tokens, cost, turns, and activity per mission.

​
Board structure

Because children are derived from folders and status belongs to each entity, multiple agents can add or update separate work without rewriting a shared index.