coco-cli

<!-- Wrapper generated with the cli-anything skill. Methodology: HKUDS/CLI-Anything (https://github.com/HKUDS/CLI-Anything) — Apache-2.0. --> # 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).