The command-line front door to the brmbh agentic WordPress suite — a modern Bootstrap 5 + Gutenberg + ACF block-factory starter theme with built-in agent skills.
One command turns an empty folder into a working, agent-ready theme. A handful of verbs cover the whole lifecycle: scaffold → build → ship.
npm create brmbh@latest my-site # scaffold + install + build + skills + activate
# or
npx @brmbh/cli create my-siteEvery other WP starter hands you empty boilerplate. brmbh hands you boilerplate plus an agent that plans and builds your sections from a design — the agent skills ship inside the theme and work in Claude Code, Cursor, and Windsurf.
The CLI keeps the human experience tiny (one install command + ~5 verbs) while every command is also agent-legible: pass --json and you get a structured envelope instead of prose, so an agent can drive the exact same commands.
1. cd wp-content/themes
2. npx create-brmbh my-site
→ clones the theme, npm install + build
→ wires the agent skills into .claude/ .cursor/ .windsurf/
→ checks for ACF Pro, activates the theme (when wp-cli is present)
3. Open your editor + Claude/Cursor — the skills are right there:
"create a hero block from this Figma frame"
4. brmbh deploy staging → ship it
| Command | What it does | Pillar |
|---|---|---|
create [name] |
Scaffold a new theme (clone, install, build, skills, activate) | Scaffolding |
add block <name> |
Four-file ACF block (factory convention) | Scaffolding |
add cpt <name> |
One-file custom post type | Scaffolding |
add skills |
(Re)generate agent skill wrappers from canonical AGENTS/ |
Scaffolding |
dev [--once] |
Build / watch the theme's CSS + JS | Dev ops |
doctor |
Health check (node, theme, build, ACF Pro, env) | Dev ops |
deploy <env> |
Deploy to staging/prod (wraps tools/deploy.sh) |
Cloud deploy |
db pull|push <env> |
Migrate the database between environments | DB / sync |
Introspection is built in:
brmbh help # all commands
brmbh <cmd> --help # one command
brmbh schema # machine-readable schema of every command (for agents)
brmbh doctor --json # → {"ok":true,"class":"ready","checks":[...]}Built on the code-first-agents idea — the LLM orchestrates, code executes. Deterministic work (generating files, wiring registrations, running builds) lives in the command handlers. The reasoning (turning a screenshot or Figma frame into ACF fields + markup) stays with the agent skill.
Every command runs in one of two modes:
- pretty (default) — streamed steps + a summary, for humans.
--json— a single JSON envelope ({ ok, message, ... }, always exit 0), for agents.
Commands declare a level describing their envelope: L1 data, L2 a class field to branch on (e.g. doctor), L3 a literal next procedure to execute (e.g. create, add).
- Node ≥ 18
git(to clone the theme; or use--from <local-checkout>offline)- ACF Pro or Secure Custom Fields (bring your own — required for ACF blocks)
wp-cli(optional; enables auto-activation + ACF detection)
git clone https://github.com/Schmandarine/brmbh-cli && cd brmbh-cli
node bin/brmbh.js help
# scaffold from a local theme checkout (offline):
node bin/brmbh.js create demo --from ../brmbh-agentic-wp-suiteMIT