Freebuff: бесплатный AI-кодинг-агент в терминале

Freebuff — бесплатная версия AI-кодинг-агента Codebuff. В репозитории CodebuffAI/freebuff собрана вся кодовая база, из которой собираются и сам CLI-помощник Codebuff, и его бесплатный аналог: без подписки, кредитов и настройки. Вместо одной модели для всего Codebuff координирует несколько специализированных агентов, которые совместно разбираются в проекте и вносят точные изменения.

Freebuff: бесплатный кодинг-агент

Freebuff работает прямо в терминале. Установка и запуск:

npm install -g freebuff
cd ~/my-project
freebuff

Дальше агент сам находит нужные файлы, вносит изменения и запускает тесты.

Почему Freebuff бесплатный

• Лучшие открытые модели — DeepSeek, MiMo и MiniMax, без привязки к проприетарным моделям.
• Быстро — ускорение в 5–10×: модели быстрее, а контекст собирается за секунды вместо минут.
• Нагружен по умолчанию — встроенные веб-исследования, использование браузера и многое другое.

Монетизация — текстовая реклама. В полном режиме доступны DeepSeek V4 Pro, MiMo 2.5 Pro, DeepSeek V4 Flash, MiMo 2.5 и MiniMax M3; в ограниченном — DeepSeek V4 Flash и MiMo 2.5. Gemini 3.1 Flash Lite отвечает за поиск файлов и исследования. Полный режим работает в США, Канаде, Великобритании, ЕС и ряде других стран, ограниченный — во всех остальных (включая использование через VPN). Ограниченный режим даёт 6 сессий по одному часу в день.

Особенности Freebuff

• Упоминания файлов — обращение к конкретным файлам через @filename
• Упоминания агентов — вызов специализированных агентов через @AgentName
• Bash-режим — выполнение команд через !command или /bash
• История диалогов — продолжение прошлых сессий через /history
• Knowledge-файлы — файл knowledge.md в проекте для контекста
• Темы — переключение светлой и тёмной темы через /theme:toggle

Команды

Как работает Codebuff

Когда вы просите Codebuff «добавить авторизацию в мой API», он может задействовать четырёх агентов:

1. File Picker Agent — сканирует кодовую базу, чтобы понять архитектуру и найти нужные файлы
2. Planner Agent — планирует, какие файлы менять и в каком порядке
3. Editor Agent — вносит точные правки
4. Reviewer Agent — проверяет изменения

По данным авторов, на собственных эвалах Codebuff обходит Claude Code с результатом 61% против 53% на 175+ задачах в нескольких open-source репозиториях. Мультиагентный подход даёт лучшее понимание контекста, точнее правки и меньше ошибок по сравнению с инструментами на одной модели.

Свои агенты

Команда /init создаёт стартовую структуру проекта:

knowledge.md               # контекст проекта для Codebuff
.agents/
└── types/                 # определения типов TypeScript
    ├── agent-definition.ts
    ├── tools.ts
    └── util-types.ts

Агент описывается файлом, в котором задаются модель, набор инструментов и промпт. Например, агент git-committer анализирует изменения через git diff и git log, а затем отдаёт управление LLM для создания осмысленного commit message:

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() {
    // Analyze what changed
    yield { tool: 'run_terminal_command', command: 'git diff' }
    yield { tool: 'run_terminal_command', command: 'git log --oneline -5' }

    // Stage files and create commit with good message
    yield 'STEP_ALL'
  },
}

Агенты могут порождать субагентов, ветвиться по условиям и выполнять многошаговые процессы. Опубликованные агенты переиспользуются через каталог — авторы называют это «Codebuff agents are the new MCP!».

SDK

Codebuff встраивается в приложения через SDK (npm install @codebuff/sdk). Клиент позволяет запускать как базовый кодинг-агент, так и кастомных агентов с собственными определениями и инструментами:

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

Почему Codebuff

• Кастомные воркфлоу — TypeScript-генераторы сочетают AI-генерацию с программным контролем
• Любая модель на OpenRouter — от Claude и GPT до Qwen и DeepSeek, без привязки к вендору
• Переиспользование агентов — публичные агенты на codebuff.com/store
• SDK — кастомные инструменты, интеграция с CI/CD, встраивание в собственные продукты

Репозиторий лицензирован под Apache-2.0 и развивается сообществом: от исправления багов и новых агентов до улучшения документации. Полная версия CLI ставится через npm install -g codebuff.