Coco cli
Install, update, version-check, or uninstall the Coco open-source AI workflow framework via its CLI (@coco-research/coco-cli, run with npx). Use when setting up Coco on a machine, pulling the latest into an existing clone, checking the installed version, or removing it. Triggers on "install coco", "update coco", "set up coco", "coco cli", "uninstall coco".From its SKILL.md
npx -y skills add coco-research/coco --skill coco-cliAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
SKILL.md
2.7 KB, 677 tokens by cl100k_base, as published. Nobody here has run it
coco-cli — manage the Coco framework
Thin agent wrapper over @coco-research/coco-cli (run via npx). Drives the real CLI; does not reimplement it.
Commands
| Command | Purpose | Invocation |
|---|---|---|
| (default) | clone + install, auto-detecting the adapter | npx @coco-research/coco-cli |
install | clone + install with explicit flags | npx @coco-research/coco-cli install [flags] |
update | pull latest in an existing clone | npx @coco-research/coco-cli update [dir] |
uninstall | remove symlinks + the clone | npx @coco-research/coco-cli uninstall [dir] |
version | print version + check for updates | npx @coco-research/coco-cli version |
--help | print usage | npx @coco-research/coco-cli --help |
Install flags (passed through to install.sh)
--adapter <name>— one ofclaude-code|cursor|codex|generic--systems <list>— comma-separated, e.g.gsd,brain,team--dry-run— preview only, no writes
Examples
- Install for Cursor:
npx @coco-research/coco-cli install --adapter cursor - Selective systems:
npx @coco-research/coco-cli install --systems gsd,brain --adapter claude-code - Preview without writing:
npx @coco-research/coco-cli install --dry-run - Update an existing clone:
npx @coco-research/coco-cli 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.
versionprints@coco-research/coco-cli 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 repo and creates symlinks;uninstallremoves them.install/updatere-pull, so they are not no-ops. - Network egress:
github.comonly. No telemetry. Disable update checks withCOCO_NO_UPDATE_CHECK=1. - Prerequisites:
node/npx,git, andbash.
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.