Skip to content

b8e gen

Regenerate BINCLUSIVE.md from binclusive.json and inject its pointer into AGENTS.md/CLAUDE.md

ArgumentKindDefaultDescription
diroptional.project directory holding binclusive.json (defaults to the current directory)
OptionTakesDefaultDescription
--checkbooleandrift-guard: verify the pointer + BINCLUSIVE.md are in sync without writing; exit non-zero on drift

Identical to what the terminal prints — both are rendered from the same commander definition.

Usage: b8e gen [options] [dir]
Regenerate BINCLUSIVE.md from binclusive.json and inject its pointer into
AGENTS.md/CLAUDE.md
Arguments:
dir project directory holding binclusive.json (defaults to the current
directory) (default: ".")
Options:
--check drift-guard: verify the pointer + BINCLUSIVE.md are in sync
without writing; exit non-zero on drift
-h, --help display help for command
BINCLUSIVE.md is Binclusive-owned and holds the full rendered contract (stack,
enforcement, learned rules). Only a one-line pointer is injected into the managed
block of the agent-read host file — an `@BINCLUSIVE.md` import for CLAUDE.md, a
"see ./BINCLUSIVE.md" line for AGENTS.md — preserving everything outside the markers.
--check writes nothing and exits non-zero when EITHER the host pointer is missing/mangled
OR BINCLUSIVE.md drifts from binclusive.json — the CI drift-guard. A missing binclusive.json
fails loud (run `b8e init` first).
EXAMPLES
# Regenerate BINCLUSIVE.md from binclusive.json
$ b8e gen
# Fail the build when it has drifted
$ b8e gen --check
INHERITED FLAGS
--org <id|slug|name> organization context [$BINCLUSIVE_ORG_ID]
-y, --yes skip all prompts and accept defaults
--non-interactive never prompt; fail instead of asking
--progress <mode> how progress is reported
-q, --quiet suppress progress output (same as --progress quiet)
--no-color disable color
-v, --verbose verbose diagnostics
-V, --version print the CLI version
-h, --help show help for command