Ir para o conteúdo
Promovaweb
Projeto open source da Promovaweb

Ferramentas do SetupVibe

Tudo o que vem instalado

O SetupVibe instala e configura o shell, as linguagens, os containers e os CLIs de IA. Esta página reúne cada grupo de ferramentas, o que entra em cada edição e o guia completo de cada uma.

Zsh e Starship

No Linux Desktop e na edição Server, o script instala o Zsh e altera o shell quando necessário. No macOS, ele usa o Zsh já definido no sistema. As duas edições configuram Oh My Zsh e Starship com o preset Gruvbox Rainbow.

Configuração do prompt

O preset é gravado em ~/.config/starship.toml. Você pode abrir esse arquivo para conferir a configuração aplicada ao seu prompt.

Aliases no .zshrc

Os atalhos ficam no .zshrc e encurtam comandos do dia a dia, como gcm para git commit -m.

PATH configurado

Os caminhos das ferramentas instaladas entram no PATH. Abra um terminal novo depois da instalação para que eles valham.

CLIs de IA

No Desktop e no Server, o conjunto principal de CLIs de IA é instalado pelo npm. Herdr e Antigravity usam binários próprios no Desktop. No Windows, Claude Code, Codex e Antigravity usam instaladores nativos. O script também instala skills e OpenCode pelo npm. Você configura o acesso a cada programa após a instalação.

Claude Code

O Desktop e o Server instalam o pacote @anthropic-ai/claude-code. Nessas edições, o alias cc inclui --permission-mode=auto --dangerously-skip-permissions. Você pode consultar a expansão antes de usá-lo.

OpenCode e Kimi Code

O Desktop instala opencode-ai e @moonshot-ai/kimi-code. O Server instala OpenCode, sem Kimi Code. A camada Omarchy acrescenta Kimi Code quando o comando ainda está ausente. O Windows instala OpenCode pelo npm. Nenhum desses fluxos instala Gemini CLI.

Codex e Copilot

Desktop e Server instalam Codex e GitHub Copilot CLI.

Linguagens e runtimes

O Desktop instala PHP, Ruby, Python, Go, Rust, Node.js e Bun na máquina. Os meios variam por linguagem: há fórmulas Homebrew, pacotes APT, rbenv e instaladores oficiais. Entre os runtimes gerenciados explicitamente pelo Server, está apenas o Node.js 24.

Python com uv

O Desktop instala Python 3.14 pelo Homebrew no macOS e os pacotes python3 do sistema no Linux. Nos dois sistemas, instala o uv pelo script oficial do projeto.

Go, Rust, Node.js e Bun

O Go 1.26.5 no Linux, o Rust pelo rustup, o Node.js 24 e o Bun ficam no PATH depois da instalação.

PHP e Ruby

No Linux, o Desktop solicita PHP 8.5. No macOS, instala a fórmula php sem versão fixada. Os dois fluxos configuram Composer e o instalador do Laravel. O Ruby 3.4.10 usa rbenv, com as gems Bundler e Rails.

Herdr e tmux

Desktop e Server instalam Herdr e tmux. O Herdr fica em ~/.local/bin/herdr. A configuração do tmux vai para ~/.tmux.conf. Você pode conferir separadamente os arquivos e os comandos dessas ferramentas.

Mouse no tmux

Os arquivos do tmux definem set -g mouse on. Também declaram o plugin tmux-better-mouse-mode, cujo uso exige instalação e carregamento pelo TPM.

Plugins de sessão

A configuração declara Resurrect e Continuum, habilita a restauração e define o intervalo de salvamento como 10 minutos. Os scripts instalam o TPM, mas não executam a instalação dos demais plugins. Você precisa concluir essa etapa antes de usar seus recursos.

Conferência do Herdr

Ao instalar Herdr, o SetupVibe executa herdr --version. Essa consulta confere o binário instalado.

Ver a instalação do Herdr Ver a configuração do tmux

PM2

O Desktop instala PM2 pelo npm e inicia o Agentlytics pelo arquivo ~/ecosystem.config.js. A camada Omarchy instala PM2 e Agentlytics, mas não inicia esse processo nem configura startup.

Inicialização com o sistema

No Linux e no WSL com systemd ativo, o Desktop configura o serviço pm2-<usuário>. No macOS, cria o LaunchAgent pm2.<usuário> na sessão gráfica. No macOS, você precisa entrar nessa sessão para carregar o LaunchAgent após reiniciar a máquina.

