Herdr: мультиплексор AI-агентов в терминале

На Windows (предварительная бета-версия):

Или установить через Homebrew:

Или через mise:

Если mise сообщает herdr not found in mise tool registry, обновите mise и повторите попытку. Старые версии mise появились раньше, чем herdr был добавлен в реестр; mise use -g github:ogulcancelik/herdr работает как временный обходной путь.

Или скачайте стабильный бинарный файл для Linux/macOS со страницы releases. Нативные бинарные файлы для Windows существуют только в виде предварительных бета-сборок.

Запустите Herdr в директории, где находится ваш проект:

Herdr запускает или подключается к фоновому серверу сессии. Если в сессии нет рабочих пространств, Herdr автоматически создаёт одно. Запустите агента в корневой панели. Нажмите ctrl+b, затем shift+n, чтобы создать новое рабочее пространство; ctrl+b, затем v или minus — чтобы разделить панели; ctrl+b, затем c — чтобы создать вкладку; ctrl+b, затем w — чтобы переключиться между рабочими пространствами.

Нажмите ctrl+b q, чтобы отключить клиент. Сервер и процессы панелей продолжат работать. Откройте другой терминал и снова запустите herdr, чтобы переподключиться.

Сервер и клиент. По умолчанию herdr подключается к фоновому серверу. Отключение закрывает только клиент. herdr server stop останавливает сервер по умолчанию и завершает его панели. Именованные сессии — это отдельные пространства имён сервера: используйте herdr session attach work, herdr session stop work и herdr session list, когда нужно полностью изолированное состояние выполнения.

Рабочие пространства, вкладки, панели. Рабочее пространство (workspace) — контейнер уровня проекта. Вкладки группируют панели внутри рабочего пространства. Панели — это реальные процессы терминала, а не переработанные представления агентов.

