Execute um Agente de IA Autônomo Direto no Seu Terminal com o Zero

Com frequência me pego exausto de trocar constantemente entre a janela do IDE, navegador e terminal apenas para fazer edições baseadas em sugestões de redes neurais. A maioria das soluções prontas ou está atrelada a uma assinatura paga específica ou exige entregar todo o seu projeto para servidores de terceiros sem controle claro sobre o que exatamente é enviado para a nuvem. Recentemente descobri um projeto interessante chamado Zero pela equipe do Gitlawb. É um agente de codificação baseado em terminal escrito em Go que roda diretamente na sua máquina com os modelos da sua escolha.

Sem vendor lock-in. Quer conectar um Ollama local ou LM Studio para privacidade completa — pode fazer. Precisa passar uma tarefa complexa de refatoração para o Claude 3.5 Sonnet, DeepSeek ou Gemini — basta adicionar sua chave de API e está pronto.

O que o agente pode fazer e como difere dos concorrentes

O Zero foi projetado como uma ferramenta para desenvolvedores que valorizam o controle. O agente não apenas gera trechos de texto em um chat — ele pode explorar codebases, editar arquivos, executar testes e rodar comandos de terminal.

A principal diferença está na abordagem de segurança e controle de acesso. Por padrão, o agente pode ler arquivos no diretório de trabalho, mas qualquer tentativa de escrever fora do projeto, executar comandos shell perigosos ou acessar a rede passa por um sistema de permissões.

O utilitário funciona em dois modos:

• Modo TUI interativo com suporte a temas, troca de modelo em tempo real, visualização de diffs e navegação por ramificações de conversa.
• Modo automático via o comando zero exec, que pode ser incorporado em scripts bash ou pipelines de CI.

Todas as sessões são armazenadas localmente no disco. Você pode parar o trabalho a qualquer momento, retornar a uma tarefa antiga via /resume, ou criar uma ramificação isolada de uma sessão com o comando /btw para fazer uma pergunta paralela sem poluir o contexto do diálogo principal.

Instalação e primeira execução

O Zero pode ser instalado de várias formas. A mais simples é usando npm ou o script de instalação oficial.

Via npm:

npm install -g @gitlawb/zero
zero

Ou via o script de instalação para Linux e macOS:

curl -fsSL https://raw.githubusercontent.com/Gitlawb/zero/main/scripts/install.sh | bash

Para compilar a partir do código-fonte, você vai precisar do Go versão 1.26.5 ou mais recente:

git clone https://github.com/Gitlawb/zero.git
cd zero
go build -o zero ./cmd/zero

Na primeira execução, o comando zero roda um assistente de configuração interativo. Ele ajuda a selecionar um provedor de modelo e verificar a conexão. Se estiver usando APIs de nuvem, basta exportar a chave necessária antes:

export ANTHROPIC_API_KEY="sk-ant-..."
# или
export OPENAI_API_KEY="sk-..."

Para modelos locais, o utilitário pode detectar automaticamente instâncias do Ollama em execução via o comando zero providers detect.

Cenários de uso no dia a dia

A interface do terminal é responsiva e conveniente. A TUI fornece atalhos de teclado e comandos com barra. Por exemplo, a ciclagem de permissões é feita através de Shift+Tab, e a seleção de modelo é chamada com o comando /model.

/spec        — составить и обсудить план изменений до правок кода
/image       — прикрепить скриншот интерфейса или схемы
/compact     — сжать контекст, если диалог стал слишком длинным
/add-dir     — выдать агенту временные права на запись в соседнюю папку

Se uma interface gráfica não for necessária, o modo headless entra em ação. Digamos que os autotests falharam em um dos seus pacotes Go:

zero exec "fix the failing test in ./pkg"

Para tarefas complexas, é conveniente usar worktrees git isolados para que o agente não mexa na sua branch de trabalho até que você tenha revisado o resultado:

zero exec --worktree "try the migration in an isolated worktree"

O Zero também suporta saída em streaming em formato JSONL via a flag --output-format stream-json, o que simplifica a escrita de wrappers e integração com serviços externos.

Extensibilidade via MCP, plugins e specs

Para ajustar finamente o comportamento do projeto, o Zero lê arquivos de instrução AGENTS.md ou ZERO.md diretamente do repositório. Se você colocar tal arquivo na raiz do projeto, o agente levará em conta os padrões de código da sua equipe, estrutura de diretórios e regras de formatação de commits.

Se as ferramentas integradas não forem suficientes, o projeto suporta:

• O MCP (Model Context Protocol) para conectar bancos de dados externos ou serviços de terceiros.
• Plugins com hooks para eventos de início de sessão ou execução de ações (beforeTool, afterTool).
• Habilidades markdown personalizadas que adicionam cenários específicos de automação.

Quem se beneficiaria do Zero

A ferramenta vai agradar desenvolvedores que frequentemente trabalham em servidores remotos via SSH, adoram utilitários de terminal e não querem depender de plugins proprietários de editores. O sandbox rigoroso baseado em seccomp do Linux e o histórico de sessões local fazem do Zero uma excelente escolha para trabalhar com código corporativo fechado.

Você pode experimentar o projeto em qualquer plataforma — documentação e código-fonte são abertos sob a licença MIT na página do repositório.