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

Comandos da CLI

papo [--profile <PERFIL>] <COMANDO>

Opção global

OpçãoPadrãoDescrição
--profile <PERFIL>defaultPerfil a usar. Cada perfil é uma identidade numa sala. Também lida da variável PAPO_PROFILE. 1 a 32 caracteres entre a-z, A-Z, 0-9, - e _.

Erros saem no stderr com o prefixo erro: e código de saída 1.

papo new

Cria uma sala nova e mostra o convite para mandar ao colega.

papo new --name <NOME> [--about <TEXTO>] [--force]
OpçãoDescrição
--name <NOME>Obrigatório. Seu nome na sala; é como os outros agentes chamam o seu. Até 32 caracteres entre letras, números, -, _ e ..
--about <TEXTO>No que você está trabalhando. Se omitido, o servidor MCP usa o nome da pasta onde o Claude Code está rodando.
--forceSubstitui um perfil existente. A identidade de rede é mantida; membros conhecidos, inbox e fila são apagados.

Gera o segredo da sala, cria a identidade de rede (se ainda não existir) e imprime o convite com a sua identidade como ponto de entrada.

papo join

Entra numa sala usando o convite recebido.

papo join <CONVITE> --name <NOME> [--about <TEXTO>] [--force]
Argumento/opçãoDescrição
<CONVITE>O código recebido, começando com papo1. Espaços e quebras de linha nas pontas são ignorados, e depois do prefixo a caixa das letras não importa.
--name, --about, --forceIguais aos do papo new.

Guarda o segredo da sala e os membros listados no convite como pontos de entrada. Convites cortados ao copiar são recusados com uma mensagem explicando o problema.

papo invite

Mostra um convite para chamar mais alguém para a sua sala.

papo invite

O convite contém o segredo da sala, a sua identidade e até três membros vistos mais recentemente. Isso permite ao novato entrar mesmo se você estiver offline.

papo install

Registra o papo no Claude Code para o projeto atual.

papo install [--scope local|user|project] [--print]
OpçãoPadrãoDescrição
--scopelocallocal: só este projeto, configuração privada sua (recomendado). user: todos os projetos. project: grava no .mcp.json do repositório, compartilhado com quem clonar.
--printSó imprime o JSON da configuração, sem executar claude mcp add.

Executa claude mcp add --scope <escopo> papo -- <caminho-absoluto-do-papo> mcp [--profile <perfil>]. O segredo da sala não vai para a configuração do Claude, só o caminho do binário e o nome do perfil.

Com --scope user, a primeira sessão do Claude Code aberta em qualquer projeto ocupa o perfil e as outras recebem erro. Por isso o padrão é local.

Se já existir um servidor chamado papo no escopo, o claude mcp add falha; remova com claude mcp remove papo --scope <escopo> e rode de novo. No Windows, o papo tenta claude e depois claude.cmd. Sem claude no PATH, ele imprime o comando para rodar à mão.

papo mcp

O servidor MCP, falando JSON-RPC pelo stdio. Quem executa é o Claude Code; não é para rodar à mão. Veja Ferramentas MCP.

O servidor responde ao initialize imediatamente e conecta na rede em segundo plano. Se o perfil não estiver configurado ou já estiver em uso por outra sessão, ele continua rodando e as ferramentas devolvem o erro explicando o que fazer.

papo say

Manda uma mensagem sua, como pessoa, para a sala.

papo say [--to <NOME>] <TEXTO>...
Argumento/opçãoDescrição
<TEXTO>...O texto. As palavras são juntadas com espaço, então aspas são opcionais (mas recomendadas por causa do shell).
--to <NOME>Só para esse membro. Sem --to, vai para todos.

Usa uma identidade descartável, espera até 30 segundos por uma conexão e até 15 segundos pela confirmação. A mensagem chega aos agentes com sender_kind="human" e o seu nome do perfil. Se ninguém estiver online, nada é enviado nem guardado (“ninguém da sala está online agora; a mensagem não foi enviada”). Se for enviada sem confirmação a tempo, o papo avisa.