Копирование. Herdr копирует текст панели, а не боковую панель. Выделите текст перетаскиванием внутри панели, дважды щёлкните по слову или токену, или нажмите prefix+[ для режима копирования с клавиатуры. В режиме копирования перемещайтесь клавишами h/j/k/l, w/b/e и {/}, начинайте выделение клавишей v или Пробел, копируйте клавишей y или Enter, выходите — q или Esc. В PuTTY и некоторых SSH-терминалах удерживайте Shift при перетаскивании, чтобы использовать собственное выделение терминала, и Shift + правый клик для вставки.

Обновление и восстановление. herdr update устанавливает новый бинарный файл, но работающий сервер продолжает использовать старый процесс, пока его не остановят или не передадут управление. Чтобы использовать новую версию, остановите старый сервер: при этом процессы панелей завершатся. Выполните herdr server stop, затем снова запустите herdr для сессии по умолчанию. Для именованной сессии: herdr session stop <name>, затем снова herdr session attach <name>. Команда herdr update --handoff — экспериментальная; она пытается перенести живые панели, включая активные процессы вроде dev-серверов, со старого сервера на новый. При установленных официальных интеграциях поддерживаемые панели агентов могут перезапуститься из своих нативных сессий после перезапуска или обновления сервера.

Привязки клавиш. Herdr использует явные строки привязок клавиш. prefix+n означает: нажать настроенный префикс, затем n. ctrl+alt+n, cmd+k, alt+1 и аккорды с функциональными клавишами — прямые ярлыки терминального режима, для которых префикс не нужен. Обычные печатаемые клавиши без модификаторов (например, n) перехватывают обычный ввод, поэтому используйте prefix+n, если только вы намеренно не хотите создать прямую привязку с модификатором.

Осведомлённость об агентах. Боковая панель показывает состояния: заблокирован, работает, завершён, простаивает. По умолчанию определение состояния работает через имена процессов и вывод терминала. Официальные интеграции могут добавить нативное определение идентичности сессии для восстановления, семантические отчёты о состоянии или и то, и другое.

Herdr уведомляет вас о выходе новой версии. Для ручного обновления:

herdr update предназначен для установок, управляемых собственным инсталлятором Herdr. Установки через Homebrew, mise и Nix обновляются через brew upgrade herdr, mise upgrade herdr или ваш рабочий процесс Nix, после чего применяется та же схема: остановить сервер и запустить снова, если он всё ещё работает на старой версии. Для прямых установок на Linux и macOS можно переключиться на канал разработки (preview) командой herdr channel set preview, а вернуться на стабильный — herdr channel set stable. Бета-установки на Windows пока доступны только в канале preview. Подробнее о матрице обновления, перезапуска, восстановления и передачи управления — в документации install docs и session state docs.

Прямые установки на Linux и macOS по умолчанию используют стабильный канал обновлений. Бета-установки на Windows по умолчанию используют preview. Чтобы тестировать preview-сборки из ветки master до следующего стабильного релиза:

Чтобы вернуть прямые установки на Linux и macOS к стабильному каналу:

При прямых установках смена канала также проверяет этот канал и устанавливает последний бинарный файл. Если обновление завершилось ошибкой, выполните herdr update для повторной попытки из настроенного канала.

Preview доступен только для прямых установок, управляемых обновлятором Herdr. Homebrew, mise и Nix остаются на стабильном канале и обновляются через свои пакетные менеджеры.

tmux даёт постоянство сессий и панели, но создавался до эпохи агентов. GUI-менеджеры показывают состояние агентов, но вынуждают покидать терминал и работать через их обёртку. Herdr объединяет постоянство и осведомлённость в одном инструменте, который не мешает вашей работе.

Herdr работает через обычный SSH. Запустите его на удалённом хосте, отключитесь и переподключитесь позже:

Можно также подключиться с локального терминала, не открывая оболочку:

Удалённое подключение по умолчанию добавляет резервные SSH-keepalive, сохраняя при этом ваш собственный SSH-конфиг. Установите [remote].manage_ssh_config = false, чтобы использовать обычный ssh.

Прямое подключение соединяет ваш текущий терминал с одним терминалом, управляемым сервером:

Подробности об удалённых привязках клавиш, именованных сессиях и передаче управления — в документации persistence and remote docs.

Боковая панель показывает, какие агенты заблокированы, работают или завершили работу. Рабочие пространства отображают наиболее срочное состояние своих агентов, чтобы можно было быстро просмотреть весь список.

Состояния:

Определение состояния работает путём чтения активного процесса и вывода терминала. Никакой конфигурации, никаких хуков не требуется. Официальные интеграции для Claude Code, Codex, GitHub Copilot CLI, Devin, Droid, Kimi Code CLI, QoderCLI и Cursor Agent CLI предоставляют идентичность сессии для восстановления; pi, omp, Kimi Code CLI, opencode, Kilo Code CLI, Hermes и кастомные socket-интеграции могут сообщать собственное состояние.

Не GUI-окно, не веб-дашборд, не Electron. Herdr запускается внутри любого терминала, которым вы уже пользуетесь. Единственный бинарный файл на Rust, без зависимостей. Работает внутри tmux как внешнего терминального окружения.

Локальный Unix-сокет позволяет агентам создавать рабочие пространства, разделять или разворачивать на весь экран панели, запускать вспомогательные процессы, читать вывод и ожидать изменений состояния. Начните с документации socket API и SKILL.md.

Автоматическое определение работает «из коробки» — через сопоставление имён процессов и эвристику по выводу терминала.

Обнаруживаются, но полностью не проверены: gemini cli, cline.

Для агентов, не входящих во встроенный список, Herdr по-прежнему работает как терминальный мультиплексор с рабочими пространствами, панелями и мозаичной раскладкой. Кастомные интеграции могут передавать метки агентов через socket API. Подробнее — в документации socket API.

Нажмите ctrl+b, чтобы войти в режим префикса. Действия по умолчанию аналогичны tmux и требуют нажатия префикса первым:

Мышь поддерживается везде. В режиме изменения размера h/l регулируют ширину, j/k — высоту, esc — выход. Полный синтаксис, дополнительные действия, индексированные привязки и привязки пользовательских команд — в документации по конфигурации.

Файл конфигурации: ~/.config/herdr/config.toml

Настройки внутри приложения включают тему, звук и параметры всплывающих уведомлений. Herdr записывает логи в директорию ~/.config/herdr/; в режиме постоянных сессий наиболее полезны файлы herdr-client.log и herdr-server.log. Полные сведения о конфигурации и логировании — в документации по конфигурации.

Если вы — AI-агент, работающий с этим репозиторием, прочитайте AGENTS.md перед внесением изменений и CONTRIBUTING.md перед тем, как открывать issues или PR.

Herdr распространяется на условиях двойной лицензии:

Контакт: hey@herdr.dev