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

Perguntas frequentes

14 respostas sobre o SetupVibe

Respostas sobre instalação, edições, Herdr, tmux, PM2 e CLIs de IA no SetupVibe. Os scripts são públicos, então você lê o que cada edição faz antes de executar.

O SetupVibe apaga arquivos antigos do meu computador?

Os scripts instalam pacotes e alteram arquivos de configuração. Na Desktop Edition, por exemplo, a instalação grava ~/.zshrc e ~/.tmux.conf. Preserve uma cópia dos seus arquivos antes de executar e revise o script da edição escolhida. As rotinas de backup variam entre as edições.

É gratuito de verdade?

Sim. O SetupVibe é open source, sob a licença GPL-3.0, e não cobra pelo uso. Todo o código dos scripts fica no repositório do projeto no GitHub.

Posso instalar no Windows?

Sim. A Windows Edition (Beta) prepara o ambiente nativo no Windows 11 x64 com PowerShell. Outra possibilidade é usar a Desktop Edition dentro de uma distribuição Linux no WSL2. Por exemplo, para executar ferramentas Linux no Ubuntu instalado no WSL2, consulte o percurso Desktop. Para trabalhar no PowerShell do Windows, consulte a edição Windows. Compare os requisitos em Edições.

Quais distribuições Linux são suportadas?

A compatibilidade depende da edição. A Server Edition atende Ubuntu 24.04+, Debian 12+ e Zorin OS 18+. A edição Omarchy exige uma instalação existente do Omarchy 4 em x86_64. Para um desktop Linux, confira os requisitos da Desktop Edition antes de executar o script. Uma distribuição derivada não recebe confirmação de compatibilidade apenas por usar APT.

Uso o Herdr ou o tmux?

Para trabalhar com agentes de IA, hoje usamos o Herdr, que mostra na barra lateral o estado de cada agente. O tmux continua instalado para sessões comuns do shell. Evite abrir um dentro do outro, porque os dois usam o prefixo Ctrl + b. Veja o guia do Herdr.

Meus atalhos de teclado ficaram estranhos ou o mouse parou. Como resolver no tmux?

As configurações de tmux do SetupVibe ativam o mouse e incluem o plugin tmux-better-mouse-mode. Para conferir a opção na sessão atual, execute tmux show-options -g mouse. O valor on indica que o mouse está ativado. Se a sessão usa outra configuração, compare o arquivo carregado com o guia de tmux antes de alterar os atalhos.

Como instalo ou recarrego os plugins do tmux?

O TPM gerencia os plugins declarados em ~/.tmux.conf. Dentro de uma sessão tmux, pressione Ctrl + b e depois I maiúsculo para instalar os plugins declarados. O TPM precisa estar instalado e carregado. Consulte o guia de tmux para conferir a configuração.

Qual é a tecla de prefixo do tmux?

O prefixo configurado é Ctrl + b. Pressione essa combinação, solte as teclas e depois pressione a tecla do atalho. Por exemplo, Ctrl + b seguido de c cria uma janela na sessão atual. Configurações pessoais podem alterar esse prefixo.

O tmux preserva as sessões numa queda de energia?

O SetupVibe configura o tmux-resurrect e o tmux-continuum para salvar informações da sessão a cada dez minutos. A restauração depende de um salvamento disponível e dos plugins carregados. Esse recurso não recupera a memória de todos os processos nem substitui o salvamento dos arquivos. Depois de uma interrupção, confira os painéis restaurados e reinicie os serviços necessários.

Por que usar PM2 para tudo em vez da ferramenta das linguagens?

O PM2 acompanha processos e pode reiniciá-los quando encerram ou falham. Você também pode configurar uma reinicialização ao atingir um limite de memória. Uma resposta HTTP 500, por exemplo, pode acontecer enquanto o processo continua ativo. Nesse caso, consulte os logs da aplicação para investigar a falha. Veja as estratégias de reinicialização do PM2.

Como acompanho se o PM2 está online?

Execute pm2 list, ou o alias pl, para ver o estado de cada processo. O valor online indica que ele está rodando. Para acompanhar CPU, memória e logs em tempo real, use pm2 monit, ou o alias pmon.

Os processos do PM2 voltam depois de reiniciar a VPS?

Na edição Desktop, inclusive numa VPS de desenvolvimento, o SetupVibe instala o PM2 e configura a inicialização dele pelo sistema. A edição Server, feita para aplicações em produção, não instala o PM2. Se você usa o PM2 num servidor de produção, instale e configure a inicialização antes de esperar a restauração depois de um reboot. O comando pm2 save salva a lista de aplicações que deve ser iniciada novamente. Ele não congela a memória dos processos. Consulte a configuração de inicialização do PM2 e verifique os serviços depois de reiniciar a máquina.

Eu ainda preciso fazer login ou configurar chaves de API no Claude Code e no Codex?

A instalação da CLI e a autenticação são etapas diferentes. Depois de instalar, abra a ferramenta e siga o método de acesso documentado por ela. No Claude Code, por exemplo, o tipo de acesso usado define como o consumo é cobrado. O SetupVibe não fornece credenciais nem inclui uma assinatura dos serviços de IA.

Por que usar a IA no terminal se posso usar pelo site?

Uma CLI de IA pode trabalhar com arquivos e executar ferramentas no terminal. No Claude Code, o acesso depende das permissões e dos diretórios configurados. O modelo também tem uma janela de contexto, que limita quanto texto ele considera de uma vez. Por exemplo, ler um arquivo não significa que todo o repositório foi analisado. Confira os arquivos usados pelo agente e revise as alterações antes de aceitá-las. Consulte as permissões do Claude Code e os limites de contexto e uso.

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.