coco-cli

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 of claude-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.
• version prints cocosuperintelligence vX.Y.Z plus an update hint — parse the vX.Y.Z token.
• 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.sh step failed — surface the captured stdout + stderr to the user.
• Update checks contact github.com only; on network failure the version check degrades quietly and the command still runs.

Notes

• Side effects: install clones the pinned release tag and creates symlinks; uninstall removes them. install/update re-fetch, so they are not no-ops. Branch checkouts still git pull --ff-only and are not force-moved onto an older pin.
• Network egress: github.com only. No telemetry. Disable update checks with COCO_NO_UPDATE_CHECK=1.
• Prerequisites: node/npx, git, and bash. npx cocosuperintelligence is the published path (clones the pin and installs).