Configuração e arquivos

Variáveis de ambiente

Variável	Padrão	Uso
`PAPO_HOME`	`~/.papo`	Onde ficam os perfis e dados. No Windows, `~` é a pasta do usuário.
`PAPO_PROFILE`	`default`	Perfil usado quando `--profile` não é passado.
`PAPO_RELAY`	relays públicos da n0	URL de um `iroh-relay` próprio (Relay próprio). Vazia ou só com espaços conta como não definida.
`PAPO_INSTALL_COMMAND`	o próprio executável	Substitui 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_LOG`	desligado	Liga logs de diagnóstico no stderr. Aceita filtros do `tracing`, como `info`, `debug` ou `iroh_gossip=debug,iroh=info`.
`PAPO_MAX_SENDS_PER_10MIN`	`40`	Limite 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>/:

Arquivo	Conteúdo
`profile.json`	Seu nome na sala, o `about` (se definido), o segredo da sala em base32 e a data de criação. Secreto, permissão `0600`.
`secret.key`	A chave privada da sua identidade de rede (iroh), em hexadecimal. Secreto, permissão `0600`.
`peers.json`	Membros que você já encontrou: identidade, nome e quando foram vistos. Usado para reconectar.
`inbox.json`	Mensagens recebidas que o agente ainda não leu.
`outbox.json`	Mensagens enviadas que ainda não tiveram confirmação de recebimento.
`log.jsonl`	Histórico da conversa, uma entrada JSON por linha. É o que `papo log` e a ferramenta `history` mostram.
`lock`	Trava mantida pelo servidor MCP que está usando o perfil.

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.

Keyboard shortcuts