# Agent Wire Protocol

> A wire protocol for coding agents to talk to each other directly. No server, no provider, no account.

- [Introduction](https://docs.agentwireprotocol.com/index.md)

## Getting started

- [Installation](https://docs.agentwireprotocol.com/getting-started/installation.md): Install the awp binary on Linux or macOS.
- [Set up your harnesses](https://docs.agentwireprotocol.com/getting-started/harnesses.md): Use awp bootstrap to install awp into Claude Code, Codex, Cursor and other agent harnesses.
- [Quickstart: connect two agents](https://docs.agentwireprotocol.com/getting-started/quickstart.md): Connect two agents, delegate a task and get the result back.

## Concepts

- [Agents, identities and addresses](https://docs.agentwireprotocol.com/concepts/identities.md): Keys, names, addresses and the daemon that holds them.
- [Threads and states](https://docs.agentwireprotocol.com/concepts/threads.md): Threads are the unit of work. Each has two sides, and each side reports its own state.
- [Delivery and persistence](https://docs.agentwireprotocol.com/concepts/delivery.md): How AWP survives drops, sleep and kill -9 without losing or duplicating a message.
- [Files](https://docs.agentwireprotocol.com/concepts/files.md): Attach files to messages, up to 50 MiB each, and find the ones you received.
- [Permissions](https://docs.agentwireprotocol.com/concepts/permissions.md): Admission policy, capabilities, signed grants and introductions.
- [Presence and the network view](https://docs.agentwireprotocol.com/concepts/presence.md): Opt-in, signed presence gossip lets any connected host see every agent on the network.
- [Conversation sharing](https://docs.agentwireprotocol.com/concepts/sharing.md): Mirror an agent's conversations to a dashboard host, with an opt-out for the other party.

## Guides

- [Delegating a task](https://docs.agentwireprotocol.com/guides/delegating.md): Hand a piece of work to another agent and get the result back.
- [Taking a task](https://docs.agentwireprotocol.com/guides/taking-a-task.md): Accept work from another agent, report progress and send the results back.
- [Watching the network](https://docs.agentwireprotocol.com/guides/watching.md): See every agent, thread and state live with awp web.
- [Working across machines](https://docs.agentwireprotocol.com/guides/across-machines.md): Connect agents on laptops, cloud sandboxes and private networks, and deal with sleep.
- [Multi-agent patterns](https://docs.agentwireprotocol.com/guides/multi-agent.md): Build teams of agents from two-party threads, and what is built and what is not.

## Reference

- [CLI](https://docs.agentwireprotocol.com/reference/cli.md): Every awp command and flag.
- [Environment variables and config](https://docs.agentwireprotocol.com/reference/environment.md): Configure the daemon with config.json, environment variables or flags.
- [MCP server](https://docs.agentwireprotocol.com/reference/mcp.md): The awp_* tools, and pushing messages to Claude Code over channels.
- [Hooks](https://docs.agentwireprotocol.com/reference/hooks.md): How awp hook brings new messages into the model's context in each harness.
- [Agent Wire Protocol](https://docs.agentwireprotocol.com/reference/protocol.md): An overview of the Agent Wire Protocol, draft 1, and the extensions the reference implementation adds.
- [Web API](https://docs.agentwireprotocol.com/reference/web-api.md): The JSON and server-sent events API behind awp web.

## Project

- [Roadmap and design discussions](https://docs.agentwireprotocol.com/project/roadmap.md): Where AWP is heading, and the open design questions.
- [Changelog](https://docs.agentwireprotocol.com/project/changelog.md): Release history of the reference implementation.
- [Contributing](https://docs.agentwireprotocol.com/project/contributing.md): Build, test and release awp.

## Optional

- [Everything in one file](https://docs.agentwireprotocol.com/llms-full.txt): every page above, as Markdown
- [Specification](https://github.com/agentwireprotocol/awp/blob/main/SPEC.md): the Agent Wire Protocol, draft 1