Hax：用C语言编写的极简终端原生编码代理

Hax — минималистичный терминальный агент для программирования, написанный на C. Он поставляется в виде одного нативного бинарника с минимальными зависимостями, запускается мгновенно и использует всего несколько МБ ОЗУ, оставляя больше памяти для ваших локальных LLM.

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

• Лёгкий по дизайну: Один нативный бинарник на C с небольшим набором зависимостей. Запускается мгновенно и потребляет очень мало памяти (всего несколько МБ) — так что больше ОЗУ остаётся для ваших локальных LLM.
• Локальные модели в приоритете: Hax автоматически обнаруживает модель и возможности рантайма. Никаких блоков конфигурации провайдера для стандартной настройки не требуется. Пример:

llama-server -m [model].gguf
hax --provider llama.cpp

• Уважает ваш терминал: Потоковый Markdown и живой вывод инструментов переформатируются для отображения. Перерисовывается только текущая потоковая строка или область ввода, сохраняя нативную прокрутку. Не захватывает и не портит ваш терминал.
• Прозрачность: Видно точно, что было отправлено модели и что она ответила в удобном виде транскрипта (Ctrl+T). По желанию можно собирать детальную трассировку протокола.
• Используйте любого провайдера/модель: Поддерживает OpenAI (+совместимые), Anthropic (+совместимые), Codex (через подписку ChatGPT), OpenRouter, llama.cpp и т.д.
• Хорошо ведущий себя Unix-инструмент: Пути XDG, чистый stdout в одноразовом режиме -p с подсказками для возобновления в stderr, конфигурация и файлы сессий в виде обычного текста, композиция через подпроцессы вместо плагинов.

Для кого это

Для разработчиков, которые живут в терминале, запускают локальные модели, проверяют, что делают их инструменты, пакуют ПО для дистрибутивов или запускают агентов в условиях ограниченных ресурсов. Если вам нужны маркетплейсы MCP, среда выполнения плагинов, панели IDE или запросы разрешений для каждой команды — другие агенты делают именно это; hax намеренно этого не делает, и в docs/philosophy.md объясняется каждое упущение.

Начало работы

Hax работает на Linux и macOS; на Windows используйте его через WSL. Установка через Homebrew:

brew install oleksandrchekhovskyi/hax/hax

На Arch Linux hax доступен в AUR как hax. На любом Linux вы можете скачать готовый статический бинарник (x86_64 или aarch64) из последнего релиза и добавить его в PATH.

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

git clone https://github.com/OleksandrChekhovskyi/hax.git
cd hax
scripts/install_deps.sh  # Debian/Ubuntu, Fedora, Arch, openSUSE, Alpine, macOS
make                     # бинарник в ./build/hax
make install             # опционально; может запросить sudo

Запустите hax из каталога проекта, с которым хотите работать:

hax                # интерактивный REPL
hax -p "list TODOs"  # выполнить один запрос и вывести финальный ответ
printf "explain x" | hax -p   # читать запрос из stdin
hax -c             # продолжить последнюю сессию для этого каталога
hax --resume       # выбрать прошлую сессию для этого каталога
hax --resume=ID -p "next"   # возобновить конкретную сессию в одноразовом режиме

Проще всего начать с интерактивного режима: запустите hax, затем используйте /provider, чтобы увидеть доступных провайдеров и выбрать модель. Hax запоминает выбранных в интерактивном режиме провайдера, модель и уровень усилий. Подробности о настройке провайдеров и полную документацию см. в README.