<div align="center">

a2a-mod

Hand work to other AI agents from Claude Code. Keep going. Get the result back.

<img src="docs/assets/demo.gif" alt="Claude Code hands a slow build to a worker, keeps working, and gets the result when it lands" width="900"> </div>

Why

• Claude never waits on a slow agent. After a few seconds the task moves to the background and Claude carries on. When the agent finishes, Claude gets the result.
• Works with any A2A agent. ADK, AG2, LangGraph, @a2a-js/sdk, or anything else that speaks A2A 1.0 or 0.3.
• Your tokens stay out of the chat. Keys come from a setting, a command or a file. You never paste one into Claude.

Install

In Claude Code 2.1.287 or later:

/plugin marketplace add NovusEdge/a2a-mod
/plugin install a2a-mod@a2a-mod

Try it in a minute

You don't need a real agent. The repo ships a fake worker (needs Node 24 and pnpm).

1. Start it:

   git clone https://github.com/NovusEdge/a2a-mod && cd a2a-mod
   pnpm i && pnpm worker
   

2. In Claude Code, add it:

   /a2a add http://127.0.0.1:41241 fake
   

3. Ask Claude:

   send "slow 20 build" to the fake worker
   

The task takes 20 seconds. Claude gets a task id after about 7 and moves on. When the worker is done, the mod wakes Claude with the result.

What you'll see

• A status line with the live task: a2a-mod: ⠋ fake slow 20 build 0:12. It stays visible next to /diff.
• A band above your prompt while a task runs, showing the hand-off from Claude to the worker.
• A slim ⇄ a2a pane that opens with /a2a, as a tab next to /diff. It shows each worker, its tasks, and buttons to copy a result, reply to a question or cancel.
• Boxed cards in the transcript for each send and each result.

<table align="center"> <tr> <td align="center"><img src="docs/assets/screens/running.png" alt="The status line and the hand-off band while a task runs" width="440"><br>_{A task running}</td> <td align="center"><img src="docs/assets/screens/cards.png" alt="Boxed cards in the transcript for a send and its result" width="440"><br>_{Cards in the transcript}</td> </tr> <tr> <td align="center"><img src="docs/assets/screens/wake.png" alt="The message that wakes Claude with a finished task's result" width="440"><br>_{The result lands}</td> <td align="center"><img src="docs/assets/screens/waiting.png" alt="The a2a pane with a task waiting for your reply" width="440"><br>_{A worker asks a question}</td> </tr> </table>

Pick full, pane or minimal in /config to show more or less. The UI has the details.

Use your own agents

/a2a add https://worker.example.com research --token-cmd "pass show research"

The token is read from a command, a file or a setting, and never typed into Claude. Worker tokens covers all three. You can also just ask Claude to add a worker; it shows a dialog, and nothing is added until you approve it.

Learn more

How it works · Write a worker · Troubleshooting · Security · Protocol support

Contributing and license

Contributions are welcome: see CONTRIBUTING.md. To report a vulnerability, see SECURITY.md. MIT licensed: see LICENSE.