# 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.
## Attribution
`bmo` was inspired by and adapted from [docket](https://github.com/ALT-F4-LLC/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](https://claude.ai/claude-code), Anthropic's AI coding assistant. The repo owner directed this work.
## Installation
**From crates.io (recommended):**
```bash
cargo install bmo
```
**From source:**
```bash
cargo install --path .
```
**Pre-built binaries:**
Download the latest binary for your platform from [GitHub Releases](https://github.com/erewok/bmo/releases).
## Quickstart
```bash
bmo init
bmo issue create --title "First issue" --priority medium --kind task
bmo issue list
bmo board
bmo web
```
## Documentation
- [docs/commands.md](docs/commands.md) — Complete command reference
- [docs/agents.md](docs/agents.md) — Integration guide for AI agents
- [docs/web.md](docs/web.md) — Web interface
- [docs/data.md](docs/data.md) — Data storage and database location
- [docs/migration-from-docket.md](docs/migration-from-docket.md) — Migrating from docket
- [docs/development.md](docs/development.md) — Building and running tests
## License
Apache-2.0. See [LICENSE](LICENSE) file.
`bmo` was inspired by [docket](https://github.com/ALT-F4-LLC/docket) by **ALT-F4-LLC**. Please credit that project for the ideas in this project.