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

    SetupVibe

    SetupVibe 2: configuração do shell e personalizações

    Entenda o que o SetupVibe 2 escreve no shell e onde guardar suas personalizações. Consulte os comandos para aplicar ou remover o bloco de configuração.

    Um ambiente preparado se perde no primeiro git pull do próprio dotfiles ou no primeiro instalador que reescreve o .zshrc. O SetupVibe evita essa disputa com um bloco delimitado: ele escreve só entre dois marcadores, guarda uma cópia do arquivo antes da primeira mudança e deixa um arquivo separado para as suas linhas.

    O auto aplica esse bloco ao fim da instalação e shell apply permite reaplicá-lo depois. Ambos convertem arquivos do SetupVibe 1 antes de escrever o bloco novo, preservando as suas personalizações num arquivo separado.

    O que o shell apply escreve

    Caminho Conteúdo
    ~/.zshrc (Debian, Ubuntu, Mint, Zorin, Arch, macOS e server) PATH, mise activate, Oh My Zsh com plugins, zoxide, Starship, aliases e ~/.zshrc.local
    ~/.bashrc (Omarchy) PATH, STARSHIP_CONFIG para ~/.config/setupvibe/starship.toml, aliases e ~/.bashrc.local; os arquivos do Omarchy ficam intactos
    ~/.tmux.conf (menos Omarchy) carrega ~/.setupvibe/shell/tmux.conf, que carrega ~/.tmux.conf.local antes do TPM
    ~/.setupvibe/shell/aliases.sh aliases válidos em ZSH e Bash
    ~/.setupvibe/shell/aliases-agents.sh aliases que abrem agentes sem confirmação
    ~/.setupvibe/shell/tmux.conf plugins, tema e teclas do tmux
    ~/.zshrc.local, ~/.bashrc.local, ~/.tmux.conf.local o lugar das suas linhas, criados uma vez e nunca sobrescritos

    Antes da primeira alteração, o arquivo original vai para ~/.setupvibe/backups/ com o sufixo .first e uma cópia com data. No Linux, o apply também troca o shell de login para ZSH com chsh, usando sudo quando precisa.

    Terminal
    setupvibe shell apply --dry-run
    setupvibe shell apply

    Use o primeiro comando para consultar os arquivos e os blocos previstos e o segundo para gravá-los. Depois de aplicar, abra um terminal novo ou recarregue o shell na sessão atual:

    Terminal
    exec $SHELL -l

    O bloco e o arquivo local

    O bloco começa em # >>> setupvibe >>> e termina em # <<< setupvibe <<<. Ele é substituído inteiro a cada execução, então não edite dentro dele: a próxima atualização descarta a alteração. O que você escreve fora do bloco fica.

    As suas linhas vão para o arquivo .local:

    ~/.zshrc.local
    export EDITOR=vim
    alias deploy='./scripts/deploy.sh'

    O arquivo usa o formato do .zshrc e é carregado no fim do bloco. Para tmux, ~/.tmux.conf.local é carregado antes do TPM, o que permite trocar teclas e tema sem alterar o arquivo gerenciado.

    Aliases

    Os aliases passam por um guarda que só define o nome quando nada responde por ele: nem alias, nem função, nem comando instalado. Com essa verificação, os nomes existentes são preservados. df é a exceção, porque envolve o próprio comando de propósito.

    Nomes que escondiam programas comuns foram renomeados: gs virou gstat (Ghostscript), ci virou cin (RCS), ts virou tsv (moreutils), dc virou dco (a calculadora dc) e gofmt virou gofmtw. pn e pnx são pulados em silêncio quando o pnpm já instala comandos com esses nomes, porque fazem a mesma coisa. O setupvibe doctor lista os aliases pulados na máquina.

    Os aliases de agente ficam em arquivo separado e desativam as confirmações da ferramenta: cco para Claude Code, cxo para codex --yolo e oco para opencode --auto. cc não serve para Claude Code porque já é o compilador C. Para deixar os três de fora e voltar a abrir os agentes pelo comando completo:

    Terminal
    setupvibe config set shell.agentAliases false
    setupvibe shell apply

    A troca vale na próxima aplicação do shell. O doctor mostra o estado dos aliases na checklist do módulo Usuário e nos achados do Doctor.

    Ver o que está aplicado

    O comando shell sem subcommand imprime a ajuda. Para conferir o estado, use o doctor, que aponta o bloco ausente, o PATH incompleto e cada alias pulado:

    Terminal
    setupvibe doctor
    setupvibe config get shell.agentAliases

    Remover sem perder o resto

    shell remove apaga só o conteúdo entre os marcadores. Os arquivos .local, os backups, os itens instalados e a pasta ~/.setupvibe/ ficam.

    Terminal
    setupvibe shell remove

    O comando não desinstala pacote, não apaga o estado e não desfaz a troca do shell de login. Para desfazer tudo, use self uninstall, no capítulo de manutenção.

    Para restaurar o ambiente depois de remover o bloco, aplique outra vez:

    Terminal
    setupvibe shell apply

    Omarchy

    O Omarchy já tem shell, prompt, tmux e aliases próprios. Nessa máquina, o SetupVibe escreve no ~/.bashrc um bloco que aponta para o Starship do SetupVibe e para os aliases, sem substituir .bashrc, starship.toml nem a configuração de tmux do sistema. Os acréscimos do SetupVibe ficam dentro do bloco e preservam a configuração mantida pelo Omarchy.

    Próximo passo

    O ambiente do terminal está aplicado e as suas personalizações têm lugar próprio. O capítulo Manutenção cobre o que fazer daqui em diante: diagnosticar, atualizar o binário, tirar um relatório e remover a instalação quando ela não serve mais.

    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