docs

Packages

The @broject/* package map — what to install, what stays internal.

bro is a toolkit. The CLI (@broject/bro) is the current starting point, not the only product surface: skills carry policy, portable agent plugins carry bro into clients, and brouter routes tasks to configured agents through user-authored Markdown formulas. Use bro router or install @broject/brouter independently. bro stays the core; everything else is a connector.

The marketplace is generated from each public package's bro metadata (kind, status, optional facade). It groups connectors by facade and lists capabilities and core separately. Private packages are excluded; each entry carries its catalog status and links to its source.

See the toolkit hub for the four product surfaces. The table below is a quick guide, not the complete catalog.

Install this

PackageWhat it is
@broject/broThe CLI. npx @broject/bro --help — this is all most people need.

Build on these

PackageWhat it carries
@broject/coregh/git/bd wrappers, config + TOML parsing, the plugin contract, doc verbs, task store
@broject/actPR review gate — threads, checks, reviewers, exit-gate evaluation, merge slot
@broject/debtReview-debt pipeline — harvest merged-PR threads → ledger → beads
@broject/drillScoped descent frames — drill down/up with result + prevention memos
@broject/convoyMolecule runner — beads DAG workflows scheduled inside the agent
@broject/githubGitHub connector — the reviews facade over the gh CLI
@broject/gitlabGitLab connector — the reviews facade over the glab CLI
@broject/linearLinear connector — the tasks facade over Linear GraphQL API
@broject/jiraJira connector — the tasks facade over the atlassian CLI (Cloud/Data Center)
@broject/learnLesson store — schema and bd kv CRUD behind bro self learn
@broject/loopAutonomous backlog loop — claim beads, spawn agents, drive the gate
@broject/bro-packDefault capability pack — skills and formulas installed by bro setup --pack
@broject/stackStacked bead→worktree→PR chains — branch-namespace parsing + sync planning
@broject/retroRetrospect engine — TOML retro plans → prevention actions
@broject/broseMarkdown template engine — {{key}} render, name@version registry, brose new|validate
@broject/brotocolFiletree protocol — CRUD/search/graph/lint over a configured doc tree + the spec preset
@broject/specBro plugin — SpecStore facade over Brotocol+Brose; the brose specs connector

All packages are ESM-only and require Node ≥ 22.18. Versions release in lockstep; each package page on npm carries its own README.

On this page