---
name: Coco CLI
slug: coco-cli
category: DevOps
description: Coco CLI installs, updates, checks versions for, and uninstalls the Coco open-source AI workflow framework. Use it when setting up Coco on a machine or managing an existing clone.
github: "https://github.com/coco-research/coco/tree/main/skills/coco-cli"
language: HTML
stars: 218
forks: 11
install: "npx degit https://github.com/coco-research/coco/tree/main/skills/coco-cli ~/.claude/skills/coco-cli"
installs_to: ~/.claude/skills/coco-cli
source_path: skills/coco-cli/SKILL.md
collection_size: 25
category_size: 920
collection_url: "https://dirskills.com/collections/coco-research/coco"
added: 2026-09-04T05:25:18.588Z
last_synced: 2026-09-04T05:25:18.588Z
canonical_url: "https://dirskills.com/skills/coco-cli"
---

# Coco CLI

Coco CLI installs, updates, checks versions for, and uninstalls the Coco open-source AI workflow framework. Use it when setting up Coco on a machine or managing an existing clone.

**Install:**

```bash
npx degit https://github.com/coco-research/coco/tree/main/skills/coco-cli ~/.claude/skills/coco-cli
```

## README

<!-- 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 `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`.