Quando eu comecei a incentivar o uso do Linux na comunidade da Promovaweb, o Zorin foi uma das opções que indiquei. Também montei o SetupVibe para configurar o ambiente e reunir os utilitários usados na formação. Você precisa dessas ferramentas na máquina para acompanhar o trabalho com os agentes, porque parte das tarefas que eles executam acontece no terminal.
O ripgrep é um exemplo. Quando um agente usa esse programa para procurar o nome de uma função nos arquivos do projeto, a pesquisa é executada no computador. O resultado permite localizar os trechos do código que precisam ser examinados. A ferramenta precisa estar acessível no ambiente usado pelo agente para que essa busca possa acontecer.
Foi esse uso da máquina que considerei ao preparar o SetupVibe. A Desktop Edition instala o ripgrep junto das ferramentas de desenvolvimento. Você tem um script público para consultar como o ambiente é preparado e quais programas estarão disponíveis durante o trabalho no projeto.
Direto ao ponto
A preparação feita pelo SetupVibe precisa corresponder ao lugar onde o agente executa seus comandos. Uma instalação no notebook não fornece automaticamente as mesmas ferramentas a uma sessão remota. Na máquina escolhida, você confere se o terminal encontra os programas e depois verifica os requisitos da aplicação que pretende desenvolver.
A busca nos arquivos depende de uma ferramenta na máquina
O ripgrep pesquisa texto nos arquivos de um diretório. Por padrão, ele respeita as exclusões do Git e ignora arquivos ocultos e binários. Essas condições ajudam a interpretar o resultado: uma pesquisa sem correspondências também pode exigir a conferência dos arquivos que ficaram fora da busca.
Você pode acompanhar esse uso no terminal quando o agente executa o rg, nome do comando do ripgrep. O texto pesquisado e o diretório escolhido delimitam a investigação. Essa etapa permite encontrar uma função ou uma mensagem dentro do projeto, sem presumir que o modelo já conhece o conteúdo atual de todos os arquivos.
A Desktop Edition do SetupVibe inclui o ripgrep entre os utilitários instalados. Isso fornece uma opção de busca ao ambiente, mas não determina qual ferramenta o agente usará em cada tarefa. As instruções do projeto e as permissões da sessão continuam orientando o trabalho.
O terminal configurado pelo SetupVibe
A mensagem de comando não encontrado exige uma conferência diferente de uma busca sem resultados. No primeiro caso, o shell não conseguiu localizar o programa pelo nome informado. No segundo, a pesquisa foi executada e não encontrou correspondências dentro das condições escolhidas. Você precisa distinguir essas respostas para investigar a instalação ou a pesquisa certa.
O shell consulta os diretórios registrados na variável PATH para localizar um executável chamado pelo nome. Um programa pode estar gravado no disco e ainda ficar inacessível dessa maneira. A sessão que executa o agente precisa conhecer o diretório correto, o que torna insuficiente conferir somente uma janela de terminal diferente daquela usada no trabalho.
Na Desktop Edition, o SetupVibe também configura o Zsh, o shell usado para interpretar comandos. O script aplica um arquivo .zshrc próprio e reserva o .zshrc.local para personalizações. Ao revisar uma máquina já configurada, você precisa conferir onde colocou seus ajustes, pois o arquivo gerenciado pelo instalador pode ser substituído numa nova execução.
Essa preparação participa do ambiente usado na formação. Quando eu relaciono o SetupVibe ao trabalho com agentes, incluo justamente os programas que eles podem executar e a configuração que permite encontrá-los. Você consegue examinar essa relação no script e conferir o resultado no terminal, sem depender de uma descrição genérica de compatibilidade com IA.
O projeto ainda precisa executar seus próprios testes
Encontrar o ripgrep e pesquisar o código confirma uma parte do ambiente. A aplicação tem outras exigências, declaradas nos arquivos do repositório. As versões das dependências precisam corresponder ao projeto e os serviços usados pelos testes precisam estar disponíveis. O instalador da máquina não conhece automaticamente as credenciais de um banco de desenvolvimento nem o comportamento que você espera de uma funcionalidade.
Um teste que precisa acessar esse banco pode falhar por falta de configuração, mesmo com as ferramentas do terminal instaladas. Você interpreta a mensagem para localizar a conexão ausente e consulta a documentação do projeto. Reexecutar o SetupVibe sem identificar a origem do erro pode alterar o ambiente sem corrigir a configuração da aplicação.
Eu mantenho a revisão técnica como parte do trabalho do desenvolvedor com IA. Depois de uma alteração, você precisa saber quais testes foram executados e o que os resultados permitem afirmar. A preparação da máquina fornece ferramentas para esse trabalho, mas a conferência de uma funcionalidade depende dos testes e do comportamento da própria aplicação.
O Plano IA Makers reúne aprendizado de desenvolvimento com IA para continuar esse trabalho no projeto. Para uma investigação acompanhada num sistema já iniciado, o Desenvolvimento Colaborativo da Dev Side Studio oferece orientação técnica ao vivo. Esse apoio faz sentido quando você precisa examinar uma falha junto do código e da configuração que a produzem.
Desktop também atende uma VPS de desenvolvimento
Uma VPS, servidor virtual privado, pode ser a máquina usada para programar e executar agentes remotamente, com a preparação da Desktop Edition. A Server Edition atende servidores que executam aplicações em produção. O nome comercial da máquina não define sozinho qual preparação corresponde ao trabalho que você fará nela.
Ao trabalhar remotamente, você confere as ferramentas no servidor que recebe os comandos. O notebook pode funcionar apenas como ponto de acesso. A leitura sobre acesso ao ambiente remoto com Tailscale aprofunda essa conexão, que precisa estar disponível para você alcançar o terminal da máquina preparada.
A documentação do SetupVibe reúne as edições e as orientações de instalação. Consulte a edição correspondente ao seu sistema e à função da máquina, revise o script e preserve suas configurações. Depois da execução, confira as ferramentas na sessão usada pelo agente e prossiga com as verificações do seu projeto.
