Pular para o conteúdo
Linux para todos os rolês
  1. Rolês e receitas
  2. Rolês
  3. Vibecodar

Vibecodar

Programar conversando com agentes de IA, com as chaves guardadas, cada commit conferido e os agentes numa caixa de areia.

Testado · 15 receitas EstudantesEntusiastas 4 GB de memória e 20 GB livres
Uma trilha de pegadas que passa, em ordem, pelas 15 receitas do rolê. As de contorno cheio já estão prontas; as tracejadas ainda estão planejadas. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 sudo bora
Cada parada é uma receita, aplicada nesta ordem.

Em resumo

O que faz e o que não faz

Testado e no menu do bora. Toda semana, cada receita é aplicada, conferida e desfeita em máquinas virtuais de verdade, no Ubuntu 24.04, no Ubuntu 26.04 e no Debian 13, inclusive com a tela de login e o navegador. O registro de testes de cada receita mostra a última vez. Mudou de ideia? Cada receita sabe se desfazer, e o bora tira um snapshot antes de aplicar.

O que o rolê faz

  • Tudo do “Começar a programar”, com o Python e o Node.js juntos, mais o ripgrep, o fd, o jq e o GitHub CLI, que os agentes usam o tempo todo.
  • Instala os agentes que você escolher (Claude Code, Codex, Copilot CLI, OpenCode e Mistral Vibe) na sua conta, sem sudo, pelos pacotes oficiais de cada fabricante.
  • Ensina o bora aos agentes, com uma skill que mostra como montar um plano e pedir para você aplicar.
  • Guarda as chaves de API num arquivo em ~/.config que só você lê, carregado em cada terminal.
  • Confere cada commit com o gitleaks, e o Git passa a ignorar os arquivos .env em todos os projetos.
  • Coloca os agentes numa caixa de areia, se você quiser, onde eles só escrevem na pasta do projeto e não veem as suas chaves SSH.
  • Instala o editor que você escolher: VS Code, VSCodium, Zed ou só o terminal.
  • Roda modelos no próprio computador, se você quiser, com o Ollama ou o LM Studio. O bora mede a memória da máquina, sugere o modelo que cabe e, no Ollama, baixa esse modelo se você aceitar.

O que ele não faz

  • Nenhum agente recebe sudo. Quem aplica mudanças no sistema é sempre você, pelo bora.
  • Não pergunta nem guarda a sua chave de API no plano: você cola a chave no arquivo, depois.
  • Não assina planos pagos nem cria contas por você.
  • Ainda não traz o Antigravity CLI, que só tem instalador do tipo curl | sh.
  • Não promete milagre com modelo local: numa máquina com pouca memória, o bora diz que o agente fica melhor na nuvem.
  • Não esconde que este é o rolê que mais quebra: os agentes mudam toda semana, e a máquina virtual do CI confere todos toda semana.

Passo a passo

Como o bora leva você até lá

  1. Escolha o rolê no menu

    Rode sudo bora no terminal. O menu mostra só os rolês que cabem na sua máquina e na sua distro, e você escolhe pelo número. Ainda não tem o bora? Veja como instalar.

  2. Responda o que for preciso em português

    Para este rolê, o bora pergunta:

    • Quais agentes você quer: Claude Code, Codex, Copilot CLI, OpenCode ou Mistral Vibe? (o padrão é o OpenCode)
    • Vai usar chave de API: OpenRouter, DeepSeek ou outra? (o padrão é não)
    • Qual editor: VS Code, VSCodium, Zed ou só o terminal? (o padrão é o terminal)
    • Quer rodar os agentes numa caixa de areia? (o padrão é sim)
    • Quer rodar modelos no próprio computador: Ollama, com o modelo que o bora sugere ou um seu, LM Studio ou os dois? (o padrão é não)
    • Que e-mail vai nos seus commits? Use o mesmo da sua conta no GitHub ou no GitLab.
  3. Revise o plano nada mudou ainda

    O bora mostra o plano: as receitas, na ordem, com os parâmetros. Você pode aplicar agora, só simular, ou salvar o plano para revisar com calma, versionar ou aplicar em outra máquina.

  4. Snapshot antes de mudar o ponto de volta

    Se o snapshot do sistema já estiver configurado, o bora tira uma foto do sistema antes da primeira mudança. Se o próprio rolê configura o snapshot, as próximas mudanças já ganham o ponto de volta.

  5. Uma receita de cada vez verificar, aplicar, testar

    Cada receita primeiro verifica se já está aplicada, e pula se estiver. Depois aplica e testa. Se uma falhar, o bora para ali, diz o que aconteceu e como voltar, em vez de seguir em frente torcendo. As 15 receitas deste rolê estão logo abaixo.

  6. Pronto quando o teste que qualquer pessoa faz

    Cada agente responde no terminal (na primeira vez, ele pede para entrar na sua conta), e um projeto de exemplo é criado, versionado e tem o commit barrado pelo gitleaks quando leva uma chave. Com o Ollama, o modelo baixado responde a um ollama run no terminal.

  7. Para voltar atrás sudo bora desfazer

    O bora remove os agentes, o editor, o gitleaks, a caixa de areia, o Ollama (com os modelos dele) e o LM Studio que instalou, e volta o Git e o .bashrc ao que eram. Os seus projetos, a chave SSH, os logins dos agentes e o arquivo de chaves, se você colou alguma, ficam onde estão.

