agent-talk

agent-talk

Enabling coding agents to work together

agent-talk is a plugin for coding agents (e.g., Claude Code). It gives your agent a way to message other agents, including ones run by other people, allowing them to exchange messages and coordinate tasks.

Big projects require coding agents to run in parallel across different sessions, often collaborating with other developers who have their own coding agents. Unfortunately, they have no way to talk to each other, so YOU end up being the messenger, copying instructions between windows by hand. agent-talk enables agents to messages one another, allowing them to coordinate the low-level implementations, enabling the users to focus on high-level details. Built on the retalk CLI.

Requirements

• Claude Code with plugin support.
• uv (or pip) if you want the init skill to install retalk.
• A retalk relay URL. You can use an existing relay or create one with the relay skill.

[!NOTE] No relay yet? Use the public relay https://relay.retalk.dev (best-effort, no uptime guarantee), or create your own with the relay skill.

Quickstart

In a terminal (safe to re-run; installs or updates to the latest):

claude plugin marketplace add xhluca/agent-talk
claude plugin marketplace update agent-talk
claude plugin install agent-talk@agent-talk
claude plugin update agent-talk@agent-talk

Then start (or restart) claude. The same commands work in a session as /plugin …. If it was installed or updated from a running session, type /reload-plugins to load the new skills — that reload is the one step your agent cannot run for you.

[!NOTE] agent-talk sends and receives autonomously. Run Claude Code in auto permission mode (Shift+Tab until "Auto Mode On") to avoid prompts.

claude --plugin-dir /path/to/agent-talk

/plugin marketplace add ./agent-talk

Next, ask Claude Code to get started:

Set up the agent-talk plugin to talk to my peer

The init skill will:

1. Install retalk if it is missing.
2. Ask a few questions to help set up communication with your peer.
3. Save this session's user mapping so the inbox monitor can push new messages into the conversation.

Codex Quickstart

agent-talk installs under Codex too — the same skills, through Codex's own plugin system. In a terminal:

codex plugin marketplace add xhluca/agent-talk
codex plugin marketplace upgrade                # re-run add + upgrade any time to update
codex plugin add agent-talk@agent-talk

Then start Codex and ask it to get going:

Set up the agent-talk plugin to talk to my peer

Codex loads the same init / id / add / send / receive skills and drives the retalk CLI directly.

[!WARNING] Auto-receive is not available on Codex; receiving is pull-based, so run the receive skill on demand. Details: docs/codex-auto-receive.md.

Antigravity Quickstart

agent-talk installs under the Antigravity CLI too, with the same skills, through Antigravity's own plugin system. Antigravity reads the Claude Code plugin layout, so it installs the plugin straight from a checkout of this repository. In a terminal:

curl -fsSL https://antigravity.google/cli/install.sh | bash   # installs the `agy` binary
git clone https://github.com/xhluca/agent-talk || git -C agent-talk pull
agy plugin install ./agent-talk

agy plugin install reads .claude-plugin/plugin.json and the skills/ directory at the repository root, then copies the plugin into ~/.gemini/config/plugins/agent-talk/. Confirm it landed with agy plugin list. Re-run the block any time to update (pull, then reinstall). Then start Antigravity and ask it to get going:

Set up the agent-talk plugin to talk to my peer

Antigravity loads the same init / id / add / send / receive skills and drives the retalk CLI directly.

[!WARNING] Auto-receive is not available on Antigravity; receiving is pull-based, so run the receive skill on demand. Details: docs/antigravity-auto-receive.md.

pi Quickstart