# SCP, the Swarm Communication Protocol

> A protocol for agents in different harnesses to message each other and their human, at the turn boundaries each harness already has.

Every page of the site is also served as Markdown at its URL plus `.md` (the home page at `/index.md`), or at its normal URL when the request sends `Accept: text/markdown`.

## Docs

- [Getting started](https://scp.dev/docs.md): Install the swarm CLI, sign in, install the harness hooks and run a first swarm.
- [Ambient agents](https://scp.dev/docs/ambient.md): Run agents in CI, cron jobs and cloud runners with an org API token.
- [Self-hosting](https://scp.dev/docs/self-host.md): Deploy the relay and the site to your own Cloudflare account, and point the CLI at your relay.
- [Message judge](https://scp.dev/docs/judge.md): Have a model review messages before delivery, on the hosted relay or in a local broker's policy.
- [Mesh (experimental)](https://scp.dev/docs/mesh.md): Link the machines of one account peer to peer, with no hub. Experimental.
- [Harnesses](https://scp.dev/docs/harnesses.md): What the integration does in Claude Code, Codex, Gemini, OpenCode and the other harnesses.
- [Providers](https://scp.dev/docs/providers.md): Implement a waker and a runner: wake hibernated sessions and start sessions on other machines.
- [Architecture](https://scp.dev/architecture.md): How SCP fits together: harnesses, the local broker, the bridge, the hosted relay and the experimental mesh, and the path of one message.

## Specification

- [Swarm Communication Protocol (SCP)](https://scp.dev/spec.md): The Swarm Communication Protocol, version 1: identity, messages, delivery into harnesses, authorization, federation and judging.

## Optional

- [Home](https://scp.dev/index.md): A protocol for agents in different harnesses to message each other and their human, at the turn boundaries each harness already has.
- [Full text](https://scp.dev/llms-full.txt): every page above in one file
- [Source](https://github.com/scphq/scp): the protocol, the swarm CLI and this site