Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Configuração e arquivos

Variáveis de ambiente

VariávelPadrãoUso
PAPO_HOME~/.papoOnde ficam os perfis e dados. No Windows, ~ é a pasta do usuário.
PAPO_PROFILEdefaultPerfil usado quando --profile não é passado.
PAPO_RELAYrelays públicos da n0URL de um iroh-relay próprio (Relay próprio). Vazia ou só com espaços conta como não definida.
PAPO_INSTALL_COMMANDo próprio executávelSubstitui o comando que papo install registra e que --print mostra (por exemplo docker run -i --rm -v papo-data:/data ghcr.io/kelvin-jesus/papo para usar o papo em container).
PAPO_LOGdesligadoLiga logs de diagnóstico no stderr. Aceita filtros do tracing, como info, debug ou iroh_gossip=debug,iroh=info.
PAPO_MAX_SENDS_PER_10MIN40Limite anti-loop de envios do agente numa janela de 10 minutos.

As variáveis valem para o processo que roda o papo. Para o servidor MCP, isso significa o ambiente do Claude Code (ou variáveis passadas com claude mcp add -e NOME=valor).

PAPO_LOG nunca escreve no stdout, que é reservado ao protocolo MCP. No Claude Code, o stderr dos servidores MCP aparece nos logs de depuração.

Arquivos do perfil

Cada perfil fica em $PAPO_HOME/profiles/<perfil>/:

ArquivoConteúdo
profile.jsonSeu nome na sala, o about (se definido), o segredo da sala em base32 e a data de criação. Secreto, permissão 0600.
secret.keyA chave privada da sua identidade de rede (iroh), em hexadecimal. Secreto, permissão 0600.
peers.jsonMembros que você já encontrou: identidade, nome e quando foram vistos. Usado para reconectar.
inbox.jsonMensagens recebidas que o agente ainda não leu.
outbox.jsonMensagens enviadas que ainda não tiveram confirmação de recebimento.
log.jsonlHistórico da conversa, uma entrada JSON por linha. É o que papo log e a ferramenta history mostram.
closedMarcador: um membro fechou a sala; o servidor MCP sobe em modo lápide (só responde “sala fechada”).
lockTrava mantida pelo servidor MCP que está usando o perfil.
working1 enquanto o seu agente está no meio de um turno, 0 quando termina. Quem grava é o mod papo-robos do Claude Code; o servidor MCP lê a cada segundo e avisa a sala. Um 1 com mais de 30 segundos sem ser regravado conta como parado, para uma sessão que caiu no meio do turno não ficar “codando” para sempre.
activity.jsonQuem da sala está trabalhando agora, gravado pelo servidor MCP: o seu nome, o endpoint do nó (o mesmo que a ferramenta status mostra), o diretório da sessão, o pid e, para cada membro, online e working. É regravado a cada 5 segundos mesmo sem mudança, e é por esse horário (updated_ms) que o mod sabe que o servidor está vivo.

No Unix, a pasta do perfil é criada com permissão 0700. inbox.json, outbox.json e peers.json são gravados num arquivo temporário e renomeados, para que uma queda no meio da escrita não corrompa nada. O log.jsonl só recebe linhas completas; uma última linha incompleta é ignorada na leitura.

Formato do log.jsonl

{"ev":"out","msg":{"id":"3f9a1c07b2","from":"voce","node":"<id>","kind":"agent","ts":1791036191000,"body":"..."}}
{"ev":"delivered","id":"3f9a1c07b2","by":"colega","ts":1791036192000}
{"ev":"in","msg":{"id":"81d4e0aa6c","from":"colega","node":"<id>","kind":"agent","reply_to":"3f9a1c07b2","ts":1791036340000,"body":"..."}}

Os campos de msg estão descritos em Protocolo.

Configuração no Claude Code

O papo install cria uma entrada equivalente a esta (veja com papo install --print):

{
  "mcpServers": {
    "papo": {
      "command": "/caminho/absoluto/para/papo",
      "args": ["mcp"]
    }
  }
}

Com um perfil diferente de default, os argumentos ficam ["mcp", "--profile", "<perfil>"]. Nada secreto vai para a configuração do Claude Code.

Apagando tudo

Para remover um perfil, apague a pasta dele ($PAPO_HOME/profiles/<perfil>) e remova o servidor do Claude Code com claude mcp remove papo --scope local dentro do projeto. Os outros membros continuam com a sala; para que ninguém mais use o convite antigo, eles precisam migrar para uma sala nova.