BB-Eco — API & Reference
Stable, machine-readable interfaces for BB-Eco, versioned independently of the rest of the documentation.
What lives here
- BB-Eco CLI — every
bb-ecocommand, subcommand, argument, and option, auto-generated from the live CLI help. Run from scripts, CI pipelines, scheduled audits, or any context that doesn't want a desktop session. - Template JSON format — the schema for
bb-eco template export/apply/diff. Section-by-section field reference, "null means don't touch" semantics, apply order.
Coming later
- .NET Core library (
Brainboxes.Eco.Core) — for embedding BB-Eco's discovery and upgrade primitives into your own .NET applications. - Sidecar JSON-RPC + WebSocket protocol — the wire protocol the BB-Eco desktop app speaks to its sidecar, available to any client that wants the same capabilities from another language.
Both ship after the BB-Eco 1.0 release once their public surface stabilises.
Versioning
This API reference is versioned independently of the main documentation. Pick the BB-Eco release you're running from the version dropdown in the top navigation. The "next" view always reflects the current development build.
See also
- BB-Eco overview — start-here landing for the BB-Eco app and CLI
- How BB-Eco works — architecture and on-the-wire protocols
- Configuration as code with BB-Eco — the rationale for the template format documented here