# a2a-wrapper > Turn Claude, OpenAI Codex, GitHub Copilot, OpenCode and Antigravity into A2A agents with one JSON config. Open source, spec-compliant, multi-agent ready. Full documentation as one file: https://a2a-wrapper.allsrc.dev/llms-full.txt. Any docs page is available as Markdown by appending .md to its URL. A read-only docs MCP server is at https://a2a-wrapper.allsrc.dev/mcp. Frequently asked questions: https://a2a-wrapper.allsrc.dev/faq.md. - [Introduction](https://a2a-wrapper.allsrc.dev/docs): a2a-wrapper turns Claude, OpenAI Codex, GitHub Copilot, OpenCode and Google Antigravity into standalone A2A agents that can discover, delegate to, and work with each other. Drop in a JSON config, get a spec-compliant server. - [FAQ](https://a2a-wrapper.allsrc.dev/faq) - Get started: Install and run your first A2A agent - [Installation](https://a2a-wrapper.allsrc.dev/docs/getting-started/installation): Install an a2a-wrapper package from npm or build the monorepo from source. Covers requirements, per-backend authentication, and the stable and canary release channels. - [Quick start](https://a2a-wrapper.allsrc.dev/docs/getting-started/quickstart): Turn GitHub Copilot into an A2A server with one JSON config file, then discover it through its agent card and send it a message from any A2A client. - [Multi-agent crew](https://a2a-wrapper.allsrc.dev/docs/getting-started/multi-agent-crew): A runnable multi-agent software engineering workflow. A planner delegates a feature to Claude through a2a-claude, then hands the result to Codex through a2a-codex for tests and review, all over A2A. - Concepts: How A2A and a2a-wrapper work - [What is A2A?](https://a2a-wrapper.allsrc.dev/docs/concepts/a2a-protocol): The Agent2Agent (A2A) protocol is an open standard for agents to discover each other, exchange tasks, stream results and collaborate, regardless of which framework or vendor built them. How it relates to MCP, and what it gives a2a-wrapper users. - [Architecture](https://a2a-wrapper.allsrc.dev/docs/concepts/architecture): How a2a-wrapper is structured, from the shared core to the per-backend executors. The request path through the Express server, the executor, the session manager and the backend SDK. - [Agent cards](https://a2a-wrapper.allsrc.dev/docs/concepts/agent-cards): How a2a-wrapper builds and serves an A2A agent card for discovery. The agentCard config block, skills, version-aware responses, and optional JWS-signed cards. - [Tasks and streaming](https://a2a-wrapper.allsrc.dev/docs/concepts/tasks-and-streaming): How a2a-wrapper agents execute A2A tasks. Task states, blocking versus streaming calls, buffered versus streamed artifacts, cancellation, and what happens to long-running background work. - [Sessions and contexts](https://a2a-wrapper.allsrc.dev/docs/concepts/sessions): How a2a-wrapper keeps multi-turn conversations. Each A2A contextId maps to a persistent backend session, with optional TTL expiry, and what happens when a session expires. - [Protocol versions](https://a2a-wrapper.allsrc.dev/docs/concepts/protocol-versions): a2a-wrapper speaks A2A v1.0 natively and stays backward compatible with v0.3.x clients, negotiating per request with no configuration. How the agent card, JSON-RPC and REST routes translate between versions. - [Sub-agents](https://a2a-wrapper.allsrc.dev/docs/concepts/sub-agents): Let one a2a-wrapper agent delegate to other A2A agents. Declare subAgents in config and each remote skill becomes a callable MCP tool through the a2a-mcp-skillmap bridge. - [Observability and events](https://a2a-wrapper.allsrc.dev/docs/concepts/observability): Sideband trace events in a2a-wrapper. Tool calls, reasoning, file changes and usage emitted as A2A trace artifacts or sent to an HTTP collector or custom sink such as Kafka. - [Memory and skills](https://a2a-wrapper.allsrc.dev/docs/concepts/memory-and-skills): Give an a2a-wrapper agent persistent instructions and reusable skills. The memory config block writes instruction files and SKILL.md folders into the workspace in each backend's native location. - Guides: Configure, secure, and deploy agents - [Choosing a wrapper](https://a2a-wrapper.allsrc.dev/docs/guides/choosing-a-wrapper): Compare a2a-copilot, a2a-claude, a2a-codex, a2a-opencode and a2a-antigravity. Backends, provider flexibility, sandboxing, streaming, and default ports, so you can pick the right A2A wrapper for your agent. - [Configuration](https://a2a-wrapper.allsrc.dev/docs/guides/configuration): How a2a-wrapper configuration works. The JSON config file, the layering order of defaults, file, environment variables and CLI flags, environment-variable substitution, and the blocks every wrapper shares. - [MCP tool servers](https://a2a-wrapper.allsrc.dev/docs/guides/mcp-tools): Give an a2a-wrapper agent extra tools through MCP. Stdio and HTTP server configuration for each wrapper, authenticated remote servers with environment-variable headers, and OAuth. - [Docker](https://a2a-wrapper.allsrc.dev/docs/guides/docker): Run a2a-wrapper agents in Docker. Build from the monorepo root, pass credentials as environment variables, mount a workspace, and handle Codex sandboxing and corporate proxy certificates. - [Security guide](https://a2a-wrapper.allsrc.dev/docs/guides/security): Deploy a2a-wrapper agents safely: network exposure, permission and sandbox modes, workspace hygiene, and a pre-flight checklist. - [Integrate with agent frameworks](https://a2a-wrapper.allsrc.dev/docs/guides/integrate-with-frameworks): Use a2a-wrapper agents as execution nodes inside LangGraph, Google ADK, CrewAI, Microsoft Agent Framework or any A2A-capable orchestrator. The wrappers complement orchestration frameworks rather than replace them. - [Build your own wrapper](https://a2a-wrapper.allsrc.dev/docs/guides/build-a-wrapper): Add a new backend to a2a-wrapper by implementing the A2AExecutor interface and wiring it with createCli from @a2a-wrapper/core. A minimal TypeScript example and the steps to add it to the monorepo. - [Troubleshooting](https://a2a-wrapper.allsrc.dev/docs/guides/troubleshooting): Fix common a2a-wrapper problems. Model not available, authentication errors, a missing core build or stale dependencies, unreachable agents, Codex sandbox failures in Docker, and expired sessions. - Reference: HTTP API, packages, glossary - [HTTP API](https://a2a-wrapper.allsrc.dev/docs/reference/api): The HTTP surface every a2a-wrapper agent exposes. The agent card endpoint, A2A JSON-RPC and REST routes, health check, and example requests for message/send, message/stream, tasks/get and tasks/cancel. - [Glossary](https://a2a-wrapper.allsrc.dev/docs/reference/glossary): Definitions of the terms used across the a2a-wrapper docs. A2A, agent card, task, artifact, context, executor, sideband event, sub-agent, MCP, skill, and more. - Packages - [@a2a-wrapper/core](https://a2a-wrapper.allsrc.dev/docs/reference/packages/core): API reference for the shared core: config loading, server factory, sessions, events, memory, and sub-agents. - [a2a-copilot](https://a2a-wrapper.allsrc.dev/docs/reference/packages/a2a-copilot): Reference for a2a-copilot: expose GitHub Copilot as an A2A agent, with BYOK providers, MCP tools, and usage telemetry. - [a2a-claude](https://a2a-wrapper.allsrc.dev/docs/reference/packages/a2a-claude): Reference for a2a-claude: expose Claude as an A2A agent, with permission modes, sessions, rate limits, and background tasks. - [a2a-codex](https://a2a-wrapper.allsrc.dev/docs/reference/packages/a2a-codex): Reference for a2a-codex: expose OpenAI Codex as an A2A agent, with sandbox modes, approval policy, and the context API. - [a2a-opencode](https://a2a-wrapper.allsrc.dev/docs/reference/packages/a2a-opencode): Reference for a2a-opencode: expose OpenCode as a multi-provider A2A agent, with MCP transports and OAuth. - [a2a-antigravity](https://a2a-wrapper.allsrc.dev/docs/reference/packages/a2a-antigravity): Reference for a2a-antigravity: expose Google Antigravity as an A2A agent via a managed Python bridge. - AI & agents: llms.txt, Markdown, and the docs MCP server - [Use these docs with AI](https://a2a-wrapper.allsrc.dev/docs/ai): These docs are built for AI agents and LLMs. llms.txt, llms-full.txt, a Markdown version of every page, content negotiation with the Accept header, copy-as-Markdown buttons, and a docs MCP server. - [Docs MCP server](https://a2a-wrapper.allsrc.dev/docs/ai/mcp-server): Connect Claude Code, Cursor, VS Code or any MCP client to the a2a-wrapper documentation. A read-only MCP server over Streamable HTTP with search_docs, get_page and list_pages tools. - Community: Contributing, roadmap, changelogs - [Contributing](https://a2a-wrapper.allsrc.dev/docs/community/contributing): How to set up the monorepo, run tests, create changesets, add a new wrapper, and open a pull request. - [Roadmap](https://a2a-wrapper.allsrc.dev/docs/community/roadmap): What is planned for a2a-wrapper. OpenTelemetry observability and other upcoming work, and how to propose changes. - Changelog - [@a2a-wrapper/core changelog](https://a2a-wrapper.allsrc.dev/docs/community/changelog/core): Release notes for @a2a-wrapper/core. - [a2a-copilot changelog](https://a2a-wrapper.allsrc.dev/docs/community/changelog/a2a-copilot): Release notes for a2a-copilot. - [a2a-claude changelog](https://a2a-wrapper.allsrc.dev/docs/community/changelog/a2a-claude): Release notes for a2a-claude. - [a2a-codex changelog](https://a2a-wrapper.allsrc.dev/docs/community/changelog/a2a-codex): Release notes for a2a-codex. - [a2a-opencode changelog](https://a2a-wrapper.allsrc.dev/docs/community/changelog/a2a-opencode): Release notes for a2a-opencode. - [a2a-antigravity changelog](https://a2a-wrapper.allsrc.dev/docs/community/changelog/a2a-antigravity): Release notes for a2a-antigravity.