goose-herdr

Eine goose-Integration für Herdr — den Terminal-Arbeitsbereichs-Manager für KI-Codierungsagenten.

Das Repository enthält zwei sich ergänzende Komponenten:

Beide Richtungen sind "goose → Herdr". Herdr selbst benötigt keine Codeänderung: Es erkennt Agenten über den Vordergrundprozess und stellt einen lokalen Socket + CLI bereit.

Voraussetzungen

• goose installiert.

• Herdr installiert und im PATH (oder HERDR_BIN_PATH gesetzt), mit einem laufenden Herdr-Server.

Die MCP-Erweiterung funktioniert von jeder Shell, die den Herdr-Server erreichen kann. Der Zustandsbericht-Hook wird nur aktiviert, wenn goose selbst in einem von Herdr verwalteten Bereich läuft (HERDR_ENV=1).

Related MCP server: Terminal MCP Server

MCP-Erweiterung installieren

goose-Erweiterungen sind MCP-Server. Das Paket stellt ein herdr-mcp-Konsolenskript bereit.

Option A — Konfigurationsdatei (dauerhaft)

Fügen Sie einen Eintrag unter extensions in ~/.config/goose/config.yaml hinzu:

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

Sobald das Paket auf PyPI veröffentlicht ist, können Sie die kürzere Form verwenden:

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

Option B — Interaktive CLI

goose configure

Wählen Sie Add Extension → Command-line Extension, geben Sie dann ein:

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

Option C — Einzelsitzung (nicht installiert)

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

Option D — Lokale Entwicklungsinstallation

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

Registrieren Sie dann die Erweiterung mit cmd: herdr-mcp (und leeren args):

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

Zustandsbericht-Hook installieren

Kopieren Sie das Verzeichnis agent-state/ an einen goose-Plugin-Speicherort, zum Beispiel:

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

Dies meldet working bei SessionStart/PreToolUse, idle bei Stop und gibt den Agenten bei SessionEnd frei. Es ist wirkungslos, es sei denn, HERDR_ENV=1 und HERDR_PANE_ID sind gesetzt (d.h. goose läuft in einem Herdr-Bereich).

Werkzeuge

Die Erweiterung registriert herdr_*-Werkzeuge. Die schreibgeschützten können jederzeit aufgerufen werden; die übrigen führen jeweils eine Herdr-Aktion aus.

Von Herdr verwendete Agentenzustände: idle, working, blocked, done, unknown.

Entwicklung

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

Das Paket verwendet das offizielle mcp Python SDK (>= 2.0) und kapselt die herdr-CLI, anstatt das rohe Socket-Protokoll zu verwenden.