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.
Programar conversando com agentes de IA, com as chaves guardadas, cada commit conferido e os agentes numa caixa de areia.
Em resumo
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.
~/.config que só você lê, carregado em cada terminal..env em todos os projetos.curl | sh.Passo a passo
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.
Para este rolê, o bora pergunta:
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.
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.
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.
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.
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
Toque numa receita pronta para ver o passo a passo dela. Os ids das planejadas são provisórios.
base/atualizar
Pronta
dev/git
Pronta
dev/compilacao
Pronta
dev/python
Pronta
dev/node
Pronta
containers/podman
Pronta
dev/ferramentas
Pronta
seguranca/segredos
Pronta
ia/chaves-de-api
Pronta
ia/agentes
Pronta
ia/caixa-de-areia · recomendada
Pronta
desktop/flatpak · com o VSCodium ou o Zed
Pronta
dev/editor
Pronta
ia/ollama · opcional, com o modelo que cabe na máquina
Pronta
ia/lm-studio · opcional
Pronta
Os porquês
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.
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.
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.
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.
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
Os pedidos viram issues no GitHub, onde qualquer pessoa pode comentar, votar com um 👍 ou se oferecer para fazer.
Uma opção nova, um comportamento diferente ou algo que este rolê ainda não faz.
Fazer um pedidoUsa Fedora, Arch ou outra família? Diga qual, e conte se puder testar.
Pedir outra distroUma mudança que o bora ainda não sabe fazer, dentro deste rolê ou fora dele.
Pedir uma receitaAlgo não funcionou como esta página diz? O formulário já vem com o roteiro.
RelatarFicou confuso? Sugira um jeito melhor de dizer, direto no arquivo.
Ver no GitHub