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. The design, data model, and command structure of BMO all owe a direct debt to that project, and all credit for the underlying ideas belongs there.

In addition, the code in this repository was written by Claude Code, Anthropic's AI coding assistant. The repo owner directed this work.

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 issue create --title "First issue" --priority medium --kind task
bmo issue list
bmo board
bmo web

Documentation

• docs/commands.md — Complete command reference
• docs/agents.md — Integration guide for AI agents
• docs/web.md — Web interface
• docs/data.md — Data storage and database location
• docs/migration-from-docket.md — Migrating from docket
• docs/development.md — Building and running tests

License

Apache-2.0. See LICENSE file.

bmo was inspired by docket by ALT-F4-LLC. Please credit that project for the ideas in this project.