App do arquivo ecosystem

O arquivo fornecido tem um único app: agentlytics. Ele usa npx agentlytics, uma instância, modo fork e max_memory_restart: "200M".

Logs por processo

No Desktop, o alias plog executa pm2 logs. O SetupVibe não instala pm2-logrotate.

Docker e Portainer

Desktop e Omarchy gravam ~/.setupvibe/portainer-compose.yml. O Desktop e a Omarchy tentam iniciar o Portainer se o Docker estiver disponível. A edição Server retorna erro se o daemon não estiver disponível nessa etapa.

Imagem e endereço

O compose usa portainer/portainer-ce:lts e publica 9443:9443. Na própria máquina instalada, você usa https://localhost:9443. Em acesso remoto, localhost aponta para a máquina do seu navegador.

Arquivos e socket do Docker

O compose monta ./portainer_data em /data e /var/run/docker.sock no mesmo caminho dentro do container. Você encontra a pasta do Portainer em ~/.setupvibe/portainer_data.

Comandos do compose

Os aliases portainer-start, portainer-stop, portainer-restart e portainer-update operam esse arquivo no Desktop.

Cron e Cronboard

Desktop e Omarchy instalam Cronboard. No macOS Desktop, a instalação usa Homebrew. No Linux Desktop e na Omarchy, usa uv. O Server instala cron e os aliases do crontab, sem Cronboard.

Comando do Cronboard

No Desktop, cronb executa cronboard. A camada Omarchy instala o programa, mas não cria esse alias.

Tarefas criadas pelo Desktop

O Desktop acrescenta um heartbeat horário em /tmp/cron-heartbeat.log e um relatório diário em ~/cron-disk-usage.log. Você pode conferir essas entradas com cronl.

Aliases do crontab

Os aliases cronl, crone e cronr executam crontab -l, crontab -e e crontab -r no Desktop e no Server.

Fontes e ícones

No Linux Desktop, o instalador baixa FiraCode e JetBrains Mono Nerd Fonts 3.4.0. No macOS, ele usa os casks do Homebrew, sem fixar a versão das fontes. Você seleciona a fonte nas preferências do seu terminal.

Fonte do seu terminal

A instalação das fontes não altera o perfil do seu terminal. Você precisa selecionar uma das fontes instaladas nas preferências do programa.

Fontes no Windows

No Windows, o instalador solicita FiraCode Nerd Font pelo Chocolatey e JetBrains Mono Nerd Font pelo WinGet, sem fixar versões.

Seleção no terminal

A instalação da fonte não muda o terminal sozinha. A escolha fica nas preferências de cada programa.

Utilitários modernos

A edição Desktop instala ferramentas como eza, bat, ripgrep, fd, fzf e zoxide ao lado dos comandos clássicos, que continuam funcionando como antes.

eza ao lado do ls

O eza entra pela lista de fórmulas Homebrew da etapa 8. Os aliases ll e la continuam definidos com ls.

bat ao lado do cat

O bat também faz parte da etapa 8. O arquivo .zshrc do SetupVibe não redefine cat como bat.

zoxide e ripgrep

Zoxide e ripgrep estão na lista Homebrew. O Zsh carrega zoxide init zsh quando encontra o executável.

Aliases e atalhos

Os arquivos .zshrc do SetupVibe trazem 282 aliases no Linux, 266 no macOS e 181 no Server. Você digita gcm "mensagem" no lugar de git commit -m "mensagem".

Git e GitHub

Atalhos para status, commit, push, branches, stash e para o GitHub CLI (gh).

Docker e Compose

Atalhos como dps para docker ps e dc para docker compose.

Atalhos de IA

O alias cc inclui as opções --permission-mode=auto --dangerously-skip-permissions. Você também encontra skl, skf, ska e sku nos três arquivos Zsh.

Desenvolvimento com IA na Promovaweb

Preparar o ambiente é uma etapa do desenvolvimento. No Plano IA Makers, você aprende a especificar, construir, revisar e publicar sistemas e agentes com apoio de IA. A Formação Vibe Coding está incluída no plano. Consulte a página para conhecer o conteúdo e as condições de acesso.

Conhecer o Plano IA Makers

Prefere avançar no seu projeto com orientação ao vivo? Veja o Desenvolvimento Colaborativo da Dev Side Studio.