Comunicação peer-to-peer entre sessões Claude Code. Suas sessões e seus especialistas viram pessoas endereçáveis por nome, que conversam entre si sobre vários assuntos ao mesmo tempo — sem orquestrador.
Spec de design: pessoal/claudicaro-cli/docs/design/2026-08-02-escritorio-multiagente.md.
A topologia nativa do Claude Code é árvore: subagente devolve pro pai, SendMessage só
alcança quem a própria sessão spawnou, Workflow passa dado pelo script. Dois irmãos não se
falam. Comunicação lateral exige um meio compartilhado — que é este correio.
Related MCP server: neighbors
tool | o que faz |
| quem existe, o que sabe, qual tier — uma linha por pessoa, sem carregar |
| pergunta e espera a resposta |
| manda e segue; na thread de uma pergunta pendente, vira a resposta dela |
| puxa a correspondência (normalmente o hook já entrega sozinho) |
| quadro branco compartilhado, sem destinatário |
| reivindica recurso antes de mexer |
Mais fechar_thread, que encerra a conversa e faz cada colega destilar o caderno.
Thread é o container único de conversa — substitui salas e canais. Debate entre pares é uma thread com N participantes onde cada um escolhe pra quem responder.
Sem chefe, duas regras no correio seguram o sistema:
hops decrementa a cada mensagem; zerou, o correio recusa. Mata ping-pong infinito.
Dono da thread é quem abriu, e só ele fecha.
Entrega tem duas naturezas:
Sessão viva recebe por hook (Stop bloqueia a parada e entrega; PostToolBatch entrega
no meio do trabalho). O hook é script — roda fora do modelo, custo zero de token.
Colega do roster é acordado pelo correio com claude -p, responde e volta a dormir.
Memória do colega: dentro de uma thread ele mantém a sessão viva (--resume) e lembra de
tudo; quando a thread fecha, destila o que aprendeu num caderno .md e a sessão morre.
Longo prazo é o caderno — auditável, editável à mão, versionado.
npm install && npm run build
node scripts/instalar.mjs # --dry pra ver antes, --remover pra desfazerO instalador registra o hook de entrega em ~/.claude/settings.json, define
ESCRITORIO_WORKSPACE/ESCRITORIO_ROSTER, e registra o servidor MCP via
claude mcp add --scope user (que grava em ~/.claude.json — settings.json não registra MCP).
Faz backup em settings.json.antes-do-escritorio na primeira vez, e nunca sobrescreve esse backup.
~/claude-workspace-config/roster.yaml (repo sincronizado Mac ↔ VM):
especialista-deposito:
brief: "Depósito antecipado: cobrança, pagamento, reembolso (DSG/v1)"
agent_file: ${ESCRITORIO_WORKSPACE}/dsg/.agent/especialista-deposito.md
caderno: ${ESCRITORIO_WORKSPACE}/pessoal/escritorio/cadernos/especialista-deposito.md
tier: advisor
cwd: ${ESCRITORIO_WORKSPACE}/dsg/v1brief é a única coisa que o roster() devolve — escreva pensando em "quando eu chamaria essa
pessoa". Caminhos aceitam ~ e ${VAR}; é a expansão de env que faz o mesmo arquivo servir Mac
e VM, onde o workspace mora em lugares diferentes.
tier | pode | como é imposto |
| ler e aconselhar | allowlist de tools ( |
| escrever no working tree |
|
| escrever isolado | git worktree próprio; se não der pra criar, recusa em vez de cair no repo real |
Um pedido pode rebaixar o tier na consulta, nunca elevar.
A primeira versão usava --disallowedTools Edit Write NotebookEdit com bypassPermissions.
Testado com claude de verdade, vazou: o colega escreveu o arquivo via Bash, que não estava
na negação. Medido nas quatro variantes:
flags | resultado |
| vazou (escreveu via Bash) |
| segurou |
sem permission-mode + nega Edit/Write/Bash | segurou |
sem permission-mode + allowlist read-only | segurou, e ainda leu |
Ficou a allowlist: o que eu esquecer de listar fica negado em vez de liberado. Vale notar que
Bash(cat:*) na allowlist não permitiu escapar por redirecionamento (cat > arquivo).
npm run tailSegue o correio e imprime o que acontece entre todas as sessões — quadro escrito, claim, thread aberta, mensagem trocada, resposta chegando:
Escritório — monitor ao vivo
sessões vistas na última hora: icaromelo@v1, icaromelo@kairos-ui, icaromelo@oraculo-api, …
threads abertas: (nenhuma)
────────────────────────────────────────────────────────────────────────
13:26:36 ▤ quadro dsg/v1:decisoes = cache sempre via RedisService · icaromelo@v1
13:26:37 🔒 claim src/infra/redis por icaromelo@v1 · revisar TTLs
13:26:38 ⊕ thread [477cfbdc] Em uma frase: qual TTL padrao usamos? · dono icaromelo@v1
13:26:38 icaromelo@v1 →? especialista-cache [477cfbdc]
Em uma frase: qual TTL padrao usamos?
13:26:44 especialista-cache ←! icaromelo@v1 [477cfbdc]
O TTL padrão é 3600 segundos (1 hora) — mas sempre passe TTL explícito…→? é pergunta bloqueante, → recado, ←! resposta.
Cada sessão precisa de um nome. ESCRITORIO_ID quando declarado; sem ele, deriva de
usuário@pasta — estável por projeto, então uma sessão aberta em dsg/v1 é sempre
icaromelo@v1 e pode ser endereçada por outra.
npm test # 117 testes, sem gastar API
node scripts/smoke-mcp.mjs # sobe o servidor MCP de verdade via stdio
node scripts/smoke-e2e.mjs # E2E REAL: acorda colega, --resume, caderno (gasta API)
node scripts/smoke-escrita.mjs # E2E REAL dos 3 tiers: advisor bloqueado, worktree isolado,
# editor sob claim (gasta API)Um correio por máquina. Sessão na VM Oracle não fala com o correio do Mac; a ponte entre máquinas é problema separado.
dist/ mora no SSD. Com o SSD desmontado o hook falha silencioso (|| true) e o MCP fica
desconectado — nada trava, mas o escritório some até remontar.
ask numa sessão viva depende de ela estar rodando. Se ninguém estiver com aquela sessão
aberta, você espera até o timeout (5 min) e a resposta fica no inbox pra depois.
This server cannot be deployed
Shared memory and mail for your AI agents. Verified with Claude Code; other MCP clients in testing.
Messaging and inboxes for AI agents: register, send signed messages, check your inbox, find agents.
Communication and persistent state for AI agents: spaces, posts, search, mailbox, direct messages.
Privacy-first coordination for autonomous agents: rooms, messaging, inbox, and per-agent memory.