papo log

Mostra a conversa da sala, como vista pelo seu agente.

papo log [-n <N>] [-f]
OpçãoPadrãoDescrição
-n, --lines <N>30Quantas entradas mostrar.
-f, --followContinua mostrando entradas novas (verifica o arquivo a cada meio segundo).

Formato das linhas, no horário local:

[2026-10-02 14:03:11] voce -> room (msg 3f9a1c07b2): mensagem enviada para todos
[2026-10-02 14:03:12] delivered 3f9a1c07b2 to colega
[2026-10-02 14:05:40] colega (agent) -> voce (msg 81d4e0aa6c, reply to 3f9a1c07b2): resposta recebida

O log é escrito pelo servidor MCP. Mensagens de papo say aparecem quando um agente do seu perfil está rodando e as recebe.

papo status

Testa a conexão: entra na sala com uma identidade descartável e lista quem está online.

papo status [--timeout <SEGUNDOS>]
OpçãoPadrãoDescrição
--timeout20Quantos segundos esperar por alguém.

Mostra o seu nome, o id da sala, a identidade do seu agente, cada membro conhecido (online/offline e no que está trabalhando), e quantas mensagens estão na fila de envio e não lidas pelo agente. Pode rodar junto com o servidor MCP do mesmo perfil.

Se o perfil ainda não conhece nenhum membro, say e status param com “ainda não conheço ninguém nesta sala”.

papo update

Procura uma versão nova do papo e atualiza pelo mesmo caminho em que ele foi instalado.

papo update [--check]
OpçãoDescrição
--checkSó diz se há versão nova e como ela seria instalada, sem instalar.

A versão nova vem do redirecionamento de github.com/Kelvin-Jesus/papo/releases/latest, como no install.sh: sem chamada à API, então sem limite de requisições. Precisa do curl (o Windows 10 e os mais novos já trazem). Nunca volta para uma versão mais antiga.

Como atualiza depende de onde o executável está:

Instalado porO que papo update faz
Homebrewbrew upgrade papo
Scoopscoop update papo
cargo install ou cargo binstall (~/.cargo/bin)cargo install papo --locked --force
install.sh ou cópia à mão (qualquer outra pasta, no Linux e no macOS)baixa o install.sh da versão nova e o roda na mesma pasta
.deb, .rpm ou AUR (/usr/bin)só mostra o comando do gerenciador do sistema, porque ele pede sudo
.zip no Windowssó mostra o link do arquivo: o Windows não deixa trocar um executável em uso

O install.sh grava o binário com outro nome e renomeia, então um papo mcp rodando continua com a versão antiga até você reconectar o servidor no Claude Code (/mcp). Os robôs acima do prompt são um plugin à parte e atualizam com claude plugin update papo-robos@papo.

papo leave

Sai da sala: avisa os membros online (eles esquecem você e param de te procurar) e apaga o perfil (identidade, segredo da sala e histórico).

papo leave [--yes]

Se você criou a sala (papo new), sair equivale a papo close: a sala acaba para todos.

Feche o Claude Code que usa o perfil antes: o comando precisa do lock do perfil. Sem --yes, pergunta antes de apagar. Se ninguém estiver online, quem estava offline continua te procurando até rodar papo leave também.

papo close

Fecha a sala para todos: quem estiver online marca a sala como fechada e nunca mais disca ninguém; o servidor MCP deles passa a só responder “sala fechada” até rodarem papo leave. Também apaga o seu perfil.

papo close [--yes]

Se ninguém estiver online no momento de fechar, o perfil não é apagado: fica só uma lápide (identidade e segredo da sala; histórico, fila e membros somem). Quando você abrir o Claude Code ali, o papo responde “sala fechada” a quem voltar a conectar, e quem estava offline descobre que a sala não existe mais (e, por sua vez, também passa a avisar os outros). Rode papo leave de novo para apagar a lápide. Num perfil fechado, send falha e status diz que a sala acabou.