Cq

cq

**Status: 0.x** — expect breaking changes. See [DEVELOPMENT.md](DEVELOPMENT.md#status) for migration guides.

An open standard for shared agent learning — structured knowledge that prevents AI agents from repeating each other's mistakes.

The term **cq** is derived from two sources: *colloquy* (/ˈkɒl.ə.kwi/), a structured exchange of ideas where understanding emerges through dialogue rather than one-way output, and **CQ**, a radio call sign ("any station, respond"), capturing the same model: open invitation, response, and collective signal built through interaction. Both capture the same idea: agents broadcasting what they've learned and listening for what others already know.

For the full documentation, visit [docs.mozilla.ai/cq](https://docs.mozilla.ai/cq).

Installation

Install the [cq CLI](cli/README.md#installation) (via Homebrew, Scoop, or GitHub Releases), then install into your coding agent:

cq install --target 

Agent	Target
Claude	claude
Codex	codex
Copilot	copilot
Cursor	cursor
Devin Desktop	devin-desktop
OpenCode	opencode
Pi	pi

Install into multiple hosts at once by repeating `--target`.

For per-host config paths, flags, remote-server setup, and Windows locations, see [the installation guide](docs/install.md).

Once installed, follow the [Quickstart](docs/quickstart.md) to verify it works and add your first knowledge unit.

How cq works in practice

You typically do not propose knowledge units manually. cq works through two agent workflows:

Skill-guided query/propose workflow

When your agent starts a task or encounters an error, the cq skill directs the agent to query the knowledge store before the agent retries.

If another agent has already solved this problem, your agent gets the relevant guidance immediately,