hcom: CLI для организации взаимодействия между AI-агентами

Проект **hcom** — это инструмент командной строки (CLI), который позволяет агентам взаимодействовать между собой, наблюдать и запускать друг друга в разных терминалах. С его помощью можно координировать процессы с несколькими агентами, запускать различные AI CLI как субагенты, а также избежать утомительного копирования и вставки команд.

Установка

Установить **hcom** можно несколькими способами:

• С помощью Python (для macOS, Linux и Windows):

  uv tool install hcom

• С помощью Homebrew (для macOS и Linux):

  brew install aannoo/hcom/hcom

• Альтернативные варианты установки:
  • Для macOS и Linux:

    curl -fsSL https://github.com/aannoo/hcom/releases/latest/download/hcom-installer.sh | sh

  • Для Windows:

    irm https://github.com/aannoo/hcom/releases/latest/download/hcom-installer.ps1 | iex

Для обновления уже установленной версии можно использовать команду:

hcom update

Быстрый старт

Чтобы начать использовать **hcom**, просто запусти агента в одном терминале, например:

hcom claude

И во втором терминале:

hcom codex

После этого ты можешь задавать агентам вопросы или запускать процессы:

• спрашивать о любимом торте
• проверять, что сделал Claude и отправить исправления
• запустить несколько экземпляров OpenCode и распределить задачи
• переключиться на отладку ошибки и сообщить результаты
• отправить следующую задачу, когда Codex станет бездействовать

Также можно открыть TUI (текстовый пользовательский интерфейс) с помощью команды:

hcom

Функциональность агентов

Агенты могут:

• Обмениваться сообщениями в реальном времени
• Наблюдать друг за другом: видеть статус, транскрипцию, изменения файлов и истории команд
• Подписываться на изменения статуса, уведомления о событиях и автоматически реагировать на них
• Запускать, форкать, возобновлять и завершать работу в любом терминальном эмуляторе

Система работы и безопасность

**hcom** работает на основе хуков, которые фиксируют активность и передают сообщения через локальную базу данных SQLite. Хуки активируются только при запуске агента с **hcom** спереди. Для присоединения к **hcom** без хуков можно использовать команду:

hcom start

Кроме того, **hcom** может соединять агентов на разных устройствах через MQTT-ретранслятор, что позволяет обмениваться сообщениями и командовать агентами на разных машинах.

Важно помнить, что безопасность использования **hcom** связана с обработкой токенов и PSK (предварительно совместимый ключ). Если токен окажется скомпрометированным, его следует немедленно отключить в настройках.

Ограничения

Несмотря на мощные функции, **hcom** имеет некоторые ограничения. Например, утечка PSK может обеспечить доступ к старым зашифрованным сообщениям, а безопасность системы основывается на полностью доверительных устройствах. Если одно устройство скомпрометировано, оно может управлять всеми остальными. Поэтому перед использованием **hcom** рекомендуется ознакомиться с документированными рисками и мерами предосторожности.