
SetupVibe Desktop
Seu computador ou VPS de desenvolvimento
Ao começar um projeto, você precisa executar a aplicação e acompanhar os erros no terminal. No macOS, em um Linux compatível, no WSL2 ou numa VPS onde você faz Vibe Coding e roda agentes de IA remotos, a Desktop Edition instala e configura o shell e as ferramentas de desenvolvimento. O shell interpreta os comandos que você digita. Os runtimes executam as linguagens usadas pela aplicação.
Exemplo de uso
Por exemplo, em um projeto Laravel, o PHP executa o código e o Composer instala as dependências declaradas em composer.json. Depois de preparar a máquina, php --version e composer --version mostram se esses comandos estão disponíveis no terminal. A configuração do banco de dados e as dependências da aplicação ainda precisam ser conferidas no projeto.
Bom saber
No Windows, esse percurso atende ao trabalho dentro de uma distribuição Linux no WSL2. O WSL2 permite usar esse ambiente Linux junto ao Windows. Para preparar ferramentas diretamente no PowerShell, consulte a Windows Edition (Beta).
O que vem instalado
- Homebrew
- PHP, Composer e Laravel
- Ruby, Go, Rust e Python
- Node.js 24, Bun e PNPM
- Docker, Ansible e GitHub CLI
- Zsh, Oh My Zsh e Starship
- Tmux e plugins TPM
- CLIs de IA e PM2
Requisitos
macOS 12+, Linux (computador ou VPS de desenvolvimento) e WSL

SetupVibe Windows
Seu computador com Windows 11, versão Beta
Você pode trabalhar com ferramentas de desenvolvimento no próprio Windows 11. A Windows Edition (Beta) usa PowerShell para instalar utilitários e preparar Python, Node.js e as CLIs de IA compatíveis. Uma CLI é uma ferramenta usada por comandos no terminal. A edição preserva os perfis do PowerShell. Antes de instalar essa versão Beta, confira as limitações documentadas.
Exemplo de uso
Por exemplo, para executar um script JavaScript no Windows, você precisa que o comando node esteja disponível. Depois da instalação, abra um novo terminal e use node --version para conferir o runtime. Para um script Python, python --version verifica o interpretador instalado. Esses testes mostram as versões disponíveis, sem executar uma aplicação sua.
Bom saber
A edição também instala a base do WSL2, sem acrescentar uma distribuição Linux. Para desenvolver dentro do Ubuntu no WSL2, você ainda precisa preparar essa distribuição e seguir o percurso Desktop. Escolha conforme o terminal no qual pretende trabalhar.
O que vem instalado
- WinGet e Chocolatey
- Python 3.14 e Node.js 24 LTS
- Claude Code, Codex CLI e Antigravity CLI
- Base do WSL 2, sem distribuição
- OpenSSH e Windows Terminal
- Perfis do PowerShell preservados
Requisitos
Windows 11 22H2+ (build 22621+), x64

SetupVibe Server
Aplicações em produção
Ao colocar aplicações em produção num servidor Linux, você precisa acessar o terminal e acompanhar serviços e containers. A Server Edition prepara esse servidor em Ubuntu, Debian e Zorin OS compatíveis. Se a máquina remota serve para programar ou rodar agentes de IA, use a Desktop Edition. O SSH permite acessar o terminal pela rede. Os containers executam aplicações com suas dependências, enquanto o Docker permite acompanhar seu estado.
Exemplo de uso
Por exemplo, depois de acessar um servidor que usa Docker, docker ps lista os containers em execução. A lista ajuda a identificar o nome e o estado de cada container. Ela não confirma, por si só, que uma aplicação responde corretamente. Para investigar uma falha, confira também os logs e teste o endereço da aplicação.
Bom saber
A instalação possui uma opção para iniciar o Docker Swarm Manager. O Swarm organiza serviços em um conjunto de máquinas Docker. A criação desse conjunto depende da configuração de rede e do endereço escolhido para o servidor. O comando correspondente fica na página de instalação.
O que vem instalado
- Docker, Ansible e GitHub CLI
- Node.js 24 via APT
- Zsh, Oh My Zsh e Starship
- Tmux e plugins TPM
- CLIs de IA e Herdr
- Rede, monitoramento e Tailscale
Requisitos
Ubuntu 24.04+, Debian 12+ e Zorin OS 18+

SetupVibe Omarchy
Seu Omarchy 4 em x86_64
Uma instalação existente do Omarchy 4 já fornece shell, tmux, Docker e ferramentas de desenvolvimento. A edição Omarchy do SetupVibe acrescenta sua configuração sobre esse ambiente e preserva os componentes fornecidos pelo sistema. Use esse percurso para adicionar as ferramentas do SetupVibe ao Omarchy em uma máquina x86_64.
Exemplo de uso
Por exemplo, para trabalhar com Laravel, você pode precisar do Composer além das ferramentas que já usa no Omarchy. A edição acrescenta ferramentas como PHP e Composer conforme o que estiver ausente. Depois da instalação, command -v composer mostra onde o terminal encontra o comando. Em seguida, composer --version permite conferir a versão disponível.
Bom saber
As configurações próprias do SetupVibe ficam em ~/.config/setupvibe/. Essa separação ajuda a localizar os arquivos acrescentados sem confundi-los com os arquivos do Omarchy. Confira o guia da edição para saber quais componentes são preservados e quais ferramentas são adicionadas.
O que vem instalado
- Instala só os pacotes ausentes
- Usa omarchy pkg add
- Preserva shell, aliases e tmux do Omarchy
- Configurações em ~/.config/setupvibe
Requisitos
Omarchy 4 sobre Arch Linux, x86_64, com sudo
Compare o que cada edição instala
A edição é escolhida pelo papel da máquina. Para programar, inclusive numa VPS com agentes de IA, use o Desktop. Para rodar aplicações em produção, use o Server.
DesktopSeu computador ou VPS de desenvolvimento | WindowsSeu computador com Windows 11, versão Beta | ServerAplicações em produção | OmarchySeu Omarchy 4 em x86_64 | |
|---|---|---|---|---|
| PHP, Ruby, Go, Rust e Python | Instala | Só Python | Não instala | Instala |
| Node.js, Bun e PNPM | Instala | Só Node.js | Só Node.js | Instala |
| Docker | Instala | Não instala | Instala | Já vem no Omarchy |
| Ansible e GitHub CLI | Instala | Só GitHub CLI | Instala | Ansible |
| Zsh, Oh My Zsh e Starship | Instala | Não instala | Instala | Só Starship |
| tmux | Instala | Não instala | Instala | Já vem no Omarchy |
| Agentes de IA e Herdr | Instala | Sem Herdr | Instala | Completa os do Omarchy |
| Tailscale | Instala | Instala | Instala | Instala |
| Servidor SSH | No Linux | OpenSSH | Instala | Não instala |
| WSL 2 | Não instala | Sem distribuição | Não instala | Não instala |
| Docker Swarm Manager | Não instala | Não instala | Com --manager | Não instala |



