The Agent Interface Profile (AIP) v0.1 lands: a small kernel of CLI primitives any agent runtime can drive deterministically, without parallel schemas or hand-written MCP tools.
bcli describe --format jsonprojects the live Typer surface, registry, and profile as one canonical artifact.- Mutation result envelope (
--result-out PATH/--result-fd N) on every write — failures are diagnosable side-channel, no stdout scraping. - Batch operation ledger — durable SQLite, survives
SIGKILL. Three new commands:bcli batch state,bcli batch list,bcli batch rollback. - Exit code taxonomy (
0–8) replaces "non-zero = error"; agents key off specific codes. - JSON on pipe by default — pipelines, redirects, CI all get machine-readable output without flag dance.
--idempotency-keyon writes + per-stepidempotency_key:in batch YAML — same-run replay protection.bcli_mcprewrote from 4 hand-written tools to 23 generated frombcli describe, including 5 new mutating verbs that return envelopes.- Skills layer —
bcli skill installprojects saved queries and batch workflows as Claude Code slash commands;bcli skill initis an interactive wizard for per-user personalization. Entry-point groupbcli.skill_init.role_templateslets downstream packages contribute role-tailored templates without forking bcli.
Breaking changes
Two intentional breaks (one-line migrations):
- Policy refusals (read-only profile + missing
--yes) now exit8(was1). - MCP tool names match the CLI command path:
query→bcli_get,list_endpoints→bcli_endpoint_list, etc. Migration table indocs/mcp-server.md.
Full changelog
See CHANGELOG.md for the full entry, including deferred-to-v0.5 items.