Assistente de IA para Terminal Gratuito que Supera o Claude Code em Tarefas Reais

Os desenvolvedores da Anthropic recentemente lançaram o cliente CLI Claude Code, estabelecendo um alto padrão para assistentes de IA no terminal. Mas e se a assinatura for muito cara e você não quiser prender seus fluxos de trabalho a um único provedor? Os criadores do projeto Codebuff adotaram uma abordagem diferente. Eles lançaram o Freebuff — uma versão gratuita do seu agente CLI, financiada por anúncios de texto não intrusivos no terminal.

O interessante são os resultados. De acordo com os benchmarks dos autores em 175 tarefas de projetos open source reais, o sistema alcança 61% de edições bem-sucedidas em comparação com os 53% do Claude Code. Vamos detalhar como essa precisão é alcançada e como usar a ferramenta no dia a dia do desenvolvimento.

Como Funciona a Abordagem Multiagente

A maioria dos assistentes de terminal envia todo o contexto e seu prompt para um único modelo de linguagem grande. Como resultado, a rede neural tenta simultaneamente buscar arquivos no projeto, planejar mudanças de arquitetura, editar código e garantir que nada quebre. Em repositórios grandes, essa abordagem frequentemente falha.

No Codebuff e Freebuff, as tarefas são divididas entre agentes especializados. Quando você pede à ferramenta para adicionar autenticação a uma API, toda uma equipe entra em ação:

1. O Agente Seletor de Arquivos escaneia o repositório, analisa as estruturas de pastas e encontra apenas os arquivos relevantes.
2. O Agente Planejador sequencia as edições.
3. O Agente Editor faz as alterações no código-fonte.
4. O Agente Revisor verifica o resultado e executa os testes.

Cada etapa individual é tratada por um modelo mais adequado para aquela tarefa. Por exemplo, o Gemini 3.1 Flash Lite é usado para busca rápida de arquivos, enquanto o DeepSeek V4 Pro, MiMo 2.5 ou MiniMax M3 lidam com a geração de código e planejamento.

Início Rápido com o Freebuff

A ferramenta é instalada via gerenciador de pacotes padrão do Node.js e não requer registro com cartão de crédito ou configuração de chave de API.

npm install -g freebuff

Após a instalação, basta navegar até a pasta do seu projeto e executar:

cd ~/my-project
freebuff

Dentro da interface do console, você descreve a tarefa em linguagem simples. O agente encontra os locais relevantes do código, faz as edições e executa seus testes para verificar se as alterações funcionam.

Para operação mais precisa, o terminal inclui comandos auxiliares e referências:

• Mencionando arquivos via @filename para especificar contexto explicitamente.
• Dirigindo-se a agentes específicos via @AgentName.
• Executando comandos do terminal via /bash ou o prefixo !.
• Salvando o contexto do projeto em um arquivo knowledge.md (criado via o comando /init).

A monetização através de anúncios de texto mantém o serviço gratuito. Os autores admitem abertamente na documentação: dados de prompt e código podem ser analisados para segmentação de anúncios e treinamento de modelos, a menos que você use a versão paga auto-hospedada com suas próprias chaves.

Criando Agentes Personalizados em TypeScript

Se a funcionalidade base não for suficiente, a plataforma Codebuff oferece um SDK e a capacidade de criar agentes personalizados. Inicialize isso na raiz do seu projeto:

/init

Este comando cria uma pasta .agents/ com templates TypeScript. Você pode escrever um agente adaptado ao fluxo de trabalho específico da sua equipe. Aqui está um exemplo de um agente que analisa mudanças git e cria commits adequados:

export default {
  id: 'git-committer',
  displayName: 'Git Committer',
  model: 'openai/gpt-5-nano',
  toolNames: ['read_files', 'run_terminal_command', 'end_turn'],

  instructionsPrompt:
    'You create meaningful git commits by analyzing changes, reading relevant files for context, and crafting clear commit messages that explain the "why" behind changes.',

  async *handleSteps() {
    yield { tool: 'run_terminal_command', command: 'git diff' }
    yield { tool: 'run_terminal_command', command: 'git log --oneline -5' }
    yield 'STEP_ALL'
  },
}

A lógica é dividida aqui: comandos de console git diff e git log executam primeiro, então o controle passa para a rede neural para gerar a descrição do commit.

Integrando em Seus Aplicativos via SDK

Para automatizar tarefas em CI/CD ou integrar às suas próprias utilidades, os desenvolvedores prepararam um pacote npm separado @codebuff/sdk.

Instalando o pacote:

npm install @codebuff/sdk

Código de exemplo para invocar o agente base do TypeScript:

import { CodebuffClient } from '@codebuff/sdk'

const client = new CodebuffClient({
  apiKey: 'your-api-key',
  cwd: '/path/to/your/project',
  onError: (error) => console.error('Codebuff error:', error.message),
})

const result = await client.run({
  agent: 'base',
  prompt: 'Add error handling to all API endpoints',
  handleEvent: (event) => {
    console.log('Progress', event)
  },
})

Ao contrário do Claude Code, onde você fica preso à infraestrutura da Anthropic, o Codebuff suporta conectar qualquer modelo através do OpenRouter. Isso permite escolher soluções para seu orçamento específico ou usar variantes locais.

Vale a Pena Experimentar?

O Freebuff parece uma ótima opção para desenvolvedores que precisam de um assistente inteligente de repositório sem contas de assinatura mensais. O sistema multiagente genuinamente resolve o problema de "esquecimento" que redes neurais têm com grandes bases de código.

Desvantagens a considerar: o modelo baseado em anúncios na versão gratuita e o compartilhamento de contexto para segmentação. Se você está trabalhando em código corporativo fechado, é mais inteligente olhar para a versão paga do Codebuff ou usar o SDK com suas próprias chaves de API. Para projetos pessoais e trabalho de código aberto, o Freebuff está disponível agora.