Digite para filtrar as páginas da documentação.

    SetupVibe

    SetupVibe 2: instalar e conferir as versões dos itens

    Consulte a lista de ferramentas do SetupVibe 2 e compare as versões instaladas com as fixadas. Saiba como instalar itens e manter a seleção da máquina.

    O SetupVibe não instala o que estiver na versão mais nova do repositório de cada fornecedor. Ele instala o que está na lista embutida no binário, com a versão que aquela lista fixa e confere depois. A lista é o arquivo desktop/inventory.json na edição desktop e server/inventory.json na server, compilado dentro do executável.

    Cada item dessa lista declara o id, o nome, a categoria, a versão, a política de versão, as dependências, o método de instalação por sistema e o comando que verifica o resultado. Quando você instala node, o binário não procura a última versão: ele usa a entrada de node na lista, instala pelo método daquele sistema e confere com o comando de verificação que a entrada declara.

    O que a versão de um item significa

    A política de versão decide como o item é instalado e conferido.

    Política Como funciona Exemplo
    exact versão fixada, instalada e conferida exatamente Node 24.22.3
    series pacote nativo preso em major.minor PHP 8.5
    minimum ferramenta que se atualiza sozinha; a verificação exige o piso Claude Code
    commit fonte Git presa a um commit ferramenta instalada por clone
    repository última estável de um repositório preso por impressão digital da chave pacote de repositório APT
    distro pacote que vem do sistema build-essential
    managed o instalador do fornecedor escolhe a versão instalador oficial
    system configuração sem versão bloco de configuração do WSL

    O list mostra a versão fixada, não a versão que está instalada. Para comparar com a máquina, use check.

    Instalar

    setupvibe install <itens> instala os itens citados e as dependências deles, na ordem que a lista define. Um item que já passa na verificação é pulado e o motivo aparece na saída.

    Terminal
    setupvibe install docker

    Numa máquina que vai receber dois runtimes e as ferramentas de terminal, o --dry-run mostra as dependências que entram junto e o que já está pronto:

    Terminal
    setupvibe install node php bat eza jq --dry-run

    O plano mostra o método de cada item. Em Debian e Ubuntu, um pacote nativo passa pelo APT com a chave do repositório conferida contra a impressão digital da lista. Uma ferramenta de versão fixa passa pelo mise. Um release binário é baixado, conferido contra o SHA-256 e extraído. A ordem de resolução do método é o sistema, a família (debian-family ou arch-family), linux, unix e all.

    Quando o item já está instalado por outro gerenciador, o comando avisa o caminho e instala a cópia do SetupVibe numa pasta própria. As duas convivem e o PATH decide qual responde. Para substituir a instalação existente por completo, remova a outra cópia depois de conferir a versão que ficou ativa.

    --force reinstala um item que já passa na verificação. É o caminho para reparar uma instalação quebrada sem mexer no resto da seleção:

    Terminal
    setupvibe install node --force

    Remover

    remove tira o que foi instalado no espaço do usuário e atualiza a seleção. Para incluir pacotes do sistema, informe --include-native. A remoção de itens adotados pelo init exige --force.

    Terminal
    setupvibe remove go
    setupvibe remove docker --include-native --dry-run

    Antes de remover, o comando verifica as dependências dos itens selecionados e recusa a remoção de uma dependência ainda necessária, salvo com --force. Sem terminal, confirme com --yes. Uma resposta negativa ou um Ctrl+C encerra o comando com 130 sem remover itens.

    O que o SetupVibe não instalou fica. Item que veio do sistema, item do módulo de segurança e item marcado como initOnly não são removidos por remove. O motivo aparece no texto. Para desfazer a preparação inteira, existe self uninstall, no capítulo de manutenção.

    Atualizar

    update não consulta a internet. Ele compara a seleção com a lista do binário que está rodando e reinstala só os itens cuja versão fixada mudou. Isso amarra a atualização à versão do binário: binário antigo conhece versões antigas.

    Terminal
    setupvibe update --dry-run

    O plano lista cada item com a versão de origem e a de destino. Depois de setupvibe upgrade, o update seguinte aplica o que a versão nova do binário trouxe:

    Terminal
    setupvibe upgrade
    setupvibe update

    Item instalado com --external não entra no update. Ele é atualizado pela própria ferramenta ou por um novo install --external.

    Conferir

    check roda o comando de verificação de cada item selecionado. A saída é uma linha por item, com ✓ ou ✗, a saída do comando e a versão esperada.

    Terminal
    setupvibe check
    setupvibe check node php --json

    Sem argumentos, ele verifica a seleção ou, se ela estiver vazia, o perfil essencial. Itens initOnly, do módulo de segurança e sem instalação possível neste sistema não entram na verificação. O exit code é 0 quando tudo confere e 10 quando algum item falha, o que permite usar o comando num pipeline sem interpretar texto:

    Terminal
    setupvibe check --json | jq '.data.results[] | select(.status=="fail")'
    setupvibe check node || echo "rode: setupvibe install node"

    list --check junta as duas leituras: a lista completa, com o resultado da verificação ao lado de cada item selecionado. É útil para ver o que está fora da versão sem rodar check duas vezes.

    Ferramenta fora da lista

    Uma ferramenta que não está na lista entra pelo mise, com a versão resolvida na hora e gravada em ~/.setupvibe/external.json. Sem versão no argumento, o binário pergunta ao mise a última e fixa o que ele devolveu.

    Terminal
    setupvibe install --external terraform
    setupvibe install --external terraform@1.13.4

    Uma ferramenta que o mise não conhece termina com 6, NOT_FOUND. Para remover, use o mesmo caminho:

    Terminal
    setupvibe remove --external terraform

    Flags que mudam o comportamento por máquina

    Três flags da lista explicam diferenças que aparecem na prática:

    • gui: o item depende de interface gráfica e fica de fora em máquina sem display, como um VPS ou um container.
    • service: precisa de systemd ou de linger para rodar sem sessão aberta.
    • port: publica uma porta. Nas variantes remotas, o auto grava a entrada de compose com a porta presa a 127.0.0.1, para o serviço não ficar exposto.

    Uma flag pode valer só para um sistema. O list e a tabela do tópico inventory mostram a diferença por linha.

    Próximo passo

    A lista está conferida e as versões estão no lugar. O capítulo A TUI mostra como operar a mesma lista pela interface, com filtro, seleção e progresso ao vivo.

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano