---

🌟 Что это такое простыми словами?

Обычные ИИ-ассистенты забывают контекст и архитектуру ваших репозиториев, как только закрывается чат.

OB2H (OmnesBot to Harness) — это локальный «мозг», долговременная память и AST-граф кода для AI-агентов (Hermes, Claude Code, Cursor, Windsurf, ZCode, Gemini CLI, Qwen Code, OpenCode), полностью написанный на Rust.

Он даёт агенту возможность:

1. 🧠 Помнить всё важное о вас и ваших проектах: факты, предпочтения, стек технологий и архитектурные решения.
2. 🏛️ Строить детерминированный AST-граф кода (вдохновлено Graphify): мгновенно сканирует кодовую базу (Rust, Python, TS/JS, Go, SQL, PHP, Dart, Java, C/C++), извлекает классы, функции, интерфейсы, трейты/миксины и связи со 100% точностью и без расхода токенов LLM.
3. 👑 Выявлять ключевые узлы архитектуры (God Nodes): автоматически рассчитывает связность и передает агенту компактный архитектурный дайджест.
4. 💥 Оценивать безопасность рефакторинга (Blast Radius / project_impact): находит все зависимые функции/файлы и оценивает уровень риска изменений (Low, Medium, High).
5. 🔍 Искать код естественным языком: гибридный семантический поиск по кодовому графу (RRF $k=60$ + локальный Candle MiniLM 384d).
6. 📁 Работать с нулевой настройкой (Zero-Config): автоматически определяет корень репозитория, уважает правила .gitignore и привязывает сессию.
7. ⚡ Реагировать на изменения на лету (File Watcher + Git hooks): автоматически обновляет граф при сохранении файлов в IDE.
8. 🌙 «Видеть сны» (Дриминг): пока вы отдыхаете, агент ночью в фоне анализирует историю дня, удаляет устаревшие данные, обновляет файлы памяти (SOUL.md, USER.md, MEMORY.md) и сохраняет версии в Git.
9. 🔄 Помнить одно и то же на нескольких машинах: домашний ПК и агент на VPS синхронизируют память и граф знаний между собой через защищенный SSH.
10. 🤖 Подключаться к любому AI-агенту в 1 клик: ob2h agent install --all и диагностика ob2h doctor --fix.
11. 🎓 Обучаемая память: каждая запись имеет машинный trust — использование, feedback агента и ночная ревизия дримом поднимают или гасят его; устаревшее уходит из выдачи управляемо, без автоудалений.
12. 🕸️ Multi-hop поиск (PPR): Personalized PageRank по памяти и графу знаний находит связанные факты, до которых линейный поиск не доходит.
13. 🔁 Ralph Knowledge Layer: знание о циклах разработки (вердикты по тестам, AST-дельты, reuse-кандидаты, debt-леджер) — для автономных agentic-циклов.
14. 🌙 Ночной bench-гейт: дрим, ухудшивший качество поиска (recall/MRR), автоматически откатывается той же ночью.

Кому подходит: у кого Hermes живёт на двух машинах (ПК + VPS/сервер, работа + дом) и кому нужна приватная память — все данные остаются на ваших машинах, наружу уходит только трафик к вашему LLM-API и (по желанию) SSH между вашими же серверами.

---

⚡ Почему именно версия на Rust?

---

🚀 Быстрая установка (в 1 клик)

Шаг 1. Скачайте проект или релиз

Склонируйте репозиторий:

git clone https://github.com/Pofium/ob2h.git
cd ob2h

Шаг 2. Запустите инсталлятор

Просто дважды кликните по файлу:

👉 install.bat

(Или выполните команду ob2h install в терминале).

Скрипт автоматически:

• Соберет оптимизированный исполняемый файл ob2h.exe.
• Создаст резервную копию вашего конфига Hermes.
• Зарегистрирует сервер ob2h в config.yaml.

Шаг 3. Перезапустите Hermes (или любого поддерживаемого агента)

Откройте вашего агента — все 36 инструментов MCP (память, граф знаний, код, дриминг, Ralph-циклы) активируются автоматически!

Шаг 3.5 (рекомендуется). Включите «постоянную память» — плагин

ob2h plugin install
ob2h skill install

Затем добавьте в блок memory: конфига Hermes строку provider: ob2h и перезапустите Hermes. Теперь каждый ход диалога пишется в память автоматически, а релевантные воспоминания всплывают перед каждым ответом (индикатор 🧠) — без просьб и команд.

Шаг 3.6. Автоматическая настройка для других агентов (1 клик)

ob2h agent install --agent all
ob2h doctor --fix

Команда автоматически обнаружит и сконфигурирует Claude Code, Cursor, Windsurf, ZCode, Gemini/Antigravity, Qwen Code и OpenCode!

---

🛠️ Как это работает в диалоге с Hermes?

Вам не нужно писать специальные команды — агент использует память сам:

• Сохранение:

  «Запомни: я люблю кофе без сахара, а мой текущий проект — OmnesBot на Rust»
  ↳ Hermes вызовет memory_save и зафиксирует факт с высоким приоритетом.

• Вспоминание:

  «Какой кофе мне заказать и над чем я работаю?»
  ↳ Hermes выполнит memory_search (гибридный поиск FTS5 + векторный RRF) и сразу ответит с учётом ваших предпочтений.

• Анализ документов:

  «Изучи этот документ и добавь связи в граф»
  ↳ Инструмент knowledge_extract извлечёт структуру, людей и связи в граф знаний.

• Сложные вопросы по графу:

  «Кто отвечает за архитектуру в проекте X и как он связан с модулем Y?»
  ↳ Инструмент graph_reason пройдёт по графу связей и выдаст обоснованный ответ с цепочкой рассуждений.

