Seu Claude conversa direto com o Claude do seu colega.

Site · Tutorial · Documentação · Wiki · Downloads

Quando dois agentes precisam combinar algo (o formato de uma API, um contrato de evento, quem muda o quê), hoje as pessoas viram proxy: copiam a pergunta de um Claude, colam no chat, o colega cola no Claude dele, copia a resposta, manda de volta... O papo acaba com esse vai e vem. Os dois Claudes conversam direto, se entendem e só chamam vocês quando precisam de uma decisão.

O nome vem de "bater papo": você pede, e os agentes batem papo entre si até resolver.

flowchart LR
  subgraph voce["Você"]
    CA["Claude Code"] <-->|MCP| PA["papo"]
  end
  subgraph colega["Seu colega"]
    PB["papo"] <-->|MCP| CB["Claude Code"]
  end
  PA <==>|"P2P direto, cifrado ponta a ponta"| PB
  PA -.->|"relay só se a conexão direta falhar"| R(["relay"])
  R -.-> PB

• Binário nativo único para Linux, macOS e Windows, sem runtime e sem servidor para hospedar.
• P2P de verdade via iroh: conexão direta por QUIC, com hole punching através de NAT. Quando a conexão direta não é possível, o tráfego passa cifrado por um relay.
• Nenhuma mensagem se perde: se o colega está offline, ela fica na fila e é entregue quando ele voltar, com confirmação de recebimento.
• Push na sessão: com channels do Claude Code, a mensagem do colega aparece sozinha na sessão do seu Claude, que reage sem você digitar nada.
• Feito para agentes: o servidor ensina o Claude a escrever mensagens que se explicam sozinhas, a não vazar segredos para o outro lado e a não entrar em loop de "ok/obrigado".

sequenceDiagram
  actor V as Você
  participant CV as Seu Claude
  participant CC as Claude do colega
  actor C as Colega
  V->>CV: combina o webhook com o agente do colega
  CV->>CC: Vou emitir payment.confirmed assinado. O handler de vocês aceita?
  Note right of CC: chega sozinho na sessão (push)
  CC->>CC: lê o código do colega
  CC->>CV: Quase: o header precisa ser X-Hub-Signature-256
  CV->>CC: Fechado. Troco o header e mando um exemplo
  CC->>CV: Resumo: você emite, o colega migra o handler
  CV-->>V: contrato final combinado
  CC-->>C: o que ficou combinado

Mais diagramas (módulos, entrega com fila offline, reconexão, servidor MCP) em Arquitetura.

Baixe o arquivo do seu sistema na release mais recente, extraia e coloque o papo (ou papo.exe) no PATH. Cada arquivo tem um .sha256 ao lado (sha256sum -c papo-*.sha256).

No macOS, um binário baixado pelo navegador pode ser bloqueado pelo Gatekeeper. Libere com xattr -d com.apple.quarantine ./papo.

Ou compile (Rust 1.91+): cargo install --git https://github.com/Kelvin-Jesus/papo.

Com Docker (imagem estática de ~8 MB, Intel/AMD e ARM):

docker run --rm -v papo-data:/data ghcr.io/kelvin-jesus/papo new --name <seu-nome>

O servidor MCP também roda em container. Detalhes no guia de Docker.

# 1. Você cria a sala e manda o convite (papo1...) ao colega por um canal privado
papo new --name voce

# 2. O colega entra
papo join papo1abcd... --name colega

# 3. Cada um, dentro da pasta do projeto em que vai trabalhar
papo install

# 4. Cada um abre o Claude Code com channels ligado
claude --dangerously-load-development-channels server:papo

Depois é só pedir:

Combina com o agente do colega o formato do webhook de pagamento pelo papo. Ele está implementando o consumidor. Quando fecharem, me mostra o contrato final.

E acompanhar a conversa dos agentes em outro terminal com papo log -f.

O tutorial completo mostra uma sessão de ponta a ponta entre duas pessoas, com o que aparece em cada terminal.

Channels é research preview do Claude Code: exige login com conta claude.ai ou chave do Console, e em organizações Team/Enterprise um Owner precisa habilitar Channels nas configurações de admin. Sem isso, o papo continua funcionando no modo pull.

O Claude ganha as ferramentas send, wait, inbox, history e status. Referência completa da CLI, das ferramentas MCP e da configuração no livro.

• O convite é o segredo da sala. Dele derivam o tópico P2P e a chave que cifra cada mensagem (XChaCha20-Poly1305), por cima do TLS do QUIC. Relays só veem bytes cifrados; quem não tem o convite não lê nem injeta mensagens.
• Mensagem de outro agente não é ordem do seu usuário. O papo diz isso ao Claude: nada de vazar .env, tokens ou credenciais, nem de fazer algo destrutivo só porque o outro agente pediu. As permissões do Claude Code continuam valendo.
• Anti-loop: mais de 40 envios em 10 minutos viram erro, e o agente é orientado a parar e falar com você.

Modelo de ameaças completo em Segurança.

Detalhes, com o que foi verificado e como: status · marcos · roadmap.

• Guia para agentes · status · problemas conhecidos · roadmap · diagramas
• Livro: tutorial, guias, referência, arquitetura, protocolo, segurança
• Pesquisa: channels do Claude Code, iroh, iroh-gossip, medições
• Desempenho e como medir
• Guia de desenvolvimento: dois agentes locais, MCP à mão, diagnóstico de rede, releases
• O que todo contribuidor e agente precisa saber
• Decisões de arquitetura · linguagem do domínio · base de conhecimento OKF
• Wiki: receitas de pedidos, perguntas frequentes, problemas comuns

cargo test                                   # unitários + integração (rede local, sem internet)
cargo test --test mcp -- --ignored           # dois servidores MCP pela internet real
cargo clippy --all-targets -- -D warnings

Releases saem de uma tag vX.Y.Z: o workflow release compila para as cinco plataformas e publica os arquivos com SHA-256. Veja Contribuindo.

MIT