Instalação
O papo é um binário único, sem runtime e sem dependências. As duas pessoas que vão conversar precisam dele instalado, cada uma na sua máquina.
Requisitos
- Claude Code instalado e logado. Para receber mensagens por push (recomendado), o login precisa ser com conta claude.ai ou chave de API do Console. Veja Usando sem channels para os detalhes e para o modo que funciona em qualquer caso.
- Acesso à internet. Redes que bloqueiam UDP também funcionam, porque o tráfego cai para um relay via HTTPS.
Script de instalação (Linux e macOS)
curl -fsSL https://raw.githubusercontent.com/Kelvin-Jesus/papo/main/scripts/install.sh | sh
O script detecta o sistema e a arquitetura (inclusive Apple Silicon num terminal sob Rosetta), baixa o
arquivo da última release, confere o .sha256 e instala o papo em ~/.local/bin, sem sudo. Funciona
com curl ou wget. Opções, depois de sh -s --:
| Opção | Efeito |
|---|---|
--dir <diretório> | Instala em outro lugar (ex.: /usr/local/bin, aí com sudo sh). |
--version <vX.Y.Z> | Instala uma versão específica em vez da última. |
Se o diretório não estiver no PATH, o script avisa e mostra a linha para adicionar.
Também dá para pedir ao seu agente que instale e configure tudo: o README tem um prompt pronto e as instruções que ele segue.
Gerenciadores de pacotes
| Sistema | Comando |
|---|---|
| macOS e Linux (Homebrew) | brew tap kelvin-jesus/papo https://github.com/Kelvin-Jesus/papo e depois brew install papo |
| Arch e derivados (AUR) | yay -S papo-bin (ou paru -S papo-bin) |
| Windows (Scoop) | scoop bucket add papo https://github.com/Kelvin-Jesus/papo e depois scoop install papo |
| Debian e Ubuntu | baixe o .deb da última release e rode sudo apt install ./papo_*_amd64.deb |
| Fedora, RHEL e openSUSE | baixe o .rpm da última release e rode sudo dnf install ./papo-*.rpm |
| Qualquer sistema com Rust | cargo binstall papo (baixa o binário pronto) ou cargo install papo (compila) |
Todos instalam o mesmo binário das releases do GitHub, com o mesmo SHA-256. Cada release atualiza os
gerenciadores sozinha. Para atualizar, rode papo update: ele descobre por onde o papo foi instalado e
usa o mesmo caminho (referência).
Binário pronto
Baixe o arquivo do seu sistema na página de
Releases, extraia e coloque o papo (ou papo.exe)
num diretório do PATH.
| Sistema | Arquivo |
|---|---|
| Linux x86_64 | papo-<versão>-x86_64-unknown-linux-musl.tar.gz |
| Linux ARM64 | papo-<versão>-aarch64-unknown-linux-musl.tar.gz |
| macOS Apple Silicon | papo-<versão>-aarch64-apple-darwin.tar.gz |
| macOS Intel | papo-<versão>-x86_64-apple-darwin.tar.gz |
| Windows | papo-<versão>-x86_64-pc-windows-msvc.zip |
Os binários de Linux são estáticos (musl) e rodam em qualquer distribuição. No Windows on ARM, use o
binário x86_64, que roda por emulação. Cada arquivo vem acompanhado de um .sha256 para conferir a
integridade.
Linux e macOS
tar -xzf papo-<versão>-<alvo>.tar.gz
sudo mv papo-<versão>-<alvo>/papo /usr/local/bin/
papo --version
Sem sudo, use um diretório do seu usuário que esteja no PATH, como ~/.local/bin.
macOS: aviso do Gatekeeper
Um binário baixado pelo navegador vem marcado como “quarentena” e o macOS pode se recusar a abri-lo. Libere com:
xattr -d com.apple.quarantine /usr/local/bin/papo
Windows
Extraia o .zip, mova o papo.exe para uma pasta (por exemplo C:\Users\<você>\bin) e adicione essa
pasta ao PATH nas variáveis de ambiente do usuário. Abra um terminal novo e rode papo --version.
Compilando do código-fonte
Com Rust 1.91 ou mais novo:
git clone https://github.com/Kelvin-Jesus/papo
cd papo
cargo install --path .
Ou, sem clonar:
cargo install --git https://github.com/Kelvin-Jesus/papo
O binário vai para ~/.cargo/bin, que normalmente já está no PATH.
Conferindo
papo --version
papo --help
Pronto. O próximo passo é o Tutorial, que leva você do zero até dois agentes conversando.