Binharic CLI

Binharic

Мультипровайдерный AI coding-агент с персоной Tech-Priest

Binharic — терминальный AI coding-ассистент (coding-агент), похожий на OpenAI Codex, Google Gemini CLI и Anthropic Claude Code — но с личностью истового Tech-Priest ордена Adeptus Mechanicus. Binharic написан на TypeScript и использует фреймворк AI SDK для большей части своей агентной логики (вызов инструментов, управление рабочими процессами). Архитектура в значительной степени следует рекомендациям из статьи Anthropic building effective agents.

Разработка Binharic началась как личный проект для изучения устройства терминальных coding-агентов. Однако проект вырос в полноценного coding-ассистента с множеством возможностей — анализ проектов, запуск тестов, поиск багов и код-ревью.

Возможности

• Может использовать модели OpenAI, Google, Anthropic и Ollama
• Полностью настраивается и расширяется (системный промпт, добавление новых инструментов)
• Встроенный keyword-based retrieval-augmented generation (RAG) пайплайн
• Большой набор встроенных инструментов (чтение файлов, запуск Bash-команд)
• Поддержка внешних инструментов через Model Context Protocol (MCP)
• Предопределённые workflow для типичных задач разработки (отладка, код-ревью)

Список реализованных и планируемых возможностей — в ROADMAP.md.

[!IMPORTANT] Binharic находится на ранней стадии разработки, поэтому возможны баги и breaking changes. Сообщайте о проблемах и запрашивайте функции на странице issues.

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

Инструкции по установке и использованию Binharic в терминале.

Установка

npm install -g @cogitator/binharic-cli

Запуск в терминале

# Убедитесь, что API-ключи доступны в окружении
export OPENAI_API_KEY=<ваш-openai-api-ключ>
export ANTHROPIC_API_KEY=<ваш-anthropic-api-ключ>
export GOOGLE_API_KEY=<ваш-google-api-ключ>

# Запустить Binharic в терминале
binharic

[!NOTE] Производительность coding-агента вроде Binharic в значительной степени зависит от используемой модели. Рекомендуется использовать современные модели (Claude Sonnet 4.5, GPT-5, Gemini 2.5 Pro) для лучших результатов.

Запуск в контейнере

Альтернативно, Binharic можно запустить в контейнере:

# API-ключи уже должны быть доступны в окружении
docker run -it --rm \
  -v ${PWD}:/workspace \
  -e OPENAI_API_KEY \
  -e ANTHROPIC_API_KEY \
  -e GOOGLE_API_KEY \
  ghcr.io/cogitatortech/binharic-cli:<version>

<version> нужно заменить на версию Binharic (например, 0.1.0-alpha.6) или использовать latest для последней (девелоперской) версии.

Конфигурация

Binharic настраивается через файл ~/.config/binharic/config.json5. Также поддерживаются переменные окружения. Подробнее — в docs (в разработке).

Документация

Подробнее об использовании Binharic — в docs.

Контрибьютинг

Как внести вклад в проект — в CONTRIBUTING.md.

Лицензия

Проект распространяется под лицензией MIT (см. LICENSE).

Благодарности

• Логотип с SVG Repo с некоторыми изменениями.