[![npm](https://img.shields.io/npm/v/@link-assistant/hive-mind.svg)](https://npmjs.com/@link-assistant/hive-mind) [![License](https://img.shields.io/badge/license-Unlicense-blue.svg)](https://github.com/link-assistant/hive-mind/blob/main/LICENSE) [![GitHub stars](https://img.shields.io/github/stars/link-assistant/hive-mind?style=social)](https://github.com/link-assistant/hive-mind/stargazers) [![Open in Gitpod](https://img.shields.io/badge/Gitpod-ready--to--code-f29718?logo=gitpod)](https://gitpod.io/#https://github.com/link-assistant/hive-mind) [![Open in GitHub Codespaces](https://img.shields.io/badge/GitHub%20Codespaces-Open-181717?logo=github)](https://github.com/codespaces/new?hide_repo_select=true&ref=main&repo=link-assistant/hive-mind) # Hive Mind 🧠 (languages: [en](README.md) • [zh](README.zh.md) • [hi](README.hi.md) • ru) **Главный ИИ, управляющий роем ИИ.** Оркестрирующий ИИ, который управляет другими ИИ. HIVE MIND. SWARM MIND. Также возможно подключить этот ИИ к коллективному человеческому интеллекту — система умеет общаться с людьми для уточнения требований, получения экспертных знаний и обратной связи. [![Universal Problem Solving Algorithm](https://github.com/user-attachments/assets/1d91e911-9ba4-456e-a00a-14cdd60d9a0a)](https://github.com/konard/problem-solving) Вдохновлено проектом [konard/problem-solving](https://github.com/konard/problem-solving) ## Зачем нужен Hive Mind? **Hive Mind — наиболее автономный, облачно-ориентированный ИИ-решатель задач, который устраняет необходимость постоянного контроля со стороны разработчика, сохраняя при этом человеческий надзор над критически важными решениями.** Hive Mind — это **универсальный ИИ** (мини-AGI), способный работать над широким спектром задач, а не только над программированием. Практически всё, что можно сделать с файлами в репозитории, поддаётся автоматизации. | Возможность | Что это означает для вас | | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Без постоянного контроля** | Полный автономный режим с правами sudo. ИИ обладает творческой свободой, как настоящий программист. | | **Изоляция в облаке** | Работает на выделенных виртуальных машинах или в Docker. Легко восстановить в случае поломки. | | **Полный доступ к интернету + Sudo** | ИИ может устанавливать пакеты, получать документацию и настраивать систему по мере необходимости. | | **Предустановленный инструментарий** | Более 25 ГБ готово к работе: 10 языковых сред выполнения, 2 средства доказательства теорем, инструменты сборки. Можно установить дополнительные. | | **Эффективность токенов** | Рутинные задачи автоматизированы в коде, поэтому токены ИИ сосредоточены на творческом решении проблем. | | **Свобода времени** | То, что занимает у людей 2–8 часов, ИИ выполняет за 10–25 минут за рабочую сессию. Возможно массовое выполнение задач в репозитории. «Код пишется, пока вы спите». | | **Масштабирование с оркестрацией** | Параллельные воркеры ощущаются как команда разработчиков. Свяжите Claude MAX и ChatGPT Pro (по $200 каждый), чтобы получить два независимых почти безлимитных бюджета. | | **Контроль со стороны человека** | ИИ создаёт черновые PR — вы решаете, что вливать. Контроль качества там, где это важно. | | **Программирование с любого устройства** | Управляйте ИИ с любого устройства через `/solve` и `/hive` посредством Telegram-бота. ПК, IDE или ноутбук не нужны. | | **100% открытый исходный код** | Лицензия Unlicense (общественное достояние). Полная прозрачность, без привязки к поставщику. | **Стоимость**: Hive Mind поддерживает две подписки по $200 в месяц как полнофункциональные почти «безлимитные» варианты: | Подписка | Используется с `--tool` | Модель по умолчанию | Лучше всего подходит для | | ----------------------------------------------------------------- | ----------------------- | ------------------- | ---------------------------------------------------------- | | **Anthropic Claude MAX** (~$200 в месяц, часто скидка 50% = $400) | `claude` (по умолчанию) | Opus | Максимальная креативность и сильное общее кодовое мышление | | **OpenAI ChatGPT Pro** ($200 в месяц, включает Codex) | `codex` | `gpt-5.6-sol` | Надёжные детерминированные рефакторинги и быстрые итерации | Оба инструмента можно сочетать в одном hive. Воркеры могут параллельно запускать разные инструменты, а `/codex` или `/solve --tool codex` направляет задачи в ChatGPT Pro, тогда как маршрут по умолчанию идёт в Claude MAX. Выбирать только один вариант не требуется: любой одной подписки достаточно для работы, а использование обеих открывает режим параллелизма по инструментам/моделям (#1474). Hive Mind обладает высоким уровнем творчества, неотличимым от среднего программиста. Он задаёт вопросы, если требования неясны, и вы можете уточнять их на ходу через комментарии к PR. Видение проекта и примеры пользовательских сценариев см. в [docs/VISION.ru.md](./docs/VISION.ru.md). Подробные возможности и сравнения см. в [docs/FEATURES.ru.md](./docs/FEATURES.ru.md) и [docs/COMPARISON.ru.md](./docs/COMPARISON.ru.md). ## ⚠️ ПРЕДУПРЕЖДЕНИЕ Запускать это программное обеспечение на вашей рабочей машине НЕБЕЗОПАСНО. Рекомендуется использовать Docker для установки (как локально, так и на серверах). Смотрите раздел [Установка через Docker](#использование-docker) ниже. Это программное обеспечение запускает поддерживаемые ИИ-инструменты, такие как Claude Code и Codex, в полностью автономном режиме, а значит, они могут выполнять любые команды по своему усмотрению. Это может привести к непредвиденным побочным эффектам. Также существует известная проблема утечки дискового пространства. Убедитесь, что вы в состоянии переустановить виртуальную машину для освобождения места и/или устранения любых повреждений. ### ⚠️ КРИТИЧЕСКИ ВАЖНО: Безопасность токенов и конфиденциальных данных **ЭТО ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ НЕ МОЖЕТ ГАРАНТИРОВАТЬ БЕЗОПАСНОСТЬ ВАШИХ ТОКЕНОВ ИЛИ ДРУГИХ КОНФИДЕНЦИАЛЬНЫХ ДАННЫХ НА ВИРТУАЛЬНОЙ МАШИНЕ.** Существует бесконечное множество способов извлечь токены с виртуальной машины, подключённой к интернету. Это включает, но не ограничивается: - **Токены Claude MAX** и/или **токены ChatGPT Pro (Codex)** — необходимы для работы ИИ; можно запускать с любым из них или с обоими - **Токены GitHub** — необходимы для доступа к репозиториям - **API-ключи и учётные данные** — любые конфиденциальные данные в системе **ВАЖНЫЕ СООБРАЖЕНИЯ ПО БЕЗОПАСНОСТИ:** - Запуск на рабочей машине разработчика **АБСОЛЮТНО НЕБЕЗОПАСЕН** - Запуск на виртуальной машине **МЕНЕЕ НЕБЕЗОПАСЕН**, но всё ещё несёт риски - Даже если данные вашей рабочей машины не подвергаются прямому воздействию, виртуальная машина всё равно содержит конфиденциальные токены - Любой токен, хранящийся в системе, подключённой к интернету, потенциально может быть скомпрометирован **ИСПОЛЬЗУЙТЕ ЭТО ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ИСКЛЮЧИТЕЛЬНО НА СВОЙ СТРАХ И РИСК.** Мы настоятельно рекомендуем: - Использовать выделенные изолированные виртуальные машины - Регулярно ротировать токены - Отслеживать использование токенов на предмет подозрительной активности - Никогда не использовать производственные токены или учётные данные - Быть готовыми отозвать и заменить все токены, используемые в этой системе Hive Mind скрывает распознанные учётные данные в обслуживаемых им путях вывода терминала, журналов, телеметрии, загрузок и публикаций GitHub. При сбое сканера публикация блокируется, однако это не мешает автономному инструменту использовать посторонний канал утечки. Соглашение о маскировании, поддерживаемые форматы, процесс сопровождения и рекомендации по реагированию на инциденты приведены в разделе [Санитизация учётных данных](./docs/CREDENTIAL-SANITIZATION.ru.md). По умолчанию задачи, изолированные в Docker, получают учётные данные Claude/Codex оператора. `--use-router` их не передаёт и вместо этого направляет трафик модели через sidecar `hive-mind-router`, выдавая каждой задаче собственный ограниченный токен и собственный журнал запросов — см. [Изоляция через роутер](./docs/ROUTER.ru.md) (экспериментально) и [Сбор журналов](./docs/COLLECTING-LOGS.ru.md). Минимальные системные требования для запуска `hive.mjs`: ``` 1 ядро CPU 1 ГБ ОЗУ > 4 ГБ SWAP 50 ГБ дискового пространства ``` ## 🚀 Быстрый старт ### Глобальная установка #### С помощью Bun (рекомендуется) ```bash bun install -g @link-assistant/hive-mind ``` #### С помощью Node.js ```bash npm install -g @link-assistant/hive-mind ``` ### Установка Docker Если у вас ещё не установлен Docker, выполните следующие шаги для установки Docker Engine на Ubuntu: ```bash # Install prerequisites sudo apt update sudo apt install ca-certificates curl # Add Docker's official GPG key sudo install -m 0755 -d /etc/apt/keyrings sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc sudo chmod a+r /etc/apt/keyrings/docker.asc # Add Docker repository sudo tee /etc/apt/sources.list.d/docker.sources </`, поэтому конфигурация переживает перезапуски, но не влияет на другие репозитории. Пользовательские навыки из `/home/box/.agents/skills` также передаются в Docker-изолированные задачи; если capability недоступна, preflight до запуска ИИ-сессии сообщает точный идентификатор и команду исправления. **Преимущества Docker:** - ✅ Предварительно настроенная среда Ubuntu 24.04 - ✅ Все зависимости предустановлены - ✅ Изолирован от хост-системы - ✅ Легко запускать несколько экземпляров с разными аккаунтами GitHub - ✅ Единообразная среда на разных машинах См. [docs/DOCKER.ru.md](./docs/DOCKER.ru.md) для расширенного использования Docker. #### Остановка и удаление контейнера Docker ``` # Attach to main docker process to stop the container docker attach hive-mind ^C # stop the telegram bot exit # exit/stop the container docker ps -a # show list of docker containers # CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES # fd0fd4470ec3 konard/hive-mind:latest "/bin/bash" 5 days ago Exited (130) 16 seconds ago hive-mind df -h # check disk space # Filesystem Size Used Avail Use% Mounted on # tmpfs 1.2G 1.1M 1.2G 1% /run # /dev/sda1 96G 87G 9.8G 90% / # tmpfs 5.9G 0 5.9G 0% /dev/shm # tmpfs 5.0M 0 5.0M 0% /run/lock # /dev/sda16 881M 117M 703M 15% /boot # /dev/sda15 105M 6.2M 99M 6% /boot/efi # tmpfs 1.2G 12K 1.2G 1% /run/user/0 docker rm hive-mind # remove docker container frees space used by the container, does not delete image df -h # check disk space (to confirm space is freed) # Filesystem Size Used Avail Use% Mounted on # tmpfs 1.2G 1.1M 1.2G 1% /run # /dev/sda1 96G 26G 71G 27% / # tmpfs 5.9G 0 5.9G 0% /dev/shm # tmpfs 5.0M 0 5.0M 0% /run/lock # /dev/sda16 881M 117M 703M 15% /boot # /dev/sda15 105M 6.2M 99M 6% /boot/efi # tmpfs 1.2G 12K 1.2G 1% /run/user/0 ``` ### Установка через Helm (Kubernetes) (Экспериментально) > ⚠️ **ЭКСПЕРИМЕНТАЛЬНО:** Метод установки через Helm/Kubernetes является экспериментальным и может быть нестабильным. > > Для более надёжной установки рекомендуем использовать [Docker](#использование-docker). > > См. [docs/HELM.ru.md](./docs/HELM.ru.md) для полных инструкций по установке через Helm и параметров конфигурации. ### Установка на сервер Ubuntu 24.04 (Устарело) > ⚠️ **УСТАРЕЛО:** Данный метод установки больше не рекомендуется. > > **Теперь мы рекомендуем использовать Docker для всех установок** — как на машинах разработчиков, так и на серверах. > Docker обеспечивает лучшую изоляцию, более простое управление и единообразные среды. > > Пожалуйста, используйте [метод установки через Docker](#использование-docker) выше. > Для развёртывания в Kubernetes см. раздел [Установка через Helm](#установка-через-helm-kubernetes-экспериментально). > > Устаревшие инструкции по установке на «голое железо» перенесены в [docs/UBUNTU-SERVER.ru.md](./docs/UBUNTU-SERVER.ru.md) для справки. ### Основные операции ```bash # Solve using maximum power solve https://github.com/Veronika89-lang/index.html/issues/1 --attach-logs --verbose --model opus --think max # Solve GitHub issues automatically solve https://github.com/owner/repo/issues/123 --model sonnet # Solve issue with PR to custom branch (manual fork mode) solve https://github.com/owner/repo/issues/123 --base-branch develop --fork # Continue working on existing PR solve https://github.com/owner/repo/pull/456 --model opus # Resume from Claude session when limit is reached solve https://github.com/owner/repo/issues/123 --resume session-id # Start hive orchestration (monitor and solve issues automatically) hive https://github.com/owner/repo --monitor-tag "help wanted" --concurrency 3 # Monitor all issues in organization hive https://github.com/microsoft --all-issues --max-issues 10 # Run collaborative review process review --repo owner/repo --pr 456 # Multiple AI reviewers for consensus ./reviewers-hive.mjs --agents 3 --consensus-threshold 0.8 ``` ## 📋 Основные компоненты | Скрипт | Назначение | Ключевые возможности | | ------------------------------------------ | ------------------------------- | ----------------------------------------------------------------------------------- | | `solve.mjs` (стабильный) | Решатель задач GitHub | Автофорк, создание веток, генерация PR, возобновление сессий, поддержка форков | | `hive.mjs` (стабильный) | Оркестрация и мониторинг ИИ | Мониторинг нескольких репозиториев, параллельные воркеры, управление очередью задач | | `review.mjs` (альфа) | Автоматизация проверки кода | Совместные проверки ИИ, автоматизированная обратная связь | | `reviewers-hive.mjs` (альфа / эксперимент) | Управление командой проверяющих | Консенсус мультиагентов, назначение проверяющих | | `telegram-bot.mjs` (стабильный) | Интерфейс Telegram-бота | Удалённое выполнение команд, поддержка групповых чатов, диагностические инструменты | ## 🔧 Параметры solve ```bash solve [options] ``` **Наиболее часто используемые параметры:** | Параметр | Сокр. | Описание | По умолчанию | | --------------- | ----- | ------------------------------------------------------------ | -------------- | | `--model` | `-m` | Используемая модель ИИ (sonnet, opus, haiku) | opus | | `--think` | | Уровень мышления (off, low, medium, high, xhigh, ultra, max) | off | | `--base-branch` | `-b` | Целевая ветка для PR | (по умолчанию) | **Другие полезные параметры:** | Параметр | Сокр. | Описание | По умолчанию | | ------------------------ | ----- | --------------------------------------------------------------------- | ------------ | | `--tool` | | Инструмент ИИ (claude, opencode, codex, agent, qwen, gemini) | claude | | `--verbose` | `-v` | Включить подробное логирование | false | | `--attach-logs` | | Прикрепить логи к PR (⚠️ может раскрыть конфиденциальные данные) | false | | `--auto-init-repository` | | Автоматически инициализировать пустые репозитории (создаёт README.md) | false | | `--help` | `-h` | Показать все доступные параметры | - | > **📖 Полный список параметров**: см. [docs/CONFIGURATION.ru.md](./docs/CONFIGURATION.ru.md#solve-options), включая форкинг, автопродолжение, режим наблюдения и экспериментальные функции. ## 🔧 Параметры hive ```bash hive [options] ``` **Наиболее часто используемые параметры:** | Параметр | Сокр. | Описание | По умолчанию | | -------------- | ----- | ------------------------------------------------------------ | ------------ | | `--model` | `-m` | Используемая модель ИИ (sonnet, opus, haiku) | opus | | `--think` | | Уровень мышления (off, low, medium, high, xhigh, ultra, max) | off | | `--all-issues` | `-a` | Мониторинг всех задач (игнорировать метки) | false | | `--once` | | Одиночный запуск (без непрерывного мониторинга) | false | **Другие полезные параметры:** | Параметр | Сокр. | Описание | По умолчанию | | ------------------------ | ----- | ----------------------------------------------------------------- | ------------ | | `--tool` | | Инструмент ИИ (claude, opencode, codex, agent, qwen, gemini) | claude | | `--concurrency` | `-c` | Количество параллельных воркеров | 2 | | `--skip-issues-with-prs` | `-s` | Пропускать задачи с существующими PR | false | | `--verbose` | `-v` | Включить подробное логирование | false | | `--attach-logs` | | Прикреплять логи к PR (⚠️ может раскрыть конфиденциальные данные) | false | | `--help` | `-h` | Показать все доступные параметры | - | > **📖 Полный список параметров**: см. [docs/CONFIGURATION.ru.md](./docs/CONFIGURATION.ru.md#hive-options), включая мониторинг проектов, интеграцию с YouTrack и экспериментальные функции. ## 🤖 Telegram-бот Hive Mind включает интерфейс Telegram-бота (SwarmMindBot) для удалённого выполнения команд. ### 🚀 Тест-драйв Хотите увидеть Hive Mind в действии? Запросите бесплатную демонстрацию или получите более быструю поддержку, написав разработчику напрямую в Telegram: **[Написать @drakonard в Telegram](https://t.me/drakonard)** ### Настройка 1. **Получить токен бота** - Напишите [@BotFather](https://t.me/BotFather) в Telegram - Создайте нового бота и получите токен - Добавьте бота в групповой чат и назначьте его администратором 2. **Настроить окружение** ```bash # Copy the example configuration cp .env.example .env # Edit and add your bot token echo "TELEGRAM_BOT_TOKEN=your_bot_token_here" >> .env # Optional: Restrict to specific chats # Get chat ID using /help command, then add: echo "TELEGRAM_ALLOWED_CHATS=123456789,987654321" >> .env ``` 3. **Запустить бота** ```bash hive-telegram-bot ``` **Рекомендуется: захват логов с помощью tee** При длительной работе бота рекомендуется сохранять логи в файл с помощью `tee`. Это позволит просмотреть логи позже, даже если буфер терминала переполнится: ```bash hive-telegram-bot 2>&1 | tee -a logs/bot-$(date +%Y%m%d).log ``` Или создайте директорию для логов и запустите с автоматической ротацией: ```bash mkdir -p logs hive-telegram-bot 2>&1 | tee -a "logs/bot-$(date +%Y%m%d-%H%M%S).log" ``` **Экспериментально: live terminal watch** ```bash hive-telegram-bot --auto-start-screen-watch-message ``` Этот opt-in флаг запускает отдельное live terminal сообщение для публичных сессий `/solve`. Для приватных репозиториев или репозиториев с неизвестной видимостью watch-сообщение автоматически не запускается. ### Команды бота Большинство операционных команд работают **только в групповых чатах** (не в личных сообщениях боту). Команды, которые намеренно доставляют приватные обновления, например `/terminal_watch`, также можно использовать в личных сообщениях: #### `/solve` — Решение задач GitHub ``` /solve [options] Examples: /solve https://github.com/owner/repo/issues/123 --model sonnet /solve https://github.com/owner/repo/issues/123 --model opus --think max Aliases: /do и /continue эквивалентны /solve /claude эквивалентна /solve --tool claude /codex эквивалентна /solve --tool codex /opencode эквивалентна /solve --tool opencode /agent эквивалентна /solve --tool agent /qwen эквивалентна /solve --tool qwen /gemini эквивалентна /solve --tool gemini Tool alias examples: /codex https://github.com/owner/repo/issues/123 --model gpt-5.5 /opencode https://github.com/owner/repo/issues/123 --model grok-code-fast-1 /agent https://github.com/owner/repo/issues/123 --model nemotron-3-super-free /gemini https://github.com/owner/repo/issues/123 --model flash /qwen https://github.com/owner/repo/issues/123 --model qwen3-coder-plus /gemini https://github.com/owner/repo/issues/123 --model gemini-2.5-flash Free Models (with --tool agent): /solve https://github.com/owner/repo/issues/123 --tool agent --model nemotron-3-super-free /solve https://github.com/owner/repo/issues/123 --tool agent --model opencode/nemotron-3-super-free /solve https://github.com/owner/repo/issues/123 --tool agent --model minimax-m2.5-free /solve https://github.com/owner/repo/issues/123 --tool agent --model gpt-5-nano Free Models via Kilo Gateway (with --tool agent): /solve https://github.com/owner/repo/issues/123 --tool agent --model kilo/glm-5-free /solve https://github.com/owner/repo/issues/123 --tool agent --model kilo/glm-4.5-air-free /solve https://github.com/owner/repo/issues/123 --tool agent --model kilo/deepseek-r1-free # Маршрутизация любого поддерживаемого агентного CLI через Formal AI /solve https://github.com/owner/repo/issues/123 --tool agent --model formal-ai /solve https://github.com/owner/repo/issues/123 --tool codex --model formal-ai /solve https://github.com/owner/repo/issues/123 --tool claude --model formal-ai ``` > **📖 Руководство по бесплатным моделям**: см. [docs/FREE_MODELS.ru.md](./docs/FREE_MODELS.ru.md) для получения полной информации обо всех бесплатных моделях, включая провайдеры OpenCode Zen и Kilo Gateway. #### `/hive` — Запуск оркестрации Hive ``` /hive [options] Examples: /hive https://github.com/owner/repo /hive https://github.com/owner/repo --all-issues --max-issues 10 /hive https://github.com/microsoft --all-issues --concurrency 3 ``` #### `/merge` — Слияние готовых Pull Request ``` /merge [--auto-resolve] Examples: /merge https://github.com/owner/repo /merge https://github.com/owner/repo/issues/123 /merge https://github.com/owner/repo/pull/456 ``` Цель-репозиторий обрабатывает PR с меткой `ready` последовательно. Цели issue и pull request обрабатывают только связанный или выбранный PR. Также можно ответить командой `/merge` на сообщение с одной ссылкой на GitHub repository, issue или pull request, например на предыдущую команду `/codex ...issues/123`. Если целевой PR ещё не завершён, `/merge` ждёт, пока он станет mergeable, и затем выполняет слияние. Пропуск конфликтов слияния по-прежнему работает с `--auto-resolve`. #### `/fix` — Автоматическое исправление CI/CD ``` /fix --ci-cd [options] Examples: /fix https://github.com/owner/repo --ci-cd /fix owner/repo --ci-cd --tool codex --model gpt-5.5 --think max /fix owner/repo --ci-cd --dry-run /fix owner/repo --ci-cd --no-solve ``` `/fix --ci-cd` определяет языки целевого репозитория, анализирует последний коммит ветки по умолчанию и его запуски CI/CD и автоматически создаёт issue для исправления CI/CD (используя стандартный промпт и шаблоны из [`docs/CI-CD-BEST-PRACTICES.md`](docs/CI-CD-BEST-PRACTICES.md), отсортированные по обнаруженным языкам). Затем он передаёт issue в `/solve --development-log --deep-analysis --auto-merge`. Любая опция, которую `/fix` не использует сам (например, `--tool`, `--model`, `--think`), передаётся в `/solve`. Используйте `--dry-run`, чтобы предварительно просмотреть issue без его создания, или `--no-solve`, чтобы создать issue без запуска `/solve`. Подробнее см. [Автоматическое исправление CI/CD](docs/CI-CD-BEST-PRACTICES.md#automatic-cicd-remediation). Если полный процесс `/fix` недоступен, `/task --ci-cd ` выполняет только тот же этап создания issue для CI/CD. Команда возвращает URL созданного issue; ответьте `/solve --development-log --deep-analysis --auto-merge`, чтобы продолжить исправление обычным процессом solve. #### `/limits` — Показать лимиты использования ``` /limits Shows: - CPU usage and load average - RAM usage (used vs total) - Disk space usage - GitHub API rate limits - Claude and ChatGPT subscription usage windows - Non-zero Codex weekly limits and credits - Solve queue status ``` #### `/terminal_watch` — Live Session Log ``` /terminal_watch [--size 120x25] Examples: /terminal_watch 4d934f71-4cdb-4b8c-b474-582116d12c12 /terminal_watch 4d934f71-4cdb-4b8c-b474-582116d12c12 --width 100 --height 20 ``` Также можно ответить на сообщение сессии бота командой `/terminal_watch`. Команда обновляет отдельное сообщение Telegram последними строками лога сессии, полученного через `$ --status `, и прикрепляет полный файл лога после завершения сессии. Логи публичных репозиториев можно смотреть в чате; логи приватных репозиториев или репозиториев с неизвестной видимостью доставляются только личным сообщением. #### `/help` — Получить справку и диагностическую информацию ``` /help Shows: - Chat ID (needed for TELEGRAM_ALLOWED_CHATS) - Chat type - Available commands - Usage examples ``` ### Возможности - ✅ **Запуск из групповых чатов**: workflows `/solve` и `/hive` запускаются из авторизованных групповых чатов - ✅ **Полная поддержка параметров**: все параметры командной строки работают в Telegram - ✅ **Screen-сессии**: команды запускаются в отсоединённых screen-сессиях - ✅ **Live Terminal Watch**: `/terminal_watch` и opt-in auto-start показывают live session logs - ✅ **Ограничения по чатам**: опциональный белый список разрешённых ID чатов - ✅ **Приватная проверка auth**: экспериментальные `/auth --status ` и `/auth --login ` для владельцев разрешённых чатов - ✅ **Диагностические инструменты**: получение ID чата и информации о конфигурации #### Live Terminal Watch Если включить `--auto-start-screen-watch-message`, бот автоматически запускает отдельное live terminal watch сообщение для публичных сессий `/solve`: - **Manual Watch**: `/terminal_watch ` или ответ командой `/terminal_watch` - **Real-time Updates**: смотрите live session log output во время выполнения команд - **Auto-freeze**: сообщение замораживается после завершения команды - **Log Attachment**: полные логи автоматически прикрепляются после завершения сессии - **Security**: auto-start отключён для приватных репозиториев и репозиториев с неизвестной видимостью - **Smart Updates**: обновляет сообщение только при реальных изменениях (rate-limited для защиты от API limits) ### Замечания по безопасности - Работает только в групповых чатах, где бот является администратором - Опциональное ограничение по ID чата через `TELEGRAM_ALLOWED_CHATS` - Приватная `/auth` отключена, если `TELEGRAM_ALLOWED_CHATS` не задан, и доступна только владельцам перечисленных чатов - Команды выполняются от имени системного пользователя, запустившего бота - Убедитесь в наличии надлежащей аутентификации (`gh auth login`, `claude-profiles`) ## 🏆 Лучшие практики Hive Mind работает ещё лучше, когда в репозиториях есть надёжные CI/CD-пайплайны и чётко сформулированные требования к задачам. Смотрите: - [BEST-PRACTICES.ru.md](./docs/BEST-PRACTICES.ru.md) — универсальные промпты, рекомендации по написанию задач, улучшение архитектуры и паттерны субагентов - [CI-CD-BEST-PRACTICES.ru.md](./docs/CI-CD-BEST-PRACTICES.ru.md) — настройка CI/CD-пайплайнов, рекомендуемые шаблоны и стратегии применения Ключевые преимущества правильного CI/CD: - Решатели ИИ итерируют до тех пор, пока все проверки не пройдут - Стабильное качество вне зависимости от состава команды (люди и/или ИИ) - Ограничения на размер файлов обеспечивают читаемость кода как для ИИ, так и для людей Готовые к использованию шаблоны доступны для JavaScript, Rust, Python, Go, C# и Java. ## 🏗️ Архитектура Hive Mind работает на трёх уровнях: 1. **Уровень оркестрации** (`hive.mjs`) — координирует несколько агентов ИИ 2. **Уровень выполнения** (`solve.mjs`, `review.mjs`) — выполняет конкретные задачи 3. **Уровень взаимодействия с людьми** — обеспечивает сотрудничество между людьми и ИИ ### Потоки данных #### Режим 1: Задача → Pull Request ```mermaid sequenceDiagram participant H as Человек participant GH as GitHub participant AI as Агент ИИ participant HM as Hive Mind H->>GH: Создаёт задачу Note over H,GH: Основной ввод от человека GH->>HM: Задача доступна HM->>AI: Назначает задачу AI->>GH: Анализирует задачу AI->>AI: Разрабатывает решение AI->>GH: Создаёт черновой PR Note over H,GH: Точка принятия решения человеком GH->>H: Уведомляет о создании PR H->>GH: Проверяет PR alt Одобрить и влить H->>GH: Вливает PR GH->>HM: PR влит else Запросить изменения H->>GH: Добавляет комментарии Note over H,GH: Дополнительный ввод от человека GH->>HM: Комментарии добавлены HM->>AI: Обрабатывает обратную связь AI->>GH: Обновляет PR else Закрыть PR H->>GH: Закрывает PR GH->>HM: PR закрыт end ``` #### Режим 2: Pull Request → Комментарии ```mermaid sequenceDiagram participant H as Человек participant GH as GitHub participant AI as Агент ИИ participant HM as Hive Mind Note over GH: Существующий PR H->>GH: Добавляет комментарий Note over H,GH: Основной ввод от человека GH->>HM: Новый комментарий доступен HM->>AI: Обрабатывает комментарий AI->>GH: Анализирует обратную связь AI->>AI: Обновляет решение AI->>GH: Отправляет изменения Note over H,GH: Точка принятия решения человеком GH->>H: Уведомляет об изменениях H->>GH: Проверяет обновления alt Одобрить и влить H->>GH: Вливает PR GH->>HM: PR влит else Нужно больше изменений H->>GH: Добавляет ещё комментарии Note over H,GH: Продолжение ввода от человека GH->>HM: Комментарии добавлены else Закрыть PR H->>GH: Закрывает PR GH->>HM: PR закрыт end ``` 📖 **Исчерпывающую документацию по потокам данных, включая точки интеграции обратной связи от людей, см. в [docs/flow.ru.md](./docs/flow.ru.md)** ## 📊 Примеры использования ### Автоматическое решение задач ```bash # Solve issue (automatically forks if no write access) solve https://github.com/owner/repo/issues/123 --model opus # Manual fork and solve issue (works for both public and private repos) solve https://github.com/owner/repo/issues/123 --fork --model opus # Continue work on existing PR solve https://github.com/owner/repo/pull/456 --verbose # Solve with detailed logging and solution attachment solve https://github.com/owner/repo/issues/123 --verbose --attach-logs # Dry run to see what would happen solve https://github.com/owner/repo/issues/123 --dry-run ``` ### Оркестрация нескольких репозиториев ```bash # Monitor single repository with specific label hive https://github.com/owner/repo --monitor-tag "bug" --concurrency 4 # Monitor all issues in an organization hive https://github.com/microsoft --all-issues --max-issues 20 --once # Monitor user repositories with high concurrency hive https://github.com/username --all-issues --concurrency 8 --interval 120 # Skip issues that already have PRs hive https://github.com/org/repo --skip-issues-with-prs --verbose # Auto-cleanup temporary files hive https://github.com/org/repo --auto-cleanup --concurrency 5 ``` ### Управление сессиями ```bash # Resume when Claude hits limit solve https://github.com/owner/repo/issues/123 --resume 657e6db1-6eb3-4a8d # Continue session interactively in Claude Code (cd /tmp/gh-issue-solver-123456789 && claude --resume session-id) ``` ### Очистка диска `hive-cleanup` освобождает место на диске, удаляя устаревшие временные каталоги/файлы hive-mind (клоны для каждой задачи вида `/tmp/gh-issue-solver-*`, файлы конфигурации MCP, каталоги загрузки логов и т. д.), при этом **сохраняя папки, относящиеся к выполняющимся в данный момент задачам**, защищённые системные пути и любой клон с незакоммиченными или неотправленными изменениями. Он обнаруживает активные задачи по запущенным процессам и активным сессиям изоляции и сопоставляет клоны с задачами по имени ветки, используя ту же логику, что и `solve` (issue → `issue-{n}-{hex}`; PR → его разрешённая head-ветка). ```bash # Предпросмотр: список сохраняемых и удаляемых папок (ничего не удаляет) hive-cleanup --dry-run # Реально удалить устаревшие временные файлы (сначала запросит подтверждение) hive-cleanup # Удалить без запроса подтверждения hive-cleanup --force # Учитывать также не-hive-mind временные записи (более агрессивно) hive-cleanup --all --dry-run # Разрешить удаление /tmp/start-command (по умолчанию сохраняется; хранит логи изоляции) hive-cleanup --force-start-command # Очистка Ubuntu / системы (кэши apt, логи journald, кэш npm) hive-cleanup --system --sudo # Сопоставить живые/зависшие agent PID с задачами hive/start-command hive-cleanup --processes # Отследить конкретный не-agent PID, например дочерний процесс браузера или shell hive-cleanup --pid 94445 # Предпросмотр orphaned agents, которые можно остановить hive-cleanup --kill-orphaned-agents --dry-run # Остановить деревья orphaned agent процессов после просмотра предпросмотра hive-cleanup --kill-orphaned-agents --force # Отключить обнаружение активных задач (сохраняются только защищённые пути) hive-cleanup --no-keep-active-tasks-folders --dry-run ``` Запустите `hive-cleanup --help`, чтобы увидеть полный список опций. Команда удобна для режима dry-run и записывает лог `cleanup-*.log` с меткой времени при каждом запуске. Диагностический вывод процессов скрывает распространённые формы token перед печатью командных строк. ## 🔍 Мониторинг и логирование Найдите команды возобновления в логах: ```bash grep -E '\(cd /tmp/gh-issue-solver-[0-9]+ && claude --resume [0-9a-f-]{36}\)' hive-*.log ``` ## 🔧 Конфигурация **Аутентификация:** - `gh auth login` — аутентификация через GitHub CLI - `claude-profiles` — миграция профиля аутентификации Claude на сервер **Интеграция с OpenRouter:** Используйте OpenRouter для доступа к 500+ моделям ИИ от 60+ провайдеров с одним API-ключом. См. [docs/OPENROUTER.ru.md](./docs/OPENROUTER.ru.md) для инструкций по настройке как для Claude Code CLI, так и для @link-assistant/agent. **Переменные окружения и дополнительные параметры:** Для исчерпывающей конфигурации, включая переменные окружения, тайм-ауты, лимиты повторных попыток, настройки Telegram-бота, интеграцию с YouTrack и все параметры CLI, см. [docs/CONFIGURATION.ru.md](./docs/CONFIGURATION.ru.md). ## 🐛 Сообщение об ошибках ### Ошибки Hive Mind Если вы столкнулись с проблемами в **Hive Mind** (этом проекте), пожалуйста, сообщите о них на странице GitHub Issues: - **Репозиторий**: https://github.com/link-assistant/hive-mind - **Задачи**: https://github.com/link-assistant/hive-mind/issues ### Ошибки Claude Code CLI Если вы столкнулись с проблемами в самом **Claude Code CLI** (например, ошибки команды `claude`, проблемы установки или ошибки CLI), пожалуйста, сообщите о них в официальный репозиторий Claude Code: - **Репозиторий**: https://github.com/anthropics/claude-code - **Задачи**: https://github.com/anthropics/claude-code/issues ## 🛡️ Контроль размера файлов Все файлы документации автоматически проверяются: ```bash find docs/ -name "*.md" -exec wc -l {} + | awk '$1 > 1000 {print "ERROR: " $2 " has " $1 " lines (max 1000)"}' ``` ## Диагностика сервера Чтобы связать загруженный `claude`, `codex`, `gemini`, `qwen` или `opencode` PID с запустившей его задачей hive, сначала используйте встроенную диагностику процессов: ```bash # Показать agent PID, start-command session ID, GitHub task URL, workspace, # причины совпадения и возможные orphaned agents. hive-cleanup --processes # Включить произвольный PID в тот же отчёт. hive-cleanup --pid 62220 # Остановить только orphaned agents, чья задача уже завершена. hive-cleanup --kill-orphaned-agents --dry-run hive-cleanup --kill-orphaned-agents --force ``` Ручной fallback: определите screen-сессии, являющиеся родительскими для процессов, потребляющих ресурсы. ```bash TARGETS="62220 65988 63094 66606 1028071 4127023" # build screen PID -> session name map declare -A NAME while read -r id; do spid=${id%%.*}; NAME[$spid]="$id"; done \ < <(screen -ls | awk '/(Detached|Attached)/{print $1}') # check each PID's environment for STY and map back to session for p in $TARGETS; do sty=$(tr '\0' '\n' < /proc/$p/environ 2>/dev/null | awk -F= '$1=="STY"{print $2}') if [ -n "$sty" ]; then spid=${sty%%.*} echo "$p -> ${NAME[$spid]:-$sty}" else echo "$p -> (no STY; not from screen or env cleared / double-forked)" fi done ``` Показать подробную информацию о процессе ```bash procinfo() { local pid=$1 if [ -z "$pid" ]; then echo "Usage: procinfo " return 1 fi if [ ! -d "/proc/$pid" ]; then echo "Process $pid not found." return 1 fi echo "=== Process $pid ===" # Basic process info ps -p "$pid" -o user=,uid=,pid=,ppid=,c=,stime=,etime=,tty=,time=,cmd= echo # Working directory echo "CWD: $(readlink -f /proc/$pid/cwd 2>/dev/null)" # Executable path echo "EXE: $(readlink -f /proc/$pid/exe 2>/dev/null)" # Root directory of the process echo "ROOT: $(readlink -f /proc/$pid/root 2>/dev/null)" # Command line (full, raw) echo "CMDLINE:" tr '\0' ' ' < /proc/$pid/cmdline 2>/dev/null echo # Environment variables echo echo "ENVIRONMENT (key=value):" tr '\0' '\n' < /proc/$pid/environ 2>/dev/null | head -n 20 # Open files (first few) echo echo "OPEN FILES:" ls -l /proc/$pid/fd 2>/dev/null | head -n 10 # Child processes echo echo "CHILDREN:" ps --ppid "$pid" -o pid=,cmd= 2>/dev/null } procinfo 62220 ``` ## Обслуживание ### Войти в последнюю screen-сессию ```bash s=$(screen -ls | awk '/Detached/ {print $1; exit}'); echo "Entering $s"; screen -r "$s"; echo "Left $s"; ``` ### Войти в старейшую screen-сессию ```bash s=$(screen -ls | awk '/Detached/ {last=$1} END{print last}'); echo "Entering $s"; screen -r "$s"; echo "Left $s"; ``` ### Перезагрузить сервер. ```bash sudo reboot ``` Это удалит все зависшие неиспользуемые процессы и screen-сессии, что освободит ОЗУ и снизит нагрузку на CPU. Перезагрузка также может очистить все временные файлы, поэтому следующий шаг может не дать результата, если перезагрузка уже была выполнена. ### Очистить дисковое пространство. ```bash df -h rm -rf /tmp df -h ``` Эти команды следует выполнять от имени пользователя `hive`. Если вы случайно удалили папку `/tmp` под пользователем `root`, восстановите её следующим образом: ```bash sudo mkdir -p /tmp sudo chown root:root /tmp sudo chmod 1777 /tmp ``` ### Закрыть все screen-сессии для освобождения ОЗУ ```bash # close all (Attached or Detached) sessions screen -ls | awk '/(Detached|Attached)/{print $1}' \ | while read s; do screen -S "$s" -X quit; done # remove any zombie sockets screen -wipe # verify screen -ls ``` ### Top с полными аргументами каждой команды ```bash top -c ``` ### Показать полное дерево процессов ```bash ps -eo pid,ppid,user,args --forest ``` или ```bash ps axjf ``` ### Завершить все команды, порождённые конкретной задачей ```bash pkill -f gh-issue-solver-1773073065743 ``` ### Завершить все headless-браузеры, порождённые ms-playwright ```bash pkill -f ms-playwright/chromium_headless_shell-1200 ``` Это можно сделать, но не рекомендуется, так как перезагрузка даёт лучший эффект. ## 📄 Лицензия Лицензия Unlicense — см. [LICENSE](./LICENSE) ## 🤖 Участие в разработке Этот проект использует разработку на основе ИИ. См. [CONTRIBUTING.ru.md](./docs/CONTRIBUTING.ru.md) для руководства по сотрудничеству людей и ИИ.