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 — 설정 파일 (영구적)

~/.config/goose/config.yaml의 extensions 아래에 항목을 추가하세요:

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

확장 추가 → 명령줄 확장을 선택한 후 다음을 입력하세요:

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

이 훅은 SessionStart/PreToolUse 시 working, Stop 시 idle을 보고하고, 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

이 패키지는 공식 mcp Python SDK (>= 2.0)를 사용하며, 원시 소켓 프로토콜 대신 herdr CLI를 래핑합니다.