SetupVibe Desktop: instalação e ferramentas incluídas

Configuração de ambiente de desenvolvimento multiplataforma — v0.41.8

Instala e configura um stack de desenvolvedor completo em um comando. Suporta macOS e as principais distribuições Linux.

Requisitos do Sistema

	Suportado
macOS	12 Monterey ou superior
Ubuntu	24.04+
Debian	12+
Zorin OS	18+
Linux Mint	21+
Arquiteturas	x86_64 (amd64), ARM64 (aarch64)

Não execute com sudo no macOS — o Homebrew se recusa a instalar como root. Execute normalmente e o script solicitará sua senha quando necessário.

Instalação

1
curl -sSL desktop.setupvibe.dev | bash

Ou localmente:

1
bash desktop.sh

O script exibe um roteiro interativo e solicita confirmação antes de iniciar. Também solicita a configuração da identidade do Git, caso ainda não esteja definida.

O Que é Instalado

14 etapas, totalmente automatizadas.

Etapa 1 — Sistema Base e Ferramentas de Build

Linux: instalação via APT — build-essential, git, wget, unzip, curl, tmux, ffmpeg, imagemagick, bibliotecas SSL/compressão e o repositório APT do Charmbracelet (para o glow).

macOS: depende do Xcode Command Line Tools (verifica e encerra se não estiver presente). As ferramentas base são instaladas via Homebrew na próxima etapa.

Etapa 2 — Homebrew

macOS: instala o Homebrew se ausente, depois instala ferramentas base (wget, curl, tmux, ffmpeg, imagemagick, openssl, readline, etc.)
Linux: instala o Linuxbrew em /home/linuxbrew/.linuxbrew. Adiciona entradas de PATH ao ~/.bashrc, ~/.profile, ~/.zshrc. Executa brew upgrade se já presente

Etapa 3 — Ecossistema PHP 8.5

Componente	macOS	Linux
PHP 8.5	via Homebrew	via PPA ondrej/php (Ubuntu) ou sury.org (Debian)
Extensões	redis, xdebug, imagick via PECL	php8.5-{curl,mbstring,xml,zip,bcmath,intl,mysql,pgsql,sqlite3,gd,imagick,redis,mongodb,yaml,xdebug}
Composer	via Homebrew	binário em `~/.local/bin/composer`
Laravel installer	`composer global require laravel/installer`	igual

Etapa 4 — Ecossistema Ruby

Componente	macOS	Linux
rbenv	via Homebrew	clonado do GitHub em `~/.rbenv`
ruby-build	via Homebrew	clonado em `~/.rbenv/plugins/ruby-build`
Ruby	3.4.10 compilado via rbenv	igual
Bundler + Rails	`gem install bundler rails`	igual

Etapa 5 — Linguagens

Linguagem	macOS	Linux
Python 3	`python@3.14` via Homebrew	via APT (`python3`, `python3-pip`, `python3-venv`)
uv	via script de instalação	igual
qrcode	`pip --user` com CLI `qr`	igual
Go	via Homebrew	binário 1.26.5 verificado em `~/.local/go`
Rust	via rustup	igual

Etapa 6 — JavaScript

Ferramenta	macOS	Linux
Node.js 24	`node@24` via Homebrew	via repositório APT NodeSource
PNPM	`npm install -g pnpm`	igual
PM2	`npm install -g pm2`	igual
n8n	`npm install -g n8n`	igual
Bun	via script de instalação	igual

No Linux, os pacotes npm globais usam o prefixo gravável ~/.npm-global do usuário-alvo, mesmo quando o instalador é executado por sudo. PNPM, PM2, n8n e Bun são validados após a instalação.

Etapa 7 — DevOps

Ferramenta	macOS	Linux
Docker	Docker Desktop via Homebrew Cask	docker-ce + docker-compose-plugin + docker-buildx-plugin via Docker APT repo
Portainer	via Docker Compose em `~/.setupvibe`	mesmo
Ansible	via Homebrew	via PPA ansible/ansible (Ubuntu) ou ansible-core (Debian)
GitHub CLI (`gh`)	via Homebrew	via repositório APT do GitHub

Etapa 8 — Ferramentas Unix Modernas

Instaladas via Homebrew em ambas as plataformas.

Ferramenta	Descrição
`bat`	`cat` com realce de sintaxe
`eza`	Substituto moderno do `ls`
`zoxide`	`cd` mais inteligente
`fzf`	Buscador fuzzy (com atalhos de shell)
`ripgrep`	Substituto rápido do `grep`
`fd`	Substituto rápido do `find`
`lazygit`	Interface terminal para git
`lazydocker`	Interface terminal para Docker
`neovim`	Vim moderno
`glow`	Renderizador de Markdown
`jq`	Processador JSON
`tldr`	Páginas simplificadas fornecidas por `tlrc`
`fastfetch`	Ferramenta de informações do sistema
`duf`	`df` moderno
`mise`	Gerenciador de versões de runtime

