К основному содержанию
плагин CX Codex

amq-cli — плагин для Claude Code: обмен сообщениями агентов

Плагин amq-cli связывает кодинг-агентов через локальную файловую очередь: они могут отправлять запросы, читать ответы и продолжать переписку в одной ветке.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install amq-cli@awesome-codex-plugins
Открыть на GitHub

Что делает amq-cli

AMQ передаёт сообщения между агентами через общую локальную директорию. У каждого агента есть входящие и исходящие сообщения; команда list показывает новые, а drain читает их и записывает квитанции. Ответ можно отправить в ту же ветку по ID сообщения. Это пригодится, например, когда один агент просит другой проверить код.

Сообщение состоит из JSON-заголовка и Markdown-текста. AMQ сначала записывает временный файл, затем публикует его переименованием, чтобы получатель не увидел частично записанное сообщение. Очередь не требует сервера сообщений или базы данных. Это локальная координация, а не распределённый брокер; обмен между хостами вынесен в дополнительный bridge-компаньон.

Для настройки проекта нужны установленные CLI агентов и claude с codex в PATH; запуск через amq launch поддерживает tmux, cmux, ghostty или backend commands. Уведомление лишь просит агента проверить входящие, оно не подтверждает, что тот прочитал или выполнил запрос. Плагин доступен для Claude Code и Codex.

Какие задачи решает

  • передать агенту запрос на проверку кода
  • прочитать новые сообщения и получить квитанции
  • ответить в ветке по ID сообщения
  • разделить переписку между сессиями агентов

Примеры запросов агенту

  • Попроси Codex проверить парсер и отправь запрос через AMQ.
  • Покажи новые сообщения AMQ и прочитай их вместе с текстом.
  • Ответь на сообщение AMQ в той же ветке по его ID.

Как установить amq-cli

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install amq-cli@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы об amq-cli

Как установить amq-cli в Claude Code?

В Claude Code добавь маркетплейс командой /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем установи плагин командой /plugin install amq-cli@awesome-codex-plugins.

Что делает amq-cli?

Он передаёт сообщения между кодинг-агентами через локальную файловую очередь. Агент может прочитать запрос, отправить ответ в той же ветке и оставить квитанцию о прочтении.

Нужен ли сервер сообщений для работы AMQ?

Нет, локальная очередь хранится в файлах и не требует сервера сообщений или базы данных. Для обмена между хостами предусмотрен дополнительный bridge-компаньон.

Исходный текст

agent-message-queue · MIT
# Agent Message Queue (AMQ)

**Messaging between coding agents.**

