O que muda no seu terminal
Três mudanças aparecem já na primeira sessão depois da instalação.
O prompt mostra onde você está
Antes de cada comando, o Starship mostra a pasta atual e a branch do Git. Você confere o projeto antes de executar, sem digitar
pwdougit branch.O Zsh ajuda a digitar
O plugin zsh-autosuggestions sugere o resto do comando a partir do histórico. O zsh-syntax-highlighting colore o comando enquanto você digita. Um comando que não existe muda de cor antes do Enter.
Atalhos para o dia a dia
Comandos longos viram duas ou três letras.
gsmostra ogit status,dpslista os containers ereloadrecarrega o shell.
Atalhos do shell
Digite o nome do atalho para executar o comando associado. Os exemplos abaixo correspondem às configurações atuais de Zsh das edições Desktop e Server. O comando completo permanece disponível para consulta.
reloadsource ~/.zshrcRecarrega a configuração do Zsh no terminal atual.
zconfignano ~/.zshrcAbre a configuração principal do Zsh no nano.
zlocalnano ~/.zshrc.localAbre suas configurações pessoais do Zsh no nano.
clsclearLimpa a tela do terminal.
..cd ..Volta para a pasta imediatamente acima da atual.
...cd ../..Volta dois níveis na sequência de pastas.
hhistory | grepBusca um termo no histórico. Por exemplo, digite
h dockerpara procurar comandos comdocker.pathecho -e ${PATH//:/\\n}Lista os diretórios usados para localizar programas.
Aliases de Git
Você encontra gs para git status e gb para git branch nos três arquivos Zsh. Use esses comandos para consultar o projeto sem inferir seu estado apenas pela apresentação do prompt.
Aliases do Docker
Você encontra aliases para Docker nos três arquivos Zsh, incluindo dps para docker ps e dc para docker compose. Esses aliases são comandos de shell, separados da configuração do Starship.
Zsh e Oh My Zsh
O Desktop e o Server configuram o Zsh, os plugins e o Starship em arquivos do seu usuário. Você pode revisar o .zshrc e guardar as suas alterações no .zshrc.local.
Zsh e Oh My Zsh
Os scripts instalam Oh My Zsh e os plugins zsh-autosuggestions e zsh-syntax-highlighting. Você encontra os dois nomes na lista plugins dos arquivos Zsh do Desktop e do Server.
Configurações pessoais
Use zlocal para abrir ~/.zshrc.local e guardar suas personalizações do shell. As configurações do SetupVibe carregam esse arquivo ao iniciar o Zsh. Preserve uma cópia dos seus arquivos antes de editar. Depois, reload aplica a configuração à sessão atual.
Runtimes no shell
O arquivo Zsh do Linux Desktop inclui ~/.local/go/bin, ~/.cargo/bin, ~/.rbenv/bin e ~/.bun/bin na preparação do PATH. Você deve conferir o comando encontrado em cada sessão antes de usar uma linguagem.
Caminhos dos programas
O PATH é a lista de diretórios que o shell consulta para encontrar um programa. Para saber qual executável do Node.js será usado, execute command -v node. O atalho path lista os diretórios dessa busca, um por linha. Confira essa ordem quando houver mais de uma instalação da mesma ferramenta.
Starship e o preset Gruvbox Rainbow
O Starship desenha o prompt. O SetupVibe aplica o preset Gruvbox Rainbow e grava o resultado num arquivo que você pode ler e editar.
O papel do Starship
Os arquivos Zsh executam starship init zsh quando encontram o comando. O tema do Oh My Zsh fica vazio nessa configuração. Na Omarchy, a integração é feita no Bash, com um arquivo próprio do SetupVibe.
Preset Gruvbox Rainbow
Desktop e Server executam starship preset gruvbox-rainbow e ajustam separadores no arquivo gerado. O Desktop acrescenta --force ao reaplicar o preset. Você pode revisar o resultado em ~/.config/starship.toml.
Instalação do Starship
No Linux Desktop, o Starship é instalado em ~/.local/bin quando ainda está ausente. O Server usa esse mesmo diretório e executa o instalador oficial. No macOS, a instalação usa Homebrew.
Conferir o arquivo do prompt
O Desktop e o Server gravam o preset em ~/.config/starship.toml. Você pode revisar o arquivo aplicado ao seu terminal. O conteúdo vem do preset público na versão do Starship instalada.
Editar o arquivo do prompt
No Desktop e no Server, você pode abrir ~/.config/starship.toml no seu editor. Preserve uma cópia antes de alterar. A reexecução do Desktop reaplica o preset com --force. Na Omarchy, o script mantém o arquivo próprio se ele já existir.
Fontes e símbolos
Os ícones do prompt dependem de uma Nerd Font. O SetupVibe instala as fontes. Você escolhe uma nas preferências do terminal.
Fontes e símbolos
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.
Fontes no macOS
No macOS, o Desktop tenta instalar FiraCode Nerd Font, JetBrains Mono e JetBrains Mono Nerd Font pelos casks correspondentes. Esses comandos não fixam uma versão das fontes.
Fontes no Linux
No Linux, o Desktop baixa os ZIPs FiraCode e JetBrainsMono da versão 3.4.0 para ~/.local/share/fonts. Depois, executa fc-cache -f.
Em cada edição
O Desktop e o Server usam o Zsh com o Starship. A edição Windows mantém o PowerShell nativo, sem Zsh nem Starship. A edição Omarchy preserva o Bash do sistema e integra um prompt próprio.
SetupVibe DesktopZsh, Oh My Zsh e Starship
SetupVibe WindowsPowerShell nativo, sem Zsh nem Starship
SetupVibe ServerZsh, Oh My Zsh e Starship
SetupVibe OmarchyBash do sistema, com um prompt Starship próprio
Prompt na Omarchy
A edição Omarchy grava um preset próprio em ~/.config/setupvibe/starship.toml quando o arquivo ainda não existe. A integração Bash define STARSHIP_CONFIG para esse caminho e preserva o arquivo anterior do Omarchy.