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

Windows — run in a PowerShell prompt (or use the curl line above as-is in Git Bash / WSL):

irm https://docs.collabops.ai/install.ps1 | iex

Both installers detect your OS/CPU automatically and verify the binary's sha256.

Log in

co auth login

Prompts you for API URL, email, password, and default workspace slug. After login it checks whether an SSH key and Git config are needed and, with your consent, sets them up in one go. 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 status (alias: co me)	Your CRs and issues, grouped by role
co cr (alias: co pr)	Change requests — create, list, review, merge, link issues and docs
co issue	Issues — CRUD, sub-issue trees, topic branches
co label	Workspace labels
co status-group	Issue status groups
co project	Projects — CRUD, members and teams, milestones
co docs	Docs — list, create, edit, comment, version, export
co repo	Repositories — clone, list, view, create, edit, delete
co run	CI/CD runs — list, view, logs, cancel, rerun
co obs	Observability — service health, log & trace search, trace detail
co browse	Open what you're looking at in the browser (or just print the URL)
co workspace (alias: co ws)	The workspaces you belong to
co config	Read and write config, switch environment profiles
co alias	Bind short names to commands you run often
co update	Self-update to the latest published version

Output format

Lists print as tables and details print field by field. Date-only values look like 2026-08-13 and timestamps look like 2026-08-13 14:53 KST — the same shape in every command.

co config set display.timezone UTC   # pin printed timestamps to UTC
co config unset display.timezone     # back to this machine's zone

With no timezone set, co uses this machine's zone. List commands also report how many of how many rows you are seeing, and -l 0 follows the pages to the end and fetches everything.

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.