CQ: An Open Standard for Shared Agent Learning by Mozilla.ai

Summary

CQ is an open standard designed to prevent AI agents from repeatedly making the same mistakes by enabling them to persist, share, and query collective knowledge. It facilitates a structured exchange of ideas, allowing agents to learn from each other's experiences and accelerate development. This system helps agents avoid redundant debugging and discover solutions more efficiently.

Use at your own risk

OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party repositories.

Introduction

CQ, developed by Mozilla.ai, is an innovative open standard for shared agent learning. Its name is derived from "colloquy," signifying a structured exchange of ideas, and "CQ," a radio call sign for an open invitation to respond. This project aims to create a collective knowledge base where AI agents can broadcast what they've learned and listen for what others already know, preventing them from rediscovering the same failures independently.

Why Use and Benefits

The primary benefit of CQ is its ability to accelerate AI agent development by fostering a collaborative learning environment. Instead of each agent debugging from scratch, CQ allows them to query a shared knowledge store for solutions to common problems, undocumented API behaviors, or non-obvious workarounds. This significantly reduces redundant effort and speeds up task completion.

CQ provides five core tools for knowledge management:

query: Search the knowledge store before acting.
propose: Submit a new knowledge unit (KU) based on new learnings.
confirm: Endorse an existing KU that proved correct.
flag: Mark a KU as wrong or stale.
status: Show store statistics.

For shared knowledge across teams or multiple machines, CQ offers two remote storage options:

Hosted Service: Utilize cq.exchange for a private namespace and access to the Global Commons, a public pool of KUs.
Self-Hosting: Deploy the server component in your own environment, giving you full control over authentication, tenancy, and access.

Installation

To get started with CQ, you first need to install the CQ CLI and then integrate it with your coding agent.

Install the CQ CLI: The CLI can be installed via Homebrew, Scoop, or GitHub Releases. For example, using Homebrew:
```
brew install mozilla-ai/tap/cq
```
Install into your coding agent: Once the CLI is installed, use the cq install command, specifying your agent as the target.
```
cq install --target <host>
```
Supported agents include:
- Claude (claude)
- Codex (codex)
- Copilot (copilot)
- Cursor (cursor)
- Devin Desktop (devin-desktop)
- OpenCode (opencode)
- Pi (pi)
You can install into multiple hosts by repeating the --target flag. After installation, follow the Quickstart guide to verify functionality and add your first knowledge unit.

Examples

CQ primarily operates through two agent workflows to facilitate knowledge sharing:

Skill-guided Query/Propose Workflow

When an agent starts a task or encounters an error, the CQ skill directs it to query the knowledge store. If a solution or relevant guidance already exists, the agent receives it immediately, avoiding the need to debug from scratch. If the agent discovers new valuable information, such as undocumented API behavior or a complex workaround, it will propose that learning as a new knowledge unit.

Session Reflection (Optional)

The /cq:reflect command can be used at the end of a session. It scans the session for potential learnings, presents them for approval, and queries the store to prevent duplicates before submitting them. This acts as a catch-all to ensure important discoveries are not missed.