Przejdź do treści
Biblioteka skilli
AI i agenci · Integracja z narzędziem

agent-message-broker

/agent-message-broker

Subskrybuje działające sesje agentów kodujących na zdarzenia ze świata (GitHub, Jira, Google Workspace, odpytywane adresy URL, webhooki) przez CLI amb i reaguje na zdarzenia dostarczane w trakcie sesji.

Licencja
MIT
Ostatnia zmiana repozytorium
09.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 09.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Subskrybuje działające sesje agentów kodujących na zdarzenia ze świata (GitHub, Jira, Google Workspace, odpytywane adresy URL, webhooki) przez CLI amb i reaguje na zdarzenia dostarczane w trakcie sesji.

Oryginalny opis (EN)

Subscribe running coding-agent sessions to real-world event topics (GitHub, Jira, Google Workspace, polled URLs, webhooks) via the amb CLI, and react to events the broker delivers mid-session. Use when an amb event arrives in this session, or when the user asks to wire an event source or topic to an agent session.

Jak działa

  1. Prerequisites
  2. When an event arrives in this session
  3. Discovering state
  4. Subscribing this session to a topic
  5. Credentials for event sources
  6. Design rules to respect
Sekcje z nagłówków SKILL.md, w oryginale · 81 linii, 565 słów
Podgląd SKILL.md
---
name: agent-message-broker
description: Subscribe running coding-agent sessions to real-world event topics (GitHub, Jira, Google Workspace, polled URLs, webhooks) via the amb CLI, and react to events the broker delivers mid-session. Use when an amb event arrives in this session, or when the user asks to wire an event source or topic to an agent session.
---

# agent-message-broker (amb)

amb is a local pub/sub broker that routes external events into running coding-agent sessions. Event sources publish to **topics**; **subscriptions** bind a topic to a live agent session and render each event with a template. Everything is available over the `amb` CLI — you can wire sources and subscribe yourself without any UI.

## Prerequisites

- Node >= 22.5. The CLI is `amb` (or `npx agent-message-broker …`).
- The broker must be running locally at `http://127.0.0.1:4733`. Check with:

```bash
amb doctor          # broker health + registered agent kinds
```

If it is not running, tell the user; start it only if asked (`npx agent-message-broker`).

- CLI auth is automatic: the broker's bearer token lives at
  `~/.config/agent-message-broker/token` (mode 0600) and the CLI picks it up.
  Never print or exfiltrate this token.

## When an event arrives in this session

Events are delivered as rendered text from the subscription's template — `{{kind}}` is the event type, `{{payload}}` its JSON. The frame may be mid-conversation (steered into your active turn). React in the current conversation:

1. Parse the intent from `kind` and `payload` (do not ask the user to re-paste it).
2. If you need more history, inspect the topic: `amb events list --topic <name> --limit 20`.
3. Act on the event (the event usually names a concrete artifact: a PR, ticket, doc, URL).
4. Keep going; do not stop and wait unless the event is genuinely ambiguous.

## Discovering state

```bash
amb topics list                       # existing topics + retention
amb sources list                      # wired sources per topic
amb sources running                   # which feeds are actively polling
amb sessions                          # live agent sessions visible to the broker
amb events list --topic <idOrName>    # recent retained events (replay window)
amb deliveries [eventId]              # audit delivery attempts per event
```

Events persist per-topic up to `retainN` even with zero subscribers, so a new subscription can replay the recent window — you never need to ask the user "what did I miss" if it is within retention.

## Subscribing this session to a topic

If a topic already exists, one command suffices (get your session id from `amb sessions` or ask the user):

```bash
amb subscriptions create --topic <idOrName> --agent pi|claude|codex --session <sessionId> \
  --template "PR event {{kind}}: {{payload}}"
```

To create the whole wiring from scratch:

```bash
amb topics create <name> --retain 100
amb sources create --topic <name> --kind <kind> --options '{…}'
amb sources start <sourceId>          # sources start stopped; this begins polling
```

Source kinds and their `--options` JSON: see [references/sources.md](references/sources.md).
Delivery mechanisms per agent kind and the delivery audit model: see [references/delivery.md](references/delivery.md).

## Credentials for event sources

Vendors are polled with the developer's own credentials, scaffolded once:

```bash
amb config init --kind github   # then fill ~/.amb/github/credentials.json
amb config init --kind jira     # → ~/.amb/jira/credentials.json (email, apiToken, domain)
amb config init --kind google   # service-account JSON, or `amb google login` for OAuth
```

If a source fails auth, point the user at the relevant `~/.amb/<kind>/credentials.json` — do not attempt to create vendor credentials yourself.

## Design rules to respect

- Prefer an existing topic/source over creating a duplicate; list first.
- Choose `intervalMs` conservatively (60s+ for most feeds) — this is a local machine.
- Use `--template` to make delivered frames self-describing; the payload is raw JSON.
- Webhook delivery is an opt-in tier (requires a tunnel); polling is the default and needs nothing internet-reachable.
Pliki w paczce (3)
  • SKILL.md 4 KB
  • references/delivery.md 2 KB
  • references/sources.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie agent-message-broker.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki d57e18283e2d (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90amb-bot-dev
    Tworzy lub zmienia bota katalogowego AnyModelBot z własnym interfejsem i naprawia bota, który nie przechodzi sprawdzenia.
  • 100agent-session-control
    Uruchamia i obserwuje lokalne sesje agentów kodujących przez CLI agent-session-control: planuje lub hostuje sesję, wysyła jedną turę i śledzi przebieg.
  • 100claude-peers
    Wykrywa, wysyła wiadomości i koordynuje agentów kodujących AI (Claude Code, Codex CLI) na jednej maszynie przez broker Unix socket z SQLite, w tym delegowanie zadań między sesjami.
  • 100claude-code-session-broker
    Koordynuje przez brokera stałe sesje ról Planner, Developer i Auditor podczas pracy z Arcgentic V2 w Claude Code.
  • 100cloud-pilot
    Przekazuje w Claude Code pracę do sesji w chmurze, gdy zadanie ma kilka kroków i długie testy, i obsługuje zdarzenia w trakcie czekania.
  • 100wire-pi
    Pozwala działać jako agent Wire w sesji Pi: rozmawiać z innym agentem, czytać skrzynkę i parować sesje za zgodą.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.