coco-cli — manage the Coco framework
Thin agent wrapper over bin/coco.js (package name cocosuperintelligence).
Drives the real CLI; does not reimplement it.
npx cocosuperintelligence is the published path: it clones the pinned
release tag and runs install. From a clone, invoke node bin/coco.js.
install / update check out the release tag matching package.json
(v1.5.0 today), not floating main.
Commands
| Command | Purpose | Invocation |
|---|---|---|
| (default) | clone + install, auto-detecting the adapter | node bin/coco.js |
install | clone + install with explicit flags | node bin/coco.js install [flags] |
update | check out the pinned release tag | node bin/coco.js update [dir] |
uninstall | remove symlinks + the clone | node bin/coco.js uninstall [dir] |
version | print version + check for updates | node bin/coco.js version |
--help | print usage | node bin/coco.js --help |
Install flags (passed through to install.sh)
--adapter <name>— one ofclaude-code|cursor|grok|codex|generic--systems <list>— comma-separated, e.g.gsd,brain--dry-run— preview only, no writes
Examples
- Install for Cursor:
node bin/coco.js install --adapter cursor - Install for Grok:
node bin/coco.js install --adapter grok - Selective systems:
node bin/coco.js install --systems gsd,brain --adapter claude-code - Preview without writing:
node bin/coco.js install --dry-run - Update an existing clone:
node bin/coco.js update
Output contract
This CLI is human-output-oriented; it has no native --json mode. For agent use:
- Treat exit code 0 = success, non-zero = failure.
versionprintscocosuperintelligence vX.Y.Zplus an update hint — parse thevX.Y.Ztoken.- Capture stdout/stderr and branch on the exit code; do not assume machine-readable JSON.
Errors
- A non-zero exit means an underlying git or
install.shstep failed — surface the captured stdout + stderr to the user. - Update checks contact
github.comonly; on network failure the version check degrades quietly and the command still runs.
Notes
- Side effects:
installclones the pinned release tag and creates symlinks;uninstallremoves them.install/updatere-fetch, so they are not no-ops. Branch checkouts stillgit pull --ff-onlyand are not force-moved onto an older pin. - Network egress:
github.comonly. No telemetry. Disable update checks withCOCO_NO_UPDATE_CHECK=1. - Prerequisites:
node/npx,git, andbash.npx cocosuperintelligenceis the published path (clones the pin and installs).


