The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Chap
CHAP, the Collaborative Human Agent Protocol, is a MCP/A2A-compatible runtime for auditable human-agent work: approvals, overrides, handoffs, escalation and verifiable evidence…
Install
$
npx tsx reference/core-plus-review/analyze-overrides.ts --db ./chap.db wsp_pr_reviewsClaude Code
claude mcp add chap -- npx tsx reference/core-plus-review/analyze-overrides.ts --db ./chap.db wsp_pr_reviewsCursor / Claude Desktop (mcp.json)
{
"mcpServers": {
"chap": {
"command": "npx",
"args": [
"tsx",
"reference/core-plus-review/analyze-overrides.ts",
"--db",
"./chap.db",
"wsp_pr_reviews"
]
}
}
}Install command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →Collaborative Human-Agent Protocol (CHAP)
The open protocol for humans and agents doing accountable work together.
CHAP gives approvals, overrides, handoffs and escalations one shared, auditable shape across MCP and A2A.
Start here · Concepts · Install · 90-second tour · MCP quickstart · Scenarios · Implementations · Wiki · Discussions · Paper
Work is moving towards teams in which hundreds of agents and hundreds of people take part. Agents draft, triage and recommend; people approve, correct, overrule and escalate. Those human decisions make the work accountable, yet they are usually recorded only in chat threads, ticket comments and memory.
CHAP gives those decisions a defined structure and an auditable record: what the agent produced, what the person decided and why, in one log that can be queried and verified.
- Structured overrides. When a person edits an agent's work, the edit is recorded with a diff, a rationale and tags your team defines, so corrections can be analysed later.
- A tamper-evident log. Every change is recorded in order. With the hash chain on, an altered entry is detected on verification, provided a recent chain head is kept out of the operator's reach (
SECURITY.md§5). The history survives key rotation, expired vendor logs and staff changes. - Signatures and identity. Optional extensions, called profiles, require every call to be signed, bind signing keys to verified identities, and submit entries to a transparency log.
- Alongside MCP and A2A. MCP connects agents to tools and A2A connects agents to each other; CHAP records the work agents share with people.
Concepts
CHAP is a protocol: a set of calls that agents, people and their tools send to a coordinator, the service that mediates a workspace. The coordinator checks each call against the workspace's rules, answers it, and records each accepted change in the workspace's audit log. The TypeScript and Python packages below are coordinators, to embed in your own process or run as a server.
| Term | What it is |
|---|---|
| Workspace | A named context for one body of work: its members, its tasks, and the profiles it uses |
| Participant | A member, named by a URI such as human:alice@example.org or agent:triage; group: names a set of members |
| Task | A unit of work, assigned to a participant |
| Artefact | What a participant produces in a task: a draft, a decision, an override |
| Envelope | One call, as a JSON-RPC 2.0 message; its method is the verb, such as task.create or decide.approve |
| Audit log | The ordered record of every change to the workspace; with the hash chain on, each entry carries the hash of the one before it |
The verbs read as their names. A task is created, completed and sent for review (task.create, task.complete, review.request). A reviewer approves, rejects or overrides it (decide.approve, decide.reject, decide.override). Work is handed off or escalated (handoff.propose, escalate.raise), and audit.read returns the record.
Similar plugs
Reverse engineer anything with agents, from app behavior down to native binaries.
Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…
User-friendly AI Interface (Supports Ollama, OpenAI API, ...)
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io