[![CI](https://github.com/avivsinai/agent-message-queue/actions/workflows/ci.yml/badge.svg)](https://github.com/avivsinai/agent-message-queue/actions/workflows/ci.yml)
[![Release](https://img.shields.io/github/v/release/avivsinai/agent-message-queue)](https://github.com/avivsinai/agent-message-queue/releases/latest)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

AMQ lets two coding agents exchange messages through a shared directory.
One agent asks for a review; the other reads the message and replies in the
same thread. Messages are plain files, so the local queue needs no messaging
server or database—and you do not have to relay each request yourself.

Try the queue in a fresh shell on macOS. This example uses two mailbox names;
it does not start agents. [Other installation methods →](INSTALL.md)

```bash
brew install avivsinai/tap/amq
amq init --root .agent-mail/demo --agents alice,bob  # Create two mailboxes for demo.
amq send --root .agent-mail/demo --me alice --to bob --body "Please review the parser."
amq drain --root .agent-mail/demo --me bob --include-body
```

![AMQ terminal messaging demo](docs/assets/demo.gif)

- **Keep the conversation together.** Reply in threads, attach context, and
  route messages between sessions or projects.
- **Know what happened to a message.** Receipts distinguish a queued message
  from one the recipient drained.
- **Bring your own agents.** Use the CLI from agent tools or scripts;
  optional wake notifications prompt running agents to check their inboxes.
- **Keep control of the workflow.** AMQ handles messages. You and your
  orchestration tools own tasks, worktrees, permissions, and merges.

<a id="quick-start"></a>

## Getting started

This walkthrough connects **Claude Code** and **Codex CLI** on one machine.
Install both agent CLIs and put `claude` and `codex` on `PATH` first.
Use macOS, Linux, or WSL; native Windows supports a subset (see the
[platform matrix](INSTALL.md#platform-capability-matrix)).

### 1. Install the binary

On macOS:

```bash
brew install avivsinai/tap/amq
```

On Linux, or without Homebrew, use the installer script or a release
download from [Installation](INSTALL.md#binary-installation). Confirm the
install with `amq --version`.

### 2. Install Skill

Install the agent instructions so each agent knows how to use AMQ:

```bash
npx skills add avivsinai/agent-message-queue -g -y
```

Restart the agents after installing. [Other skill installation methods](INSTALL.md)
are available if you do not use npm. agy (Antigravity CLI) reads skills from
`~/.gemini/config/skills`, so copy the skill there as INSTALL.md shows.

### 3. Set up the project

In the repository where the agents will work:

```bash
amq setup
```

Select the agents and launcher, then confirm the preview. Setup writes the
project configuration and creates the default session and its mailboxes.
An agent's handle is its harness name (`claude`, `codex`) unless you enter
`handle=harness`, for example `reviewer=claude`. Only the handle goes into the
roster and the mailboxes.

### 4. Start both agents

```bash
amq launch
```

The first launch asks you to trust the launch plan. With `tmux`, `cmux`, or
`ghostty`, AMQ starts the agents in that terminal app. With the `commands`
backend, it prints one command per agent and exits with code `6` (action
required). Paste each complete command into a separate terminal; do not
shorten or rebuild it.

By default the wake rings a plain doorbell (text and Enter) on every harness,
so it always rings; a doorbell that lands on an open dialog can answer it.
Optional, for Claude Code: `amq wake install-dialog-hook` keeps the wake from
typing into an open AskUserQuestion, plan, or permission dialog. Add
`--harness codex` (then trust the entries in Codex `/hooks`) or
`--harness cursor` (or `--harness all`) for their approval prompts.
`amq coop exec` prints `dialog guard: plain` or
`dialog guard: proper (<harness>)` to show which one a seat gets.

Start both agents before sending the first message. Messages that arrive
before a recipient's wake starts remain unread but do not trigger that new
wake. The recipient can still get them with `amq drain --include-body`.

<a id="messaging"></a>

### 5. Exchange a message

Ask Claude to run this command through its shell tool:

```bash
amq send --to codex --subject "Hello" --body "Can you see this?"
```

Ask Codex to check its inbox if it has not already responded to the notification:

```bash
amq list --new
amq drain --include-body
```

`list` previews new messages. `drain` reads them, moves them out of the new
inbox, and writes receipts. The output includes the sender and message body.
To reply in the same thread, use the ID from that output:

```bash
amq reply --id "<message-id>" --body "Yes, I can see it."
```

The launched agents already have their identity and session set. You do not
need to repeat `--me` or `--root` inside those sessions.

## How it works

Each agent has an inbox and an outbox under a local queue root. A message
contains a JSON header and a Markdown body. AMQ writes and syncs a temporary
file, then publishes it with a rename: a reader sees a complete message or
no message, not a partly written body.

A session is a separate queue. Routing checks help prevent a shell pinned
to one session from changing another by mistake. A wake notification asks an
agent to check its inbox; it is not evidence that the agent read or completed
the request. See [routing](docs/session-routing.md) and
[message tracing](docs/trace.md) for those contracts.

Optional [priority holds](docs/wake-operations.md#hold-by-priority) can delay
the first notification for routine mail while urgent mail skips the hold. Wake
[live settings](docs/wake-operations.md#live-settings) have a machine default
for this user (`amq wake config --machine --hold-normal 5m`) and per-agent
overrides; use `amq wake config --me <handle> --hold-normal 5m` to change a
running wake.

AMQ is for local agent coordination, not a distributed broker. The optional
[bridge companion](cmd/amq-bridge/README.md) exchanges messages between hosts;
each host keeps control of its own queue.

## Remote control

The optional [remote companion](cmd/amq-remote/README.md) gives a running
Claude Code or Codex session its own private Buzz channel, so you can write to
that session from the Buzz app or Buzz Desktop. One Buzz agent per machine,
imported once, makes each channel. Inside the session, type `/amq-remote`
(in Codex, `$amq-remote`); `/amq-remote off` disconnects it. Setup, commands,
and the trust model are in that README.

## Documentation

| I want to… | Read |
| --- | --- |
| Install, update, or use another platform | [Installation](INSTALL.md) |
| Run agent pairs, isolate sessions, or supervise notifications | [Co-op operations](COOP.md) |
| Batch routine wake notifications by priority | [Wake operations](docs/wake-operations.md#hold-by-priority) |
| Look up a command or flag | [CLI reference](docs/cli.md) |
| Diagnose delivery or wake problems | [Wake operations](docs/wake-operations.md) · [Trace](docs/trace.md) |
| Attach to a running harness session | [amq-remote](cmd/amq-remote/README.md) |
| Build an integration or understand the design | [Documentation index](docs/README.md) |
| Understand the trust model | [Security](SECURITY.md) |

<a id="extension-metadata"></a>

Building on AMQ? Use the [adapter contract](docs/adapter-contract.md),
[launch API](docs/launch-api.md), and [extension metadata](docs/adr-layer-extensions.md).
[amq-squad](https://github.com/omriariav/amq-squad) is a role-aware team launcher
built on these primitives.

## Contributing

See the [contribution guide](CONTRIBUTING.md) for development and review.
Contributor clones should install the git hooks
(`./scripts/install-hooks.sh`) so pushes run the static checks locally.
Use [GitHub issues](https://github.com/avivsinai/agent-message-queue/issues)
for questions and bug reports. Follow the [code of conduct](CODE_OF_CONDUCT.md)
and report security issues through the [security policy](SECURITY.md).

## License

[MIT](LICENSE).

© Aviv Sinai · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
agent-messaging davila7 Скилл agent-messaging для Claude Code, настраивает защищённый обмен сообщениями между ИИ-агентами по протоколу AMP. Передаёт задачи другим агентам и разбирает входящие письма. CX Codex +1 247установок join-talk sno-ai Скилл join-talk для Claude Code регистрирует текущий диалог и терминал в Reach. Запускается по просьбе подключить агента или сделать его доступным для сообщений и вызовов. CX Codex +1 ★ 869звёзд репо Claude Bridge constripacity MCP-сервер Claude Bridge передаёт сообщения между сессиями ИИ-агентов через каналы и хранит историю в SQLite. Подходит для обмена задачами и результатами между разными машинами. CX Codex +1 ★ 15звёзд репо YAAC amyodov YAAC — MCP-сервер для Claude Code, который связывает параллельные сессии ИИ-кодинга через общий чат. Сессии могут передавать друг другу изменения и сообщения о ходе задач. CX Codex +1 ★ 5звёзд репо discernment-nudge официальный anthropics Плагин discernment-nudge для Claude Code и Claude.ai, который добавляет два-три коротких вопроса после развёрнутого ответа. Помогает проверить факты, разобрать логику и заметить, чего не хватает в рассуждении. ★ 198 522звёзд репо example-skills официальный anthropics Плагин example-skills для Claude Code и Claude.ai с набором примеров скиллов. Показывает, как строить скиллы, MCP-серверы, артефакты, тесты веб-приложений и внутренние коммуникации. ★ 198 522звёзд репо impeccable pbakaus Плагин impeccable для Claude Code, который даёт агенту словарь дизайнера и 24 команды для работы с интерфейсами. Запускается на каждом этапе: от сбора контекста проекта до финальной полировки перед релизом. ★ 114 575звёзд репо superpowers obra Плагин superpowers для Claude Code и Codex, который учит агента работать по полной методологии: сбор требований, проектирование, TDD и разработка через субагентов. Запускается автоматически, когда ты начинаешь строить что-то новое. CX Codex ★ 323 788звёзд репо

Из того же набора391

Весь набор →
agentmart Плагин agentmart подключает удалённый MCP-сервер с готовой инфраструктурой для агентов: очередями, вебхуками и хранилищем памяти. Выручает, когда проекту нужны фоновые сервисы вне активной сессии. CX Codex ★ 1 596звёзд репо agentgram Плагин agentgram для Claude Code и Codex отправляет сообщения и файлы в Telegram через бота. Агент также может читать пересланные боту сообщения. CX Codex ★ 1 596звёзд репо agentdomains Плагин agentdomains даёт агенту публичное имя вида имя.makes.fyi и управление DNS-записями через CLI — когда нужно поднять сайт, вебхук или сервер. CX Codex ★ 1 596звёзд репо agent-vision Плагин agent-vision для macOS подключает встроенную камеру Mac к диалогу с агентом через разовые снимки JPEG. CX Codex ★ 1 596звёзд репо abuzzhive Подключает агента к публичным Q&A-доскам AbuzzHive, где агенты публикуют ошибки и предлагают друг другу решения. Хук автоматически предлагает find_by_error после каждой упавшей shell-команды. CX Codex ★ 1 596звёзд репо call-me Плагин call-me связывает агента с телефоном на iOS или Android: агент звонит голосом или отправляет пуш, а ответ возвращает текстом прямо в сессию. CX Codex ★ 1 596звёзд репо codex-zcode-bridge Плагин codex-zcode-bridge для Claude Code и Codex передаёт задачу из Codex локальному ZCode и возвращает ход работы для проверки изменений и сверки результата с критериями приёмки. CX Codex ★ 1 596звёзд репо zagrosi-forge Плагин zagrosi-forge для Claude Code делит большой бриф на спецификации, строит план по секциям и пишет код по TDD с записями о проверках. Разбивает задачи, которые не помещаются в один заход. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой