Asistente de IA gratuito para terminal que supera a Claude Code en tareas reales

Los desarrolladores de Anthropic recientemente lansaron el cliente CLI de Claude Code, estableciendo un alto estándar para los asistentes de IA en terminal. ¿Pero qué pasa si la suscripción es demasiado cara y no quieres bloquear tus flujos de trabajo en un solo proveedor? Los creadores del proyecto Codebuff tomaron un enfoque diferente. Lansaron Freebuff — una versión gratuita de su agente CLI, financiada por anuncios de texto no intrusivos en la terminal.

Lo interesante son los resultados. Según los benchmarks de los autores en 175 tareas de proyectos de código abierto reales, el sistema logra un 61% de ediciones exitosas comparado con el 53% de Claude Code. Desglosemos cómo se logra esta precisión y cómo usar la herramienta en el desarrollo cotidiano.

Cómo funciona el enfoque multiagente

La mayoría de los asistentes de terminal envían todo el contexto y tu prompt a un solo modelo de lenguaje grande. Como resultado, la red neuronal intenta simultáneamente buscar archivos en el proyecto, planificar cambios de arquitectura, editar código y asegurar que nada se rompa. En repositorios grandes, este enfoque a menudo falla.

En Codebuff y Freebuff, las tareas se dividen entre agentes especializados. Cuando le pides a la herramienta que agregue autenticación a una API, todo un equipo entra en acción:

1. El Agente de Selección de Archivos escanea el repositorio, analiza las estructuras de carpetas y encuentra solo los archivos relevantes.
2. El Agente Planificador secuencia las ediciones.
3. El Agente Editor realiza los cambios en el código fuente.
4. El Agente Revisor verifica el resultado y ejecuta las pruebas.

Cada paso individual es manejado por un modelo más adecuado para esa tarea. Por ejemplo, Gemini 3.1 Flash Lite se usa para la búsqueda rápida de archivos, mientras que DeepSeek V4 Pro, MiMo 2.5, o MiniMax M3 manejan la generación de código y la planificación.

Inicio rápido con Freebuff

La herramienta se instala a través del gestor de paquetes estándar de Node.js y no requiere registro con tarjeta de crédito ni configuración de claves API.

npm install -g freebuff

Después de la instalación, simplemente navega a la carpeta de tu proyecto y ejecuta:

cd ~/my-project
freebuff

Dentro de la interfaz de consola, describes la tarea en lenguaje natural. El agente encuentra las ubicaciones de código relevantes, realiza las ediciones y ejecuta tus pruebas para verificar que los cambios funcionan.

Para un funcionamiento más preciso, la terminal incluye comandos de ayuda y referencias:

• Mención de archivos vía @filename para especificar contexto explícitamente.
• Dirigirse a agentes específicos vía @AgentName.
• Ejecutar comandos de terminal vía /bash o el prefijo !.
• Guardar el contexto del proyecto en un archivo knowledge.md (creado mediante el comando /init).

La monetización a través de anuncios de texto mantiene el servicio gratuito. Los autores indican honestamente en la documentación: los datos de prompts y código pueden ser analizados para segmentación de anuncios y entrenamiento de modelos, a menos que uses la versión autohospedada de pago con tus propias claves.

Crear agentes personalizados en TypeScript

Si la funcionalidad base no es suficiente, la plataforma Codebuff ofrece un SDK y la capacidad de crear agentes personalizados. Inicialízalo en la raíz de tu proyecto:

/init

Este comando crea una carpeta .agents/ con plantillas de TypeScript. Puedes escribir un agente adaptado al flujo de trabajo específico de tu equipo. Aquí tienes un ejemplo de un agente que analiza cambios de git y crea commits adecuados:

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'
  },
}

La lógica está dividida aquí: los comandos de consola git diff y git log se ejecutan primero, luego el control pasa a la red neuronal para generar la descripción del commit.

Integración en tus aplicaciones a través del SDK

Para automatizar tareas en CI/CD o integrar en tus propias utilidades, los desarrolladores prepararon un paquete npm separado @codebuff/sdk.

Instalación del paquete:

npm install @codebuff/sdk

Código de ejemplo para invocar el agente base desde 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)
  },
})

A diferencia de Claude Code, donde estás atado a la infraestructura de Anthropic, Codebuff soporta conectar cualquier modelo a través de OpenRouter. Esto te permite elegir soluciones para tu presupuesto específico o usar variantes locales.

¿Vale la pena probar?

Freebuff parece una excelente opción para desarrolladores que necesitan un asistente inteligente de repositorio sin facturas de suscripción mensuales. El sistema multiagente genuinamente resuelve el problema de "olvido" que tienen las redes neuronales con bases de código grandes.

Desventajas a considerar: el modelo basado en anuncios en la versión gratuita y el compartir contexto para segmentación. Si estás trabajando en código corporativo cerrado, es más inteligente mirar la versión de pago de Codebuff o usar el SDK con tus propias claves API. Para proyectos personales y trabajo de código abierto, Freebuff está disponible ahora mismo.