---

🔄 Синхронизация двух машин (PC ↔ VPS)

У вас Hermes дома на Windows и Telegram-агент на Linux-VPS? С v0.9 их память и граф знаний — общие: рассказали дома о новом проекте — серверный агент уже в курсе. Обмен — инкрементальные дельта-бандлы v2 поверх SSH: только изменённое (курсор по updated_at), поле-уровневый merge без молчаливого LWW (журнал conflicts.jsonl, проигравшие версии — в meta.conflict_versions за флагом), в бандле — память, trust, memory_links и удаления. Идемпотентность, авто-бэкап перед импортом, ob2h sync verify — сверка дрейфа без переноса. Живая БД никогда не передаётся.

Кому это надо:

• ПК + VPS: общий мозг у десктопного и Telegram/gateway-агента;
• два компьютера (работа/дом): одна память без облака;
• каждая машина — живая реплика памяти другой (дополнительный бэкап).

Быстрый старт (полный гайд — docs/SYNC.md):

# PC: data/sync/peers.json (образец scripts/pc/peers.example.json)
#   { "origin": "pc", "priority": ["pc","vps"], "after_dream": true,
#     "peers": { "vps": { "method": "ssh", "host": "my-vps",
#       "push_to": "/root/ob2h_data/sync/inbox",
#       "pull_from": "/root/ob2h_data/sync/outbox" } } }
ob2h sync push --peer vps && ob2h sync pull --peer vps   # обмен вручную…
# …или само: после каждого ночного дрима (after_dream) + задача планировщика 05:30

# VPS: peers.json {"origin":"vps"} + таймер из scripts/vps/
#   systemctl enable --now ob2h-sync.timer

Диагностика: ob2h sync status на обеих машинах. Без прямого SSH между машинами — режим manual (Syncthing/приватный git, только папка бандлов — никогда саму БД).

---

💻 Управление через консоль (CLI)

Вы можете в любой момент посмотреть статистику или запустить дриминг вручную:

# Посмотреть статистику базы знаний и памяти
ob2h stats

# Проверить состояние дриминга
ob2h dream status

# Запустить процесс дриминга вручную
ob2h dream run

# Посмотреть историю изменений файлов памяти
ob2h dream log

# Создать резервную копию базы данных и воркспейса
ob2h backup

# Удалить интеграцию из Hermes при необходимости
ob2h uninstall

# Синхронизация двух машин (PC ↔ VPS)
ob2h sync push --peer vps && ob2h sync pull --peer vps
ob2h sync status

# Деплой плагина памяти и скилла в Hermes
ob2h plugin install
ob2h skill install

# Состояние плагина (установлен? включён в конфиге?)
ob2h plugin status

# Глубокая диагностика всех систем, баз данных, моделей и агентов
ob2h doctor
ob2h doctor --fix   # автоисправление конфигов агентов и Git-хуков

# Мультиагентное управление (Claude, Cursor, Windsurf, ZCode, Gemini, Qwen, OpenCode)
ob2h agent install --agent all
ob2h agent status

# Управление проектами и AST-сканирование кодовой базы
ob2h project list
ob2h project scan --id <project_id>
ob2h project report --id <project_id>
ob2h project dead-code --id <project_id>   # мёртвые символы (без entrypoints)
ob2h project repo-map --id <project_id>    # карта репо под token budget

# Регрессионный контур поиска: golden set, recall@k/MRR, история прогонов
ob2h bench                                 # прогон на живой БД (data/bench/golden.jsonl)
ob2h bench --mode history                  # тренд ночных прогонов + вердикты

# Лёгкая база и бэкапы
ob2h db quantize-embeddings --dry-run      # int8-квантование эмбеддингов (оценка)
ob2h backup --scope quick                  # быстрый бэкап памяти+воркспейса
ob2h backup verify data/backups/<копия>    # проверка целостности копии

# Гигиена памяти
ob2h memory dedup --dry-run                # кандидаты на слияние (без LLM)

# Ralph-циклы разработки
ob2h ralph findings-to-memory --project <id>

---

⚙️ Настройки и переменные окружения

По умолчанию всё работает без дополнительных настроек. При необходимости тонкой настройки можно задать переменные в .env или конфиге:

---

📦 Навыки для агентов и IDE (skills/)

Проект поставляет готовые навыки (SKILL.md) для всех поддерживаемых агентов/IDE/harness — файлы лежат в skills/<агент>/SKILL.md и описывают: как подключён OB2H в этом агенте на конкретной машине (путь MCP-конфига, версия, команда ob2h agent install), ключевые команды и питфоллы. Покрыты: claude-code, codegraph, codex, cursor, deepx, gemini-cli, hermes-agent, kilo-code, kimi-code, mimo-code, opencode, qoder, qwen-code, trae, windsurf, zcode (плюс каноничный ob2h).

Канал установки скилла в Hermes: ob2h skill install; мультиагентное подключение — ob2h agent install --agent all и ob2h doctor --fix.

---

🤝 Обратная связь и Issues

Проект активно развивается! Если у вас:

• 💡 Есть идея новой фичи или предложения по улучшению;
• 🐛 Возникла ошибка или проблема с установкой;
• ❓ Появился вопрос по интеграции;

👉 Пожалуйста, создайте Issue на GitHub! Мы обязательно ответим и поможем разобраться. Любой фидбек очень ценен!

---

💖 Поддержать разработку

Если этот проект помог вам сделать вашего персонального ассистента умнее и сэкономил время, вы можете сказать спасибо и поддержать дальнейшую разработку:

---

📄 Лицензия

Распространяется под свободной лицензией MIT.