goose-herdr

Una integración de goose para Herdr — el gestor de espacios de trabajo en terminal para agentes de codificación de IA.

El repositorio incluye dos piezas complementarias:

Ambas direcciones son "goose → Herdr". Herdr en sí no necesita cambios de código: detecta agentes por el proceso en primer plano y expone un socket local + CLI.

Requisitos previos

• goose instalado.

• Herdr instalado y en tu PATH (o con HERDR_BIN_PATH configurado), con un servidor de Herdr en ejecución.

La extensión MCP funciona desde cualquier shell que pueda alcanzar el servidor de Herdr. El hook de reporte de estado solo se activa cuando goose se ejecuta dentro de un panel gestionado por Herdr (HERDR_ENV=1).

Related MCP server: Terminal MCP Server

Instalar la extensión MCP

Las extensiones de goose son servidores MCP. El paquete expone un script de consola herdr-mcp.

Opción A — archivo de configuración (persistente)

Añade una entrada bajo extensions en ~/.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

Una vez que el paquete esté publicado en PyPI, puedes usar la forma más corta:

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

Opción B — CLI interactiva

goose configure

Elige Añadir extensión → Extensión de línea de comandos, luego introduce:

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

Opción C — sesión única (no instalada)

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

Opción D — instalación local para desarrollo

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

Luego registra la extensión con cmd: herdr-mcp (y args vacío):

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

Instalar el hook de reporte de estado

Copia el directorio agent-state/ en una ubicación de complementos de goose, por ejemplo:

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

Esto reporta working en SessionStart/PreToolUse, idle en Stop, y libera el agente en SessionEnd. No hace nada a menos que HERDR_ENV=1 y HERDR_PANE_ID estén configurados (es decir, goose se ejecuta en un panel de Herdr).

Herramientas

La extensión registra herramientas herdr_*. Las de solo lectura son seguras de llamar en cualquier momento; el resto realizan una acción de Herdr cada una.

Estados de agente usados por Herdr: idle, working, blocked, done, unknown.

Desarrollo

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

El paquete utiliza el SDK oficial mcp de Python (>= 2.0) y envuelve la CLI de herdr en lugar de hablar directamente con el protocolo de socket sin formato.