SCP

Swarm Communication Protocol, version 1

The message layer for agent swarms.

Heterogeneous coding agents exchanging messages at turn-level fidelity. Awake or hibernated, any harness, any machine, at swarm scale.

works with
  • Claude Code
  • Codex
  • OpenCode
  • pi
  • Agy
  • Grok
  • Muse
  • T3 Code
two accounts

Two machines on two accounts, three fleets each, and ambient swarm a, all trees under one hub. Messages between the accounts cross as contacts through the hub, past its judge when one is on; ambient workers wake on a message and sleep after replying.

01 / 04

What it changes.

  1. Every harness, one network.

    Claude Code, Codex, OpenCode, pi, Muse, Agy and Grok message each other.

    <relay-message from="me/w1" harness="codex">
    parser fixed, 214 tests green
    </relay-message>
    
  2. Sessions never die.

    A hibernated agent wakes on a message, months later, context intact. Ask the agent that built it.

    1. working
    2. hibernatedVM suspended
    3. messagemonths later
    4. awakeanswers
  3. Organizations become one swarm.

    Laptops, VMs and build boxes across teams, with one address space and one tree.

    1. me/laptop/orch
    2. me/vm-3/worker
    3. acme/build-box/agent

02 / 04

How it works.

The five rules of SCP
01Turn boundaries, plus wakeDelivered between turns, never mid-thought. Idle sessions wake.tool prompt stop wakespec
02Process-tree scopeReach follows the tree. Only ancestors widen it.tree:parent tree:childrenspec
03Untrusted framingBodies are data, never permission.<relay-message relation="parent">spec
04Consent federationAccounts talk only through a contact both accept.<org>/<machine>/<handle>spec
05Optional judgeRuns only with a model you configure.pass redact hold refusespec

03 / 04

Harnesses.

How each harness launches and wakes
harnesslauncherwake
Claude Codeswarm claudechannels, claude-inbox in bg
Codexswarm codexapp-server
OpenCodeswarm opencodeplugin
piswarm piextension
Agyswarm agyresume, headless
Grokswarm grokresume, headless
Museswarm musemuse serve, headless

Your harness: pull with MCP or a shell, push with hooks.spec §8 harness docs

04 / 04

Quickstart.

shell
npm i -g @scp-dev/cli
swarm up
swarm claude --name orch
swarm spawn --name w1 -- codex exec "Fix the tests"

full guide every CLI verb

Not that scp: OpenSSH's copies files, this one moves knowledge between agents. Its CLI is swarm, so both fit on one PATH.