convez.ai
SkillAutomaçãoIntermediário
javimosch

a2a – Mensageria P2P para Equipes de Agentes IA

javimosch/a2a-skill

Bus de mensageria P2P descentralizado para equipes de agentes IA em Python

Ver no GitHub
BomPluginScore · de 0 a 100

Skill que implementa um barramento de mensageria peer-to-peer descentralizado usando SQLite para coordenação entre múltiplas sessões de agentes CLI (Claude, OpenCode, etc.). Permite que N agentes se comuniquem e colaborem sem orquestrador central, usando apenas um banco de dados compartilhado.

Instalação

$npx convez-ai javimosch/a2a-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
7
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
v1.3.1
Issues abertas
1
Contribuidores
3

Casos de uso

  • Coordenar múltiplas sessões de agentes IA com papéis distintos (arquiteto, desenvolvedor, QA)
  • Comunicação assíncrona entre agentes de coding sem infraestrutura centralizada
  • Simulações de teamwork onde agentes colaboram, debatem e delegam tarefas

Veredito

Solução inovadora e minimalista para coordenação de agentes distribuídos. Elimina fricção em cenários multi-agente ao usar SQLite como transporte, mas requer familiaridade com CLI e pensamento descentralizado.

README

A tradução para o português deste README ainda está na fila.


The problem: Getting multiple AI coding sessions to collaborate means manually copy-pasting context between terminals, or building a custom orchestration layer.

a2a fixes this. Register agents, send messages, let them drive. One SQLite database. Zero infra.


⚡ Quick Start

# 1. Create a project bus
a2a init

# 2. Register two agents
a2a register alice --role architect
a2a register bob   --role developer

# 3. Send messages
a2a send bob "review the auth module" --from alice
a2a recv --as bob --wait 30

# 4. Broadcast to everyone
a2a send all "standup in 5" --from alice

# 5. Check who's on the bus
a2a list

Prerequisite: Python 3 with sqlite3 built-in (standard on 3.8+). Install with ./install.sh — see Install →.


🔀 Three Patterns

All patterns share the same bus at ~/.a2a/{project}/database.db.

#PatternWho drivesBest for
1Human-driven CLI — you type a2a send/recv by handYouLearning the bus, scripting, one-off tasks
2Multi-terminal AI team — open N terminals, give each agent a role, they self-coordinateAI agents (you instruct)Role-based teamwork (dev + architect + QA + PM), debates
3Auto-spawn — one agent spawns N peers via /a2a spawnAI agents (spawned automatically)Fire-and-forget collaboration from inside a coding session

Which one?

  • New to a2a? Start with Pattern 1.
  • Complex problem with clear roles? Pattern 2 — you watch each agent's reasoning live.
  • Inside a Claude Code session? Pattern 3 via /a2a spawn.

🛠️ CLI Cheatsheet

a2a init                                                        # create project bus
a2a register alice --role researcher --prompt "..." --cli pi    # add an addressable peer
a2a register bob   --role critic

a2a send bob "what about Y?" --from alice                       # direct
a2a send all "team sync at noon" --from alice                   # broadcast
a2a send alice "expiring msg" --from bob --ttl 3600             # expires in 1 hour

a2a recv --as bob --wait 30                                     # block-poll inbox (unread only)
a2a recv --as bob --all --include-self                          # all messages including self-sent
a2a recv --as bob --peek                                        # look without marking read
a2a recv --as bob --json                                        # machine-readable output

a2a search "keyword"                                            # full-text search messages
a2a thread <id>                                                 # view a message thread

a2a list                                                        # who's on the bus
a2a stats                                                       # bus statistics
a2a peek                                                        # last 20 messages (observer view)

a2a status done --as alice                                      # update presence
a2a wait --as bob --count 3 --timeout 30                        # block until 3 unread or 30s
a2a unregister alice                                            # remove agent
a2a clear --yes                                                 # wipe the bus
a2a project                                                     # show resolved project info

Project name resolves from --project NAME, then $A2A_PROJECT, then basename($PWD). One project = one database = one isolated bus.


🤖 For AI Agents

a2a was built for agents first.

Each agent gets a peer kit prompt telling it who it is, how to call send/recv/list/status, and the rules (no inventing peers, stay terse, mark done when finished). From there, agents drive themselves.

The /a2a Claude Code skill handles spawning automatically — just type /a2a in a session.

# Agent workflow inside a Claude Code session
/a2a spawn dev architect qa --project myapp
# → three background sessions registered on the bus, collaborating

Cross-CLI support: a2a-spawn handles flag differences for claude, opencode, and pi — every agent gets the same kit prompt regardless of CLI.

See .agents/skills/a2a/SKILL.md for the full skill architecture and spawn protocol.


📦 Install

./install.sh

Links a2a and a2a-spawn into ~/.local/bin/, and the skill into ~/.claude/skills/ and ~/.agents/skills/. Restart your CLI session afterwards.

Or manually:

ln -sf "$PWD/a2a"      ~/.local/bin/a2a
ln -sf "$PWD/a2a-spawn" ~/.local/bin/a2a-spawn
ln -sf "$PWD"          ~/.claude/skills/a2a    # exposes /a2a in Claude Code
ln -sf "$PWD"          ~/.agents/skills/a2a    # cross-CLI

📖 Docs

Client libraries also available for Go, Node.js, and Rust.


🔩 Design Notes

  • Stdlib only — a2a.py runs on any Python 3 with a built-in sqlite3. No dependencies.
  • WAL mode — multiple concurrent agents read/write safely.
  • Read-tracking is per-agent — broadcasts are seen once by each peer.
  • No locking primitives — coordination is by convention (the kit prompt), not the bus. Agents can step on each other; that's the point.
  • Persistent by default — the database survives between runs. Use a2a clear --yes to reset.

License

MIT — Javier Leandro Arancibia

Ver o original no GitHub

Bom para

Relacionados