As receitas

15 receitas, nesta ordem

Toque numa receita pronta para ver o passo a passo dela. Os ids das planejadas são provisórios.

  1. 1. Sistema atualizadoAtualiza os programas e liga as atualizações automáticas de segurança. base/atualizar Pronta
  2. 2. GitGit com seu nome, seu e-mail e uma chave SSH para o GitHub ou o GitLab. dev/git Pronta
  3. 3. Ferramentas de compilaçãoCompilador, make e o que mais os pacotes de programação pedem. dev/compilacao Pronta
  4. 4. Python com ambientes virtuaisPython para projetos, sem mexer no Python que a distro usa. dev/python Pronta
  5. 5. Node.jsO Node.js LTS oficial, com o npm instalando sem sudo. dev/node Pronta
  6. 6. Contêineres com PodmanContêineres que rodam na sua conta, sem permissão de administrador. containers/podman Pronta
  7. 7. Ferramentas do terminalO ripgrep, o fd, o jq e o GitHub CLI, que os agentes usam o tempo todo. dev/ferramentas Pronta
  8. 8. Verificação de segredosO gitleaks confere cada commit, para nenhuma chave ir parar no GitHub. seguranca/segredos Pronta
  9. 9. Chaves de API guardadasUm lugar para as chaves, com permissão só do dono. ia/chaves-de-api Pronta
  10. 10. Agentes de IA no terminalClaude Code, Codex, Copilot CLI, OpenCode e Mistral Vibe, na sua conta, sem sudo. ia/agentes Pronta
  11. 11. Caixa de areia para os agentesOs agentes escrevem só na pasta do projeto, sem ver as suas chaves e sem sudo. ia/caixa-de-areia · recomendada Pronta
  12. 12. Flatpak e FlathubA loja de aplicativos que funciona igual em qualquer distro. desktop/flatpak · com o VSCodium ou o Zed Pronta
  13. 13. Editor de códigoO VS Code, o VSCodium ou o Zed, ou só o terminal. dev/editor Pronta
  14. 14. IA local com OllamaModelos de IA rodando no próprio computador, com o modelo que cabe nele. ia/ollama · opcional, com o modelo que cabe na máquina Pronta
  15. 15. IA local com LM StudioModelos de IA no próprio computador, com janela para escolher e conversar. ia/lm-studio · opcional Pronta

Os porquês

Por que assim

Por que caixa de areia?

Um agente roda comandos no seu computador. Na caixa, um comando errado, ou uma instrução escondida num arquivo do projeto, estraga no máximo a pasta do projeto, que está no Git.

Por que o gitleaks?

Colar uma chave de API num arquivo e fazer commit é o acidente mais comum de quem começa com agentes. O gitleaks barra o commit antes.

Por que qualquer agente serve?

O rolê não depende de um fornecedor. O OpenCode funciona com modelos gratuitos, o Codex com a conta gratuita do ChatGPT e o Copilot CLI com o plano gratuito do Copilot.

Por que modelo local?

Sem conta, sem cota e sem o código sair do computador. O preço é memória: o bora modelos mostra o que cabe, e os modelos que usam poucos parâmetros por vez andam bem até sem placa de vídeo.

Por que os agentes na minha conta?

Assim eles nunca rodam como root e se atualizam sozinhos, sem sudo. É também o que deixa a caixa de areia fazer sentido.

Bora melhorar

Falta alguma coisa?

Os pedidos viram issues no GitHub, onde qualquer pessoa pode comentar, votar com um 👍 ou se oferecer para fazer.