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

    SetupVibe

    SetupVibe 2: funcionamento e arquivos da sua máquina

    Conheça as peças do SetupVibe 2 e acompanhe o preparo da máquina. Veja como o binário registra as instalações e confere as versões das ferramentas.

    Preparar uma máquina de desenvolvimento envolve quatro trabalhos diferentes: instalar pacotes do sistema, escolher versões de runtime, configurar o shell e registrar o que foi feito. Quando cada trabalho fica num script separado, o resultado depende da última execução e da versão disponível naquele dia.

    O SetupVibe 2 junta os quatro num binário com uma lista única. A lista diz o que entra e em qual versão. O binário executa a instalação e grava o resultado para permitir a conferência das versões e a consulta ao histórico de alterações.

    As peças

    Peça Onde vive O que faz
    binário ~/.local/bin/setupvibe ou /usr/local/bin/setupvibe executa os commands, abre a TUI e serve o MCP
    lista de itens desktop/inventory.json e server/inventory.json, embutidos no binário define cada item, a versão fixada, as dependências, o método de instalação e a verificação
    installers install.sh, install-server.sh e install.ps1 baixam o binário do release e conferem o checksum
    estado ~/.setupvibe/ guarda a seleção, o resultado das execuções, as preferências e o cofre
    documentação embutida dentro do binário responde --skill e docs sem o repositório

    A lista viaja dentro do binário. Isso resolve um problema prático de provisionamento: a máquina que executa não precisa de acesso ao repositório para saber o que instalar. O binário e a lista têm a mesma versão, então uma máquina preparada com 2.0.0-dev.25 instala exatamente o que aquele binário conhece.

    O ciclo de uso

    Os seis passos seguem a ordem abaixo e podem ser repetidos sem desfazer o trabalho anterior.

    1. detectar: setupvibe system mostra o sistema, a variação da máquina (local, remota ou sem interface), o suporte e o estado da versão.
    2. preparar: setupvibe init confere os requisitos e instala as dependências de compilação e o mise.
    3. escolher: setupvibe list mostra os itens e o estado de cada um. A TUI permite marcar e instalar pelo teclado.
    4. instalar: setupvibe install <itens> instala a seleção explícita. setupvibe auto instala sem perguntas.
    5. conferir: setupvibe check compara a máquina com a versão fixada. setupvibe doctor olha o conjunto.
    6. manter: setupvibe update troca versões, setupvibe upgrade atualiza o binário e setupvibe remove tira o que você não quer manter.

    Nada nesse ciclo depende de um serviço do SetupVibe estar no ar. O binário consulta a versão nova uma vez e avisa. A instalação e a conferência são locais, com downloads dos fornecedores de cada ferramenta.

    Versões fixadas

    Cada item carrega uma política de versão. Um pacote nativo costuma ficar numa linha (php@8.5), uma CLI que se atualiza sozinha fica com versão mínima e uma ferramenta de release fixo fica na versão exata. O setupvibe check aplica a mesma política na conferência. Já o setupvibe update troca só o item cuja versão fixada mudou entre o binário que você tem e o novo.

    O SetupVibe cuida das ferramentas da máquina, preservando o controle de dependências do projeto pelo composer.lock, pelo package-lock.json e pelo mise.toml local.

    Duas edições

    Edição Binário Escopo
    desktop setupvibe ambiente de desenvolvimento em macOS, Linux, Windows e WSL, local ou por acesso remoto
    server setupvibe-server máquina Linux de operação, com Docker, Swarm, usuário de trabalho e módulo de segurança

    As duas compartilham a pasta ~/.setupvibe/, o prefixo SETUPVIBE_ das variáveis e a tabela de exit codes. São exclusivas por máquina: o init recusa uma máquina com a outra edição preparada. Para trocar de edição, remova a instalação com self uninstall.

    O que o binário guarda

    Três arquivos explicam quase todo comportamento que surpreende numa primeira sessão:

    • config.json guarda a edição, o sistema detectado, o registro do init, a identidade do Git e o canal de release como registro da preparação da máquina.
    • selection.json guarda os itens escolhidos, a versão instalada e o status do último check, usados por list, check e update.
    • settings.json guarda as preferências que você altera pelos comandos de configuração, em texto claro e com keys em notação de ponto.

    O apêndice de configuração lista todos os arquivos, os comandos que escrevem neles e o tratamento das mudanças de formato.

    Conhecimentos necessários

    Para usar este guia, você precisa saber usar terminal, sudo, variáveis de ambiente e Git. Não precisa saber Bun, mise, Docker Swarm nem Model Context Protocol: o guia mostra o que o produto faz com cada um e onde está a documentação oficial quando o assunto passa do escopo.

    A especificação interna e o código de shared/ estão documentados no repositório e em V2.md.

    Próximo passo

    O capítulo Instalação e primeiro uso instala o binário, prepara a máquina com init e instala o primeiro conjunto de itens.

    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