Etapa 9 — Rede, Monitoramento e Tailscale

macOS: wget, nmap, mtr, htop, btop, glances, speedtest-cli via Homebrew. bandwhich, gping, trippy, rustscan via Cargo. ctop via Homebrew. Tailscale via Cask.

Linux: mesmas ferramentas via APT + Cargo + binário ctop verificado com SHA-256 em ~/.local/bin. Tailscale via script oficial de instalação.

Etapa 10 — Servidor SSH (somente Linux)

Instala openssh-server
Habilita e inicia o serviço systemd ssh
Configura PermitRootLogin prohibit-password e PasswordAuthentication yes
Faz backup do sshd_config original antes de modificar

Etapa 11 — Shell (ZSH e Starship)

Instala ZSH pelo APT no Linux. O ZSH já é padrão no macOS
Instala Oh My Zsh (sem interação)
Clona os plugins zsh-autosuggestions e zsh-syntax-highlighting
Instala Nerd Fonts: FiraCode e JetBrains Mono. Usa Homebrew Cask no macOS e baixa a v3.4.0 em ~/.local/share/fonts no Linux
Instala o prompt Starship e aplica o preset Gruvbox Rainbow
Baixa scripts auxiliares de bin/ para ~/.setupvibe/bin. Veja Executáveis
Baixa o .zshrc adequado:
- macOS → conf/zshrc-macos.zsh
- Linux → conf/zshrc-linux.zsh

Etapa 12 — Tmux e Plugins

Clona o TPM em ~/.tmux/plugins/tpm
Baixa conf/tmux-desktop.conf para ~/.tmux.conf
Encerra qualquer sessão tmux em execução para aplicar a nova configuração

Pressione prefix + I dentro do tmux para instalar todos os plugins. Consulte tmux.md para a referência completa de plugins e atalhos de teclado.

Passo 13 — Ferramentas de IA (CLI)

Instala pacotes npm globalmente e o Herdr pelo manifesto oficial de releases:

Ferramenta	Instalação
Agentlytics	`agentlytics`
Claude Code	`@anthropic-ai/claude-code`
OpenAI Codex	`@openai/codex`
GitHub Copilot CLI	`@github/copilot`
Skills CLI	`skills`
Herdr	Binário do manifesto oficial

Cada CLI listado é validado após a instalação. O Herdr é instalado em ~/.local/bin conforme o sistema operacional e a arquitetura detectados. Consulte o guia do Herdr para entender sessões, atalhos, atualizações e diagnóstico. O Spec-Kit é instalado via uv tool install specify-cli. Veja o SPECKIT.md para o guia completo de Spec-Driven Development e aliases.

Passo 14 — Finalização e Limpeza

macOS: brew cleanup --prune=all, brew autoremove e remove somente arquivos temporários do SetupVibe.

Linux: apt autoremove, apt clean, remove arquivos temporários e limpa logs do journal. Também limpa ~/.cache/pip, ~/.cache/composer, ~/.npm/_npx, ~/.bundle/cache.

Ambos: configura inicialização automática do PM2 (launchd no macOS, systemd no Linux), executa pm2 save, define pm2:autodump true e baixa ecosystem.config.js com tentativas HTTPS limitadas para ~/ecosystem.config.js.

Consulte pm2.md para a referência completa do PM2.

Configuração do Shell

Cada plataforma recebe um .zshrc dedicado:

Arquivo	Plataforma	Caminhos principais
`zshrc-macos.zsh`	macOS	Homebrew, Cargo, Composer, Go, Bun
`zshrc-linux.zsh`	Linux	Linuxbrew, npm-global, Cargo, Go, Bun, rbenv

Aliases

Alias	Comando
`reload`	`source ~/.zshrc`
`zconfig`	`nano ~/.zshrc`
`sshcopykey`	`sshcopykey --host HOST --user USUARIO [--pass SENHA]`
`update`	`brew update && brew upgrade` (macOS) / `sudo apt update && sudo apt upgrade` (Linux)
`brewup`	`brew update && brew upgrade && brew cleanup`
`cc`	`claude --permission-mode=auto --dangerously-skip-permissions`
`skl`	`skills list`
`skf`	`skills find`
`ska`	`skills add`
`sku`	`skills update`
`d`	`docker`

Plugins Oh My Zsh

git rsync cp extract zoxide fzf zsh-autosuggestions zsh-syntax-highlighting brew gh ansible docker docker-compose laravel composer rails ruby python pip node npm bun golang rust + macos (somente macOS) / nmap tmux (somente Linux)

Contribuição

Contribuições de todos os tamanhos são bem-vindas! Por favor, leia nosso Guia de Contribuição para começar.

Licença

Licenciado sob a GNU General Public License v3.0 — veja LICENSE para detalhes.

Mantido por promovaweb.com · contato@promovaweb.com