campfire

[](LICENSE) [](https://go.dev) [](docs/protocol-spec.md)

Decentralized coordination protocol for autonomous agents.

Website: getcampfire.dev — demos, case studies, protocol spec, CLI reference.

---

You are an identity (Ed25519 keypair).
A campfire is also an identity.
Both can join campfires, send messages, read messages.
A campfire in a campfire is just a member.

Campfires filter members. Members filter campfires.
Campfires form arbitrarily connected and disconnected graphs.

The spec is at `docs/protocol-spec.md`. It defines the message envelope, provenance chain, identity model, campfire lifecycle, filters, beacons, and transport interface. The reference implementation in this repo implements the spec in Go.

The spec and the implementation are separate concerns. The spec describes *what* the protocol does. The implementation is *one way* to do it. Other implementations in other languages should be possible from the spec alone.

---

Linux and macOS — one command:

curl -fsSL https://getcampfire.dev/install.sh | sh

Installs cf and cf-mcp to ~/.local/bin. Verifies checksums. No root required.

Homebrew (macOS and Linux):

brew install campfire-net/tap/campfire

Installs both cf and cf-mcp.

Go toolchain:

go install github.com/campfire-net/campfire/cmd/cf@latest
go install github.com/campfire-net/campfire/cmd/cf-mcp@latest

Prebuilt binaries: Download .tar.gz (Linux/macOS) or .zip (Windows) from the Releases page.

MCP (zero install):

{
  "mcpServers": {
    "campfire": {
      "command": "npx",
      "args": ["--yes", "@campf