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

    SetupVibe

    SetupVibe 2: guia do binário para preparar sua máquina

    Entenda como o SetupVibe 2 prepara a máquina com um binário e versões fixadas. Conheça os modos TUI, CLI e MCP e escolha por onde começar a instalação.

    Ao preparar uma máquina de desenvolvimento, você instala runtimes, acrescenta CLIs e ajusta o .zshrc. Se essas alterações ficam sem registro, comparar a máquina com outro ambiente exige conferir as versões instaladas e descobrir a origem de cada alteração no shell.

    O SetupVibe 2 trata esse preparo como parte do projeto. Um binário único lê uma lista de itens com versões fixadas, instala o que você marcar, registra o que fez em ~/.setupvibe/ e confere depois se a máquina continua com o que foi combinado. A lista vem embutida no binário e pode ser usada tanto num notebook quanto num servidor.

    Um binário, três modos

    O mesmo executável atende três públicos, sem três bases de código.

    Modo Como entrar Uso
    TUI setupvibe sem argumentos em um terminal interativo consultar o estado e agir pelo teclado
    CLI setupvibe <command> [options], com saída em texto ou --json executar comandos diretamente ou por scripts e agentes
    MCP setupvibe mcp, servidor Model Context Protocol via stdio agentes de IA que operam a máquina

    Os três leem a mesma identidade, a mesma configuração, o mesmo cofre de credenciais e a mesma tabela de exit codes. Um comando novo entra no mesmo registro e chega ao --help, ao --json, à descrição OpenCLI e à referência gerada, sem uma segunda implementação.

    Duas edições, dois binários

    Binário Edição Sistemas
    setupvibe desktop: ambiente de desenvolvimento, local ou remoto macOS, Ubuntu, Debian, Mint, Zorin, Arch, Omarchy, Windows e WSL
    setupvibe-server server: infraestrutura com Docker Swarm Ubuntu e Debian

    As duas edições usam a mesma pasta ~/.setupvibe/ e o mesmo prefixo SETUPVIBE_ nas variáveis. Elas são exclusivas: o init recusa uma máquina que já tem a outra edição preparada, porque só um binário fica instalado por máquina.

    Versões fixadas, não versões do dia

    Cada item da lista carrega a versão, ou a política de versão, que o SetupVibe instala. setupvibe check compara o que está na máquina com essa versão e devolve o exit code correspondente. setupvibe update troca só os itens cuja versão fixada mudou desde o binário que você tem. Ferramentas fora da lista entram pelo mise com install --external, também com versão fixada.

    Como ler este guia

    O guia tem três partes. Se é a sua primeira vez com o SetupVibe, leia a Parte 1 na ordem e siga a Parte 2 como consulta operacional. A Parte 3 é referência, para quando você precisa da lista exata de uma opção, de um arquivo de estado ou de um exit code.

    Parte 1. Primeiro uso

    Os primeiros capítulos explicam o produto e acompanham a preparação da máquina até a instalação das ferramentas que você selecionou.

    Capítulo Pergunta que responde
    Visão geral De que peças o SetupVibe é feito e o que cada uma guarda?
    Instalação e primeiro uso Como instalar o binário, preparar a máquina e instalar os primeiros itens?
    Instalação automática Como preparar uma máquina sem perguntas, com perfil, respostas e plano?
    Itens e versões fixadas O que a lista controla e como instalar, remover, atualizar e conferir?

    Parte 2. Operação

    Consulte estes capítulos para operar a máquina depois da instalação ou adaptar o procedimento ao servidor, ao Windows e à migração da versão anterior.

    Capítulo O que você aprende
    A TUI os sete módulos, as teclas, o mouse, o idioma e o tema
    Shell e terminal o que muda no .zshrc, no Starship e no tmux, e onde ficam as suas linhas
    Manutenção doctor, upgrade, report, config export e os logs
    Servidor e segurança setupvibe-server, usuário de trabalho, UFW, fail2ban e Swarm
    Agentes de IA e MCP como um agente lê o estado e executa o SetupVibe por MCP
    Windows e WSL o installer do Windows, o WSL 2 e o que o binário preserva
    Vindo do SetupVibe 1 o que o migrate converte, o que ele pergunta e o que conferir
    Problemas comuns e glossário sintoma, causa, comando e exit code, termo por termo

    Parte 3. Referência

    Os apêndices são gerados na compilação a partir da documentação embutida no binário, que outros agentes mantêm. No repositório, a coluna da direita leva à fonte.

    Apêndice Conteúdo Fonte
    CLI convenções, opções globais, saída em texto e JSON, referência de cada command desktop/docs/cli.md
    Configuração e estado settings.json, arquivos de estado, cofre, master key e variáveis desktop/docs/configuration.md
    Códigos de saída a tabela completa e como tratar cada classe de falha desktop/docs/exit-codes.md
    MCP tools, resources, prompts e configuração nos clientes desktop/docs/mcp.md

    A máquina de exemplo

    Os comandos do guia vêm de um host Debian 13 x64, com 20 GB de RAM e 74 GB livres, que já tinha passado pelo SetupVibe 1. Isso permite mostrar o mesmo comando em dois estados: com o item ausente e com o item já instalado na máquina por outro gerenciador.

    Os blocos text foram copiados de execuções reais do binário com dois ajustes: a pasta pessoal aparece como ~ e as listas longas são abreviadas com …. Cada bloco identifica a máquina de origem, pois os números de memória, disco e versão variam entre ambientes.

    Commands, opções, keys e campos do --json ficam em inglês, como o binário escreve. O texto em volta é em português do Brasil.

    O que este guia não ensina

    O guia não substitui a documentação do mise, do Docker Swarm, do Model Context Protocol nem do Git. Ele mostra o que o SetupVibe faz com essas ferramentas e aponta a fonte oficial quando o assunto fica fora do escopo do produto. Também não ensina a especificação interna: o código de shared/ e o documento da especificação ficam no repositório e orientam a manutenção do SetupVibe.

    Documentação relacionada

    • setupvibe --skill imprime a documentação embutida no binário, escrita para agentes lerem sem o repositório. setupvibe docs aceita os mesmos tópicos e mais inventory, gerado da lista embutida.
    • Repositório: código, releases, changelog e os installers.
    • Site: apresentação, edições e downloads.

    Próximo passo

    A visão geral mostra as peças e o vocabulário que o resto do guia usa. O capítulo seguinte instala o binário e prepara a primeira máquina.

    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