Топор: 12-мегабайтный CLI для узкоспециализированных LLM-агентов

Что такое Axe

Axe — это 12-мегабайтный бинарный файл на Go с двумя зависимостями (cobra, toml), который заменяет AI-фреймворки подходом к LLM-агентам, вдохновлённым философией Unix. Вместо долгоживущих сессий чат-ботов он запускает узкоспециализированных агентов, определённых в конфигурационных TOML-файлах. Каждый агент выполняет конкретную задачу, такую как ревью кода, анализ логов или написание сообщений к коммитам.

Ключевые возможности

• Конфигурация на основе TOML: Декларативные, версионируемые определения агентов с системными промптами, выбором модели, файлами навыков и контекстными файлами
• Передача данных через stdin: git diff | axe run reviewer работает напрямую
• Делегирование суб-агентам: Агенты могут вызывать других агентов через инструменты LLM с ограничением глубины и параллельным выполнением
• Постоянная память: Логи в формате markdown с временными метками сохраняют контекст между запусками, с очисткой устаревших данных при помощи LLM
• Поддержка нескольких провайдеров: Работает с Anthropic, OpenAI, Ollama (локальные модели) или любым форматом models.dev
• Встроенные инструменты: Веб-поиск, загрузка по URL и операции с файлами в песочнице (чтение, запись, редактирование, список), ограниченные рабочим каталогом агента
• Поддержка MCP: Возможность подключения любого MCP-сервера к агентам
• Система навыков: Переиспользуемые наборы инструкций, общие для нескольких агентов
• Вывод в JSON: Структурированный вывод с метаданными для скриптов
• Режим пробного запуска: Проверка собранного контекста без вызова LLM

Установка и настройка

Требуется Go 1.24+. Установка через:

go install github.com/jrswab/axe@latest

Или сборка из исходников:

git clone https://github.com/jrswab/axe.git
cd axe
go build .

Инициализация конфигурации:

axe config init

Создаёт структуру каталогов в $XDG_CONFIG_HOME/axe/ с примером навыка и файлом config.toml по умолчанию для учётных данных провайдера.

Примеры использования

Создание и запуск агента:

axe agents init my-agent
axe agents edit my-agent
axe run my-agent

Передача данных из других инструментов:

git diff --cached | axe run pr-reviewer
cat error.log | axe run log-analyzer

Копирование примеров агентов из каталога examples/:

cp examples/code-reviewer/code-reviewer.toml "$(axe config path)/agents/"
cp -r examples/code-reviewer/skills/ "$(axe config path)/skills/"
export ANTHROPIC_API_KEY="your-key-here"
git diff | axe run code-reviewer

Развёртывание в Docker

Сборка образа:

docker build -t axe .

Сборка для нескольких архитектур (linux/amd64, linux/arm64) через buildx:

docker buildx build --platform linux/amd64,linux/arm64 -t axe:latest .

Запуск агента с подключённой конфигурацией:

docker run --rm \
  -v ./my-config:/home/axe/.config/axe \
  -e ANTHROPIC_API_KEY \
  axe run my-agent

Передача stdin с флагом -i:

git diff | docker run --rm -i \
  -v ./my-config:/home/axe/.config/axe \
  -e ANTHROPIC_API_KEY \
  axe run my-agent

Для кого это

Разработчики, которые хотят автоматизировать конкретные AI-задачи без накладных расходов фреймворков, особенно те, кто уже использует Unix-инструменты, git-хуки, cron или CI-пайплайны.