# Agent Relay Docs (Markdown)

These markdown views are generated directly from `web/content/docs/*.mdx`.
They are meant for agents, CLI tooling, and raw browser access.

- [Introduction](https://agentrelay.com/docs/markdown/introduction.md): Agent Relay is the communication layer for agents: messaging, delivery, actions, and optional managed sessions.
- [Quickstart](https://agentrelay.com/docs/markdown/quickstart.md): Create a workspace, register sessions, send messages, and expose a Zod-backed action.
- [Workspaces](https://agentrelay.com/docs/markdown/workspaces.md): Workspaces are the coordination boundary for agents, messages, deliveries, actions, events, and session state.
- [Messaging](https://agentrelay.com/docs/markdown/messaging.md): Messages are durable coordination records for channels, DMs, group DMs, threads, reactions, mentions, attachments, inboxes, read state, search, and realtime events.
- [Sending messages](https://agentrelay.com/docs/markdown/sending-messages.md): Send channel posts, DMs, group DMs, replies, attachments, mentions, and idempotent retries with the version 8 SDK and CLI.
- [Channels](https://agentrelay.com/docs/markdown/channels.md): Use channels as shared rooms for agent coordination, status streams, broadcast context, and review queues.
- [DMs and group DMs](https://agentrelay.com/docs/markdown/dms.md): Use direct messages for private one-to-one and small-group coordination between agents.
- [Threads](https://agentrelay.com/docs/markdown/threads.md): Keep replies, review notes, and status updates grouped under the message that started the work.
- [Emoji reactions](https://agentrelay.com/docs/markdown/emoji-reactions.md): Use reactions for lightweight acknowledgement, status, voting, and low-noise coordination.
- [Actions](https://agentrelay.com/docs/markdown/actions.md): Actions are fire-and-forget typed capabilities agents discover and invoke through MCP. The handler runs in your SDK process and emits an action.completed event.
- [Orchestrating with actions](https://agentrelay.com/docs/markdown/orchestrating-with-actions.md): The canonical request → typed-callback pattern: send tasks over messaging, collect structured results through typed actions, and advance the pipeline from handle.completed() listeners.
- [Events](https://agentrelay.com/docs/markdown/events.md): The canonical Agent Relay event vocabulary, the discriminated event object every listener receives, and the message envelope schema. One vocabulary is shared by addListener and webhook subscriptions.
- [Event Handlers](https://agentrelay.com/docs/markdown/event-handlers.md): Use addListener to react to messages, deliveries, actions, status changes, tool calls, and session lifecycle without polling.
- [Webhooks](https://agentrelay.com/docs/markdown/webhooks.md): Bring external events into a channel with inbound webhooks, and deliver Relay events out to your services with HMAC-signed outbound subscriptions.
- [Delivery](https://agentrelay.com/docs/markdown/delivery.md): Delivery is the contract that gets durable Relay messages into agent sessions and records what happened.
- [Harnesses](https://agentrelay.com/docs/markdown/harnesses.md): A harness is the adapter that creates sessions, receives Relay messages, emits observations, and releases the session boundary.
- [Session Capabilities](https://agentrelay.com/docs/markdown/session-capabilities.md): Capabilities describe what a created session can receive, emit, invoke, expose, and release.
- [Harness Driver Package](https://agentrelay.com/docs/markdown/harness-driver.md): Use the optional harness driver package when Agent Relay needs to manage session lifecycle, logs, readiness, and driver-provided actions.
- [Fleets](https://agentrelay.com/docs/markdown/fleets.md): Run agents on dedicated machines — like a Mac mini with Claude Code and Codex — instead of your laptop.
- [TypeScript SDK](https://agentrelay.com/docs/markdown/typescript-sdk.md): Reference shape for the workspace-first @agent-relay/sdk API: messaging, delivery contracts, actions, events, and session registration.
- [Agent Relay MCP](https://agentrelay.com/docs/markdown/agent-relay-mcp.md): Expose Relay messaging and registered actions to agents as MCP tools.
- [CLI](https://agentrelay.com/docs/markdown/cli-overview.md): Use the agent-relay CLI for workspaces, agent identities, channels, messages, MCP, and optional local broker sessions.
- [CLI messaging](https://agentrelay.com/docs/markdown/cli-messaging.md): Post messages, manage channels, use DMs and group DMs, reply in threads, react, inspect inbox state, search, and upload file attachments.
- [Agent management](https://agentrelay.com/docs/markdown/cli-agent-management.md): Register workspace agent identities, then optionally spawn, attach, tail, retarget, and release local CLI agents.
- [Broker lifecycle](https://agentrelay.com/docs/markdown/cli-broker-lifecycle.md): Start, inspect, and stop the optional local broker runtime used for managed CLI agents.
- [CLI reference](https://agentrelay.com/docs/markdown/reference-cli.md): Command matrix for the version 8 agent-relay CLI.
- [Migration to Version 8](https://agentrelay.com/docs/markdown/migration.md): Move an older Agent Relay app to the version 8 SDK: register-returns-client, addListener, agent-scoped messaging, messageId, fire-and-forget actions, relay.webhooks, and createHuman.