Use the actual scripts and file contracts.
Casa core exposes separate Node CLIs. The optional capx/ integration makes network requests to hosted services.
Reviewed September 16, 2026 · Casa v0.3.0 · Current Launchpad mainnet presets. Release notes
Paths and invocation
The commands below run from the Casa repository root. If your brain is in a different project, replace company-brain with its absolute path. For an installed plugin, use its actual checkout path for each script. Angle-bracket placeholders describe arguments and must be replaced before executing a shell command.
Routing and brain state
node scripts/router.mjs next company-brain/profile.json --constraint company-brain/state.jsonnode scripts/router.mjs plan company-brain/profile.json --out company-brain| CLI | Supported command family | Boundary |
|---|---|---|
| scripts/router.mjs | plan | next <profile.json> [--out dir] [--completed a,b] [--level N] [--weights pulse.json] [--constraint state.json] [--department X] | next returns the ranked ready set; plan with --out writes planning files. |
| scripts/brain.mjs | init | sync | complete | waiting | unwait | loop-ran | priority-ran | experiment | grade | attest | due <brainDir> [args...] | State transitions and projections; use the specific command’s required arguments. Do not init over an existing brain. |
| scripts/face.mjs | build | check <brainDir> | build writes face.json; check validates without writing. |
Gate and ledger commands
node scripts/gates.mjs decide '{"department":"Engineering","merge_to_main":true}'node scripts/gates.mjs dial company-brain Engineering approve_firstnode scripts/ledger.mjs tail company-brain 20node scripts/ledger.mjs status company-brainnode scripts/ledger.mjs digest company-brainledger.mjs append <brainDir> accepts a JSON event with task required. A playbook completion event additionally needs its node_id and the appropriate artifact and rubric evidence. Do not invent completion events to bypass producing and reviewing the artifact.
Face and CAF
Hosted integration commands
| Command | Effect |
|---|---|
| node capx/profile.mjs --brain <dir> --logo <https-url> --category <slug> | Creates or updates the private hosted company profile; name and description can come from profile.json. |
| node capx/register.mjs push --brain <dir> | Uploads the signed CAF bundle for a company established by profile setup or mint binding. |
| node capx/bind.mjs --code <code> --brain <dir> | Redeems a Launchpad bind code and writes a connection receipt. |
| node capx/terminal-code.mjs --brain <dir> | Requests a ten-minute Terminal registration code. |
| node capx/publish.mjs <site|one-pager|deck|outputs> --dir <folder> --brain <dir> | Uploads, activates and makes the selected artifact type public; requires a hosted company record and signing key. |
| node capx/publish.mjs face --brain <dir> | Publishes the authored face.json. |
| node capx/autopush.mjs <brainDir> | Guarded bound update path; may send new signed work and an existing face. |
Public read surfaces
Read endpoints are application interfaces, not a promise of a version-stable public SDK. Handle HTTP errors, missing fields and stale data. Casa command errors are command-specific: inspect stderr and the exit status; there is no single universal exit-code table for all scripts.