@devforg/cli

DevForg — the governed AI-native scaffolding engine. Snap. Wire. Ship.

devforg scaffolds DevForg projects, installs + wires modules, validates wiring, and drives an agent lifecycle. Modules declare wiring points ("studs") and requirements; the wiring engine resolves them in dependency order so composed stacks fit together predictably.

Install / use

npx --package @devforg/cli devforg --help
# or
npm i -g @devforg/cli && devforg --help

Node ≥ 20. (The binary is devforg, with dforge as a short alias.)

Commands

devforg init [name]        # scaffold a new DevForg project (devforge.json)
devforg add <module>       # install and wire a module
devforg remove <module>    # remove a module
devforg wire               # run the wiring engine across installed modules
devforg list               # list installed modules + wiring status
devforg search <query>     # search the module registry
devforg doctor             # validate wiring and report issues
devforg agent <cmd>        # AI-agent lifecycle (init/plan/apply/status/destroy)

devforg agent talks to a control plane you configure — endpoint + token come from the environment (BIGBRAIN_API_URL, default http://localhost:3111; BIGBRAIN_API_TOKEN). Nothing is bundled; without configuration the agent commands run against the default local endpoint.

Built on @devforg/sdk (the wiring engine + defineModule) and @devforg/types (the shared contracts). Some commands (search/publish) are roadmap stubs that announce themselves.

License

MIT © Dane Anthony Cooper