bmo

bmo is a local-first command-line issue tracker backed by a single SQLite file, designed for use by both human developers and AI agents operating in a terminal. It requires no server, no network dependency, and no external services. Issues are identified by BMO-N IDs.

For an example of agents and skills that have been instructed to use bmo check out the bmo-agent-setup project (no need to run the program: the agents and skills are plain markdown files).

Attribution

bmo was inspired by and adapted from docket, an issue tracker for AI agents written by ALT-F4-LLC.

In addition, the code in this repository was written by repo contributors with significant contributions from Claude Code.

Installation

From crates.io (recommended):

cargo install bmo

From source:

cargo install --path .

Pre-built binaries:

Download the latest binary for your platform from GitHub Releases.

Quickstart

bmo init
bmo create --title "First issue" --priority medium --kind task
bmo list
bmo board
bmo web

Combine filters with comma-separated values; alternatively, repeat the flag for each value:

bmo ls --parent 1,2,3 -k epic,bug

This lists descendants of any of those parents whose kind is epic or bug. See the command reference for supported options and matching rules.

pi-code Integration

If you use pi-code, the pi-bmo extension integrates bmo natively into pi. This extension adds typed bmo_* tools that the LLM calls directly, in addition to a live board status widget, board state injected into every agent turn's context, and /board /next /plan slash commands.

pi install git:github.com/erewok/pi-bmo

A companion pi-code extension, bmo-dev-team, adds a full software development team of agents (staff-engineer, project-manager, senior-engineer, qa-engineer, ux-designer) that plans and executes work through bmo.

pi install git:github.com/erewok/bmo-agent-setup

See docs/pi-extension.md for the full integration guide.

Documentation

• docs/commands.md — Complete command reference
• docs/agents.md — Integration guide for AI agents
• docs/pi-extension.md — pi-code extension and dev-team suite
• docs/web.md — Web interface
• docs/data.md — Data storage and database location
• docs/development.md — Building and running tests

License

Apache-2.0. See LICENSE file.