Cópia estática

Copiado de docs/getting-started/installation.md em https://github.com/poppy-team/prumo (MIT). Fixado na revisão e91694d3959be1ed92757b34063efe0b2191821f, blob 07d35d6aa023437e04b30123c45e402e26daec47. O repositório de origem permanece canônico; esta cópia é atualizada por um pull request de sincronização, não em tempo real.

Instalação do Prumo

O Prumo é distribuído como um executável estático único compilado em Go, sem dependências externas de runtime (não exige Python, Node.js ou compiladores instalados).

Instalação Rápida (Recomendada)

Linux & macOS

# Baixar o executável oficial v0.6.0
curl -fsSL https://github.com/poppy-team/prumo/releases/latest/download/prumo-linux-amd64 -o /usr/local/bin/prumo
chmod +x /usr/local/bin/prumo

# Verificar instalação
prumo version

Inicialização do Ambiente Global

Ao instalar pela primeira vez, execute o setup para registrar o manifesto do sistema e detectar ferramentas de IA no seu $PATH:

prumo setup

O comando inicializará o diretório global ~/.prumo, contendo o registro de conectores e o cache de atualizações.

---

Verificação de Integridade e Diagnóstico

Para auditar o ambiente host, ferramentas de IA detectadas e integridade do executável:

prumo doctor

Se executado fora de um projeto, o prumo doctor analisa o ambiente global; dentro de um projeto, analisa também a conformidade dos esquemas e metas do repositório.

---

Autoupdate (Atualização Contínua)

O Prumo inclui um subsistema de auto-atualização integrado com verificação criptográfica SHA-256 diretamente dos lançamentos oficiais do GitHub:

# Verificar se há novas versões disponíveis
prumo upgrade --check

# Atualizar para a versão mais recente
prumo upgrade

# Atualizar para uma versão específica
prumo upgrade --version v0.6.1

---

Desinstalação Reversível e Segura

Caso precise remover a instalação global ou redefinir caches:

# Remove conectores e binários globais
prumo uninstall

# Limpa caches sem afetar dados do projeto
prumo uninstall --purge-cache

IMPORTANT

A desinstalação nunca muta ou remove diretórios de repositórios locais (prumo.json, .ai/, docs/ e arquivos de metas permanecem 100% intactos).