co CLI

co is a CLI for change requests (CRs), issues, projects, and workspaces — straight from your terminal. You don't have to leave your editor, and AI agents can call it the same way you do.

This section is the per-command reference. If this is your first time, start with the quickstart.

→ Quickstart (5 min) — install, log in, ship your first CR

Install

Requires curl + python3 (already present on most macOS / Linux systems). Install with one line:

curl -fsSL https://docs.collabops.ai/install.sh | bash

Detects your OS/CPU automatically and drops a single Go binary (~9MB) at ~/.local/bin/co. Update with co update or by re-running the same command. If ~/.local/bin is not on your PATH, the script tells you what to add. Supported platforms: darwin/amd64, darwin/arm64, linux/amd64, linux/arm64.

Or grab the bundle manually:

curl -fsSL https://docs.collabops.ai/install/co -o ~/.local/bin/co && chmod +x ~/.local/bin/co

Log in

co auth login

Prompts you for API URL, email, password, and default workspace slug. See the auth page for full options.

Command groups

Each page documents every flag, behavior, and example for that group.

Command	Purpose
co auth	Log in / out and check auth status
co cr (alias: co pr)	Change requests — create, list, view, edit, close, reopen
co issue	Issues — create, list, view, edit, delete, sub-issue trees
co project	Projects — CRUD plus member and team management
co docs	Docs — list, view, create, append, edit, delete, export
co repo	Repositories — clone today (CRUD in follow-up)
co config	Read and write the config file
co update	Self-update to the latest published bundle

Use from agents and CI

When an AI agent creates a CR, co prepends 🤖 [BETA] to the title and appends a footer describing which agent / model authored it. CLAUDECODE=1 or CO_AS_BOT=1 toggles this on automatically; --bot forces it.

Need to debug a call? Prefix any command with CO_DEBUG=1 (e.g. CO_DEBUG=1 co cr list) — every HTTP request and response is logged to stderr.

Help

co --help          # all commands
co cr --help       # subcommands
co config path     # show config path

Config is stored at ~/.config/collabops/config.json (mode 0600).