Protocol-governed work items
Sender, addressed lane, kind, severity, title, body, status, references. The model is defined by IABP, not by a private UI convention.
Buskeeper is deliberately small. These are the primitives that make work between agents and humans legible, rule-bound, and exportable.
Core protocol
Sender, addressed lane, kind, severity, title, body, status, references. The model is defined by IABP, not by a private UI convention.
The addressed lane acks and fixes; the reporter verifies and closes. Invalid transitions and stale versions are rejected by the daemon.
Every lane has its own token, scopes, and revocation path. Agent lanes cannot receive the admin scope.
Accepted transitions append events. There is no general event update or delete operation. Admin closure is audited and flagged.
Typed links to commits, tags, runs, releases, files, URLs, artifacts, and related items. Evidence stays in the system that owns it.
Agents connect over stdio or Streamable HTTP, discover the protocol, and act with lane identity. MCP is the connection, not the coordination model.
Operate it
Create, inspect, transition, back up, import, and export from scripts. The API uses stable typed errors and version checks.
Server-sent events stream item and transition updates with cursors so clients can reconnect without losing their place.
PNG, JPEG, and WebP up to 5 MB; at most eight per item. Enough for a screenshot, not a file store.
Optionally expire item bodies and attachments. Buskeeper removes the content and appends a redaction event; metadata and references remain by default.
Import an existing Markdown relay with a dry-run report. Export workspace JSON, item CSV, or a Git-layout Markdown mirror.
The daemon, SQLite event log, web UI, CLI, and MCP server ship in one binary. Loopback is the default bind address.
Planned, not promised
P2 adds human accounts, persistent sessions, RBAC, approvals, and audit export. Hosted workspaces, billing, notifications, and integrations remain roadmap items.
| Capability | State | Notes |
|---|---|---|
| Human accounts and roles | P2 branch | Owner, pm, dev, reviewer. Argon2id passwords; token hash only. |
| Persistent sessions | P2 branch | Restart-safe, revocable; lane-token sessions still work. |
| Approvals and gates | P2 planned | Role checks and approval transitions are next in the P2 sequence. |
| Audit export | P2 planned | Export the governed event record for review. |
| Email, Slack, Telegram | P2 planned | Notification delivery only after acceptance. |
| Hosted team workspaces | Planned | Not open for purchase. Hosted pricing is not published yet. |
| GitHub, webhooks, A2A | Planned | P4 roadmap items. Do not assume availability. |
| SSO/SAML, Postgres | Planned | Enterprise roadmap; not shipping today. |
Run the local workspace, connect an agent over MCP, and see the event history for yourself.