goose-herdr

Интеграция goose для Herdr — терминального менеджера рабочих пространств для AI-агентов кодирования.

Репозиторий содержит два дополняющих друг друга компонента:

Оба направления — «goose → Herdr». Сам Herdr не требует изменений кода: он обнаруживает агентов по процессу переднего плана и предоставляет локальный сокет + CLI.

Предварительные требования

• goose установлен.

• Herdr установлен и находится в PATH (или установлена переменная HERDR_BIN_PATH), при этом сервер Herdr запущен.

Расширение MCP работает из любой оболочки, которая может подключиться к серверу Herdr. Хук для сообщения о состоянии активируется только тогда, когда goose запущен внутри панели, управляемой Herdr (HERDR_ENV=1).

Related MCP server: Terminal MCP Server

Установка MCP-расширения

Расширения goose — это MCP-серверы. Пакет предоставляет консольный скрипт herdr-mcp.

Вариант A — файл конфигурации (постоянный)

Добавьте запись в раздел extensions в файле ~/.config/goose/config.yaml:

extensions:
  herdr:
    name: Herdr
    cmd: uvx
    args: ["--from", "git+https://github.com/aquaherd/goose-herdr", "herdr-mcp"]
    enabled: true
    envs: {}
    type: stdio
    timeout: 300

После публикации пакета в PyPI можно использовать более короткую форму:

    args: ["--from", "goose-herdr", "herdr-mcp"]

Вариант B — интерактивный CLI

goose configure

Выберите Add Extension → Command-line Extension, затем введите:

uvx --from git+https://github.com/aquaherd/goose-herdr herdr-mcp

Вариант C — одноразовый сеанс (без установки)

goose session --with-extension "uvx --from git+https://github.com/aquaherd/goose-herdr herdr-mcp"

Вариант D — локальная установка для разработки

git clone https://github.com/aquaherd/goose-herdr
cd goose-herdr
uv pip install -e .          # or: pip install -e .

Затем зарегистрируйте расширение с помощью cmd: herdr-mcp (и пустым args):

extensions:
  herdr:
    name: Herdr
    cmd: herdr-mcp
    args: []
    enabled: true
    envs: {}
    type: stdio
    timeout: 300

Установка хука для сообщения о состоянии

Скопируйте каталог agent-state/ в расположение плагинов goose, например:

mkdir -p ~/.agents/plugins/goose-herdr-agent-state
cp -r agent-state/plugin.json agent-state/hooks agent-state/scripts \
  ~/.agents/plugins/goose-herdr-agent-state/
chmod +x ~/.agents/plugins/goose-herdr-agent-state/scripts/report-state.sh

Этот хук сообщает working при SessionStart/PreToolUse, idle при Stop и освобождает агента при SessionEnd. Он ничего не делает, если не установлены HERDR_ENV=1 и HERDR_PANE_ID (т.е. goose запущен в панели Herdr).

Инструменты

Расширение регистрирует инструменты herdr_*. Инструменты только для чтения безопасно вызывать в любое время; остальные выполняют одно действие Herdr каждое.

Состояния агентов, используемые Herdr: idle, working, blocked, done, unknown.

Разработка

uv venv .venv
uv pip install --python .venv/bin/python -e .
.venv/bin/herdr-mcp      # starts the MCP server over stdio

Пакет использует официальный Python SDK mcp (>= 2.0) и оборачивает CLI herdr, а не использует прямой протокол сокетов.