How do I install the Coco CLI skill?

Run npx skillmds@latest add coco-research/coco-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Coco CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Coco CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Coco CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Coco CLI?

coco-research (@coco-research) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Coco CLI by coco-research — Agent Skill

Name: Coco CLI
Author: coco-research

Coco CLI

Install, update, version-check, or uninstall the Coco open-source AI workflow framework via its CLI (cocosuperintelligence, 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".

File contents

coco-cli — manage the Coco framework

Thin agent wrapper over cocosuperintelligence (run via npx). Drives the real CLI; does not reimplement it.

Commands

Command	Purpose	Invocation
(default)	clone + install, auto-detecting the adapter	`npx cocosuperintelligence`
`install`	clone + install with explicit flags	`npx cocosuperintelligence install [flags]`
`update`	pull latest in an existing clone	`npx cocosuperintelligence update [dir]`
`uninstall`	remove symlinks + the clone	`npx cocosuperintelligence uninstall [dir]`
`version`	print version + check for updates	`npx cocosuperintelligence version`
`--help`	print usage	`npx cocosuperintelligence --help`

Install flags (passed through to install.sh)

--adapter <name> — one of claude-code | cursor | codex | generic
--systems <list> — comma-separated, e.g. gsd,brain,team
--dry-run — preview only, no writes

Examples

Install for Cursor: npx cocosuperintelligence install --adapter cursor
Selective systems: npx cocosuperintelligence install --systems gsd,brain --adapter claude-code
Preview without writing: npx cocosuperintelligence install --dry-run
Update an existing clone: npx cocosuperintelligence 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 repo and creates symlinks; uninstall removes them. install/update re-pull, so they are not no-ops.
Network egress: github.com only. No telemetry. Disable update checks with COCO_NO_UPDATE_CHECK=1.
Prerequisites: node/npx, git, and bash.

---name: coco-clidescription: Install, update, version-check, or uninstall the Coco open-source AI workflow framework via its CLI (cocosuperintelligence, 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".---# coco-cli — manage the Coco frameworkThin agent wrapper over `cocosuperintelligence` (run via `npx`). Drives the real CLI; does not reimplement it.## Commands| Command | Purpose | Invocation ||---|---|---|| (default) | clone + install, auto-detecting the adapter | `npx cocosuperintelligence` || `install` | clone + install with explicit flags | `npx cocosuperintelligence install [flags]` || `update` | pull latest in an existing clone | `npx cocosuperintelligence update [dir]` || `uninstall` | remove symlinks + the clone | `npx cocosuperintelligence uninstall [dir]` || `version` | print version + check for updates | `npx cocosuperintelligence version` || `--help` | print usage | `npx cocosuperintelligence --help` |## Install flags (passed through to install.sh)- `--adapter <name>` — one of `claude-code` | `cursor` | `codex` | `generic`- `--systems <list>` — comma-separated, e.g. `gsd,brain,team`- `--dry-run` — preview only, no writes## Examples- Install for Cursor: `npx cocosuperintelligence install --adapter cursor`- Selective systems: `npx cocosuperintelligence install --systems gsd,brain --adapter claude-code`- Preview without writing: `npx cocosuperintelligence install --dry-run`- Update an existing clone: `npx cocosuperintelligence update`## Output contractThis 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 repo and creates symlinks; `uninstall` removes them. `install`/`update` re-pull, so they are not no-ops.- Network egress: `github.com` only. No telemetry. Disable update checks with `COCO_NO_UPDATE_CHECK=1`.- Prerequisites: `node`/`npx`, `git`, and `bash`.

Frequently asked questions