외부 도구 연동

Herdr는 자동으로 지원하는 에이전트를 감지합니다. Herdr가 서버를 다시 시작한 후 동일한 세션을 재개할 수 있도록 에이전트 통합을 설치하십시오. 일부 통합에서는 에이전트의 상태를 직접 보고하기도 합니다. Herdr가 지원하는 에이전트와 Herdr 자체를 지원하는 에이전트에 대해서는 에이전트을 참조하세요.

Herdr 내부에서 설정을 열고 통합 탭을 사용하여 PATH에 있는 에이전트에 대한 권장 통합을 설치하거나 수동으로 명령을 실행하십시오.

herdr integration install pi
herdr integration install omp
herdr integration install claude
herdr integration install codex
herdr integration install copilot
herdr integration install devin
herdr integration install droid
herdr integration install kimi
herdr integration install opencode
herdr integration install kilo
herdr integration install hermes
herdr integration install qodercli
herdr integration install qwen
herdr integration install letta
herdr integration install cursor
herdr integration install mastracode
herdr integration install antigravity-cli
herdr integration install grok

herdr integration uninstall pi
herdr integration uninstall omp
herdr integration uninstall claude
herdr integration uninstall codex
herdr integration uninstall copilot
herdr integration uninstall devin
herdr integration uninstall droid
herdr integration uninstall kimi
herdr integration uninstall opencode
herdr integration uninstall kilo
herdr integration uninstall hermes
herdr integration uninstall qodercli
herdr integration uninstall qwen
herdr integration uninstall letta
herdr integration uninstall cursor
herdr integration uninstall mastracode
herdr integration uninstall antigravity-cli
herdr integration uninstall grok

Herdr는 Linux/macOS 및 새 파일에 대한 통합 구성을 원자적으로 저장합니다. 기존 Windows 파일은 백업 우선 전체 업데이트를 통해 권한을 유지합니다. Windows가 백업을 보고하는 경우 재시도하기 전에 에이전트를 닫고 구성을 검사하십시오. 복원이 아니라 구성을 확인한 후에만 완료되지 않은 .herdr-backup.pending을 삭제하거나 필요한 경우 완료된 .herdr-backup 내용을 기존 파일로 복원(누락된 경우 먼저 의도한 권한 설정)한 다음 구성을 확인하고 백업을 제거하십시오.

모든 통합은 에이전트가 어떤 세션에 있는지 Herdr에게 알려주므로 Herdr는 서버를 다시 시작한 후 이를 재개할 수 있습니다. [session] resume_agents_on_restore = false로 이 기능을 끄세요.

Pi, OMP, Kimi Code CLI, OpenCode, Kilo Code CLI 및 MastraCode 통합도 에이전트 상태를 보고합니다. 보고하는 동안 Herdr는 화면을 읽는 대신 이를 사용합니다. 다른 것들은 상태를 화면 감지로 남겨둡니다.

기본 세션 복원에는 현재 Herdr 통합이 필요합니다. Pi 통합 버전 2, OMP 버전 3, Claude Code 버전 6, Codex 버전 5, GitHub Copilot CLI 버전 2, Devin CLI 버전 2, Droid 버전 2, Kimi Code CLI 버전 3, Qoder CLI 버전 2, Qwen Code 버전 1, Letta Code 버전 1, 커서 에이전트 CLI 버전 1, Grok CLI 버전 2, OpenCode 버전 5, Kilo Code CLI 버전 1, Hermes 에이전트 버전 5, MastraCode 버전 1 또는 Antigravity CLI 버전 1. herdr integration status로 설치된 버전을 확인하세요.

코딩 에이전트를 구축하는 경우 Herdr에 기본 지원을 추가하지 않고도 자신의 코드에서 Herdr에 상태를 보고하고 명령을 재개할 수 있습니다. 에이전트에 Herdr 지원 추가을 참조하세요.

Pi 통합을 설치합니다.

herdr integration install pi

Herdr는 번들 확장을 다음 위치에 작성합니다.

~/.pi/agent/extensions/herdr-agent-state.ts

PI_CODING_AGENT_DIR이 설정되면 Herdr는 대신 $PI_CODING_AGENT_DIR/extensions/herdr-agent-state.ts에 씁니다. Pi 에이전트 디렉터리가 이미 존재할 때 Herdr는 확장 디렉터리를 생성합니다. 제거하면 해당 확장 파일만 제거됩니다.

OMP 통합을 설치합니다.

herdr integration install omp

Herdr는 번들 확장을 다음 위치에 작성합니다.

~/.omp/agent/extensions/herdr-omp-agent-state.ts

Herdr는 설정 시 PI_CODING_AGENT_DIR을 전체 에이전트 디렉터리로 사용합니다. 그렇지 않으면 PI_CONFIG_DIR가 설정된 경우 $HOME/$PI_CONFIG_DIR/agent을 사용하고 ~/.omp/agent으로 돌아갑니다. Pi와 OMP가 동일한 확장 디렉터리로 확인되면 Herdr는 OMP 설치를 거부하므로 Pi가 OMP 확장을 로드할 수 없습니다. 두 통합을 모두 설치하기 전에 별도의 에이전트 디렉터리를 구성하세요. Herdr는 확인된 OMP 에이전트 디렉터리가 이미 존재할 때 확장 디렉터리를 만듭니다. 제거하면 해당 확장 파일만 제거됩니다.

OMP 통합은 Herdr의 소켓 API를 통해 omp을 에이전트 레이블, 수명 주기 상태 및 기본 세션 ID로 보고합니다. omp 실행 파일에 대한 기본 프로세스 감지가 필요하지 않으며 Herdr는 서버를 다시 시작한 후 omp --resume=<session>을 사용하여 OMP 패널을 다시 시작할 수 있습니다.

Claude Code 훅를 설치합니다.

herdr integration install claude

훅는 세션 시작 시 Claude Code 세션 ID를 로컬 Herdr 소켓에 보고합니다. Claude Code 상태는 Herdr의 화면 매니페스트 감지에서 비롯됩니다.

Claude 통합 v10은 문서화된 SessionStart 소스(startup, resume, clear, compact 및 fork)와만 일치합니다. 이는 관련되지 않은 Claude 호환 훅를 비활성화하지 않고 Grok의 new 및 load 이벤트가 가져온 Herdr Claude 훅를 실행하는 것을 방지합니다. 이전 와일드카드 일치자를 마이그레이션하려면 업그레이드한 후 Claude 통합을 다시 설치하세요. 새로운 Claude 소스 값에는 통합 업데이트가 필요합니다.

Herdr는 기본적으로 ~/.claude을 사용하거나 설정 시 CLAUDE_CONFIG_DIR을 사용합니다. Claude 구성 디렉터리가 이미 존재해야 합니다. Install은 hooks/herdr-agent-state.sh를 쓰고 Herdr 훅 항목으로 settings.json을 업데이트합니다. 제거는 일치하는 훅 항목을 제거하고 훅 스크립트를 삭제합니다.

Codex 훅를 설치합니다.

herdr integration install codex

Codex 훅는 다른 통합에서 사용되는 것과 동일한 로컬 소켓 API를 통해 세션 ID를 보고합니다. Codex 상태는 Herdr의 화면 매니페스트 감지에서 비롯됩니다.

Herdr는 기본적으로 ~/.codex을 사용하거나 설정 시 CODEX_HOME을 사용합니다. Codex 구성 디렉터리가 이미 존재해야 합니다. 설치는 herdr-agent-state.sh를 쓰고, hooks.json을 업데이트하고, config.toml에서 [features] hooks = true를 보장합니다. 또한 더 이상 사용되지 않는 최상위 codex_hooks 플래그가 있는 경우 제거합니다. 제거는 hooks.json에서 Herdr 항목을 제거하고 훅 스크립트를 삭제하지만 config.toml은 변경되지 않은 채로 둡니다.

GitHub Copilot CLI 훅를 설치합니다.

herdr integration install copilot

Copilot 훅는 다른 통합에서 사용되는 것과 동일한 로컬 소켓 API를 통해 세션 ID를 보고합니다. Copilot 상태는 Herdr의 화면 매니페스트 감지에서 비롯됩니다.

Herdr는 기본적으로 ~/.copilot을 사용하거나 설정 시 COPILOT_HOME을 사용합니다. Copilot 구성 디렉터리가 이미 존재해야 합니다. Install은 hooks/herdr-agent-state.sh를 쓰고 SessionStart 훅 항목으로 settings.json을 업데이트합니다. 제거하면 settings.json에서 Herdr 항목이 제거되고 훅 스크립트가 삭제됩니다.

Copilot이 세션 보유 이벤트를 내보낸 후 Herdr는 보고된 세션 ID를 사용하여 copilot --resume=<id>으로 패널을 재개할 수 있습니다.

Devin CLI 훅를 설치합니다.

herdr integration install devin

훅는 Devin 세션, 프롬프트, 도구 사용, 권한 및 중지 이벤트에서 기본 세션 ID를 보고합니다. Devin 상태는 여전히 Herdr의 화면 매니페스트 및 OSC 감지에서 비롯됩니다. 왜냐하면 Devin 훅는 모든 권한 취소 또는 사용자 중단 후에 안정적인 상태 전환을 생성하지 않기 때문입니다.

Herdr는 XDG_CONFIG_HOME이 설정된 경우 $XDG_CONFIG_HOME/devin을 사용합니다. 그렇지 않으면 Linux 및 macOS에서는 ~/.config/devin를 사용하고 Windows에서는 %APPDATA%\devin을 사용합니다. Devin 구성 디렉터리가 이미 존재해야 합니다. Install은 Unix에서는 herdr-agent-state.sh, Windows에서는 herdr-agent-state.ps1를 쓰고 Herdr 훅 항목으로 config.json을 업데이트합니다. 훅는 Devin이 실행되는 동안 세션 참조를 새로 고칩니다. 제거하면 config.json에서 Herdr 항목이 제거되고 훅 스크립트가 삭제됩니다.

Herdr는 devin --resume <id>를 사용하여 저장된 Devin 세션을 재개합니다. 기본 화면 매니페스트 감지는 훅 설치 여부에 관계없이 상태 권한으로 유지됩니다.

Kimi Code CLI 훅를 설치합니다.

herdr integration install kimi

훅는 기본 복원 및 권한 있는 idle, working 및 blocked 상태에 대해 Kimi 세션 ID 및 수명 주기 상태를 Herdr에 보고합니다. Kimi Code CLI 0.14.0 이상이 필요합니다.

Herdr는 기본적으로 ~/.kimi-code을 사용하거나 설정 시 KIMI_CODE_HOME을 사용합니다. Kimi Code 구성 디렉터리가 이미 존재해야 합니다. Install은 hooks/herdr-agent-state.sh를 쓰고 Herdr가 관리하는 [[hooks]] 항목을 config.toml에 추가합니다. 제거는 Herdr 관리 구성 블록을 제거하고 훅 스크립트를 삭제합니다.

Herdr는 kimi --session <id>를 사용하여 저장된 Kimi 세션을 재개합니다.

Droid 훅를 설치합니다.

herdr integration install droid

Droid 훅는 다른 통합에서 사용되는 것과 동일한 로컬 소켓 API를 통해 세션 ID를 보고합니다. Droid 훅가 모든 수명 주기 전환을 다루지는 않기 때문에 수명 주기 상태는 여전히 Herdr의 화면 매니페스트 감지에서 나옵니다.

Herdr는 Droid 훅에 ~/.factory을 사용합니다. Factory 구성 디렉터리가 이미 존재해야 합니다. Install은 hooks/herdr-agent-state.sh을 쓰고, settings.json를 Herdr SessionStart 훅 항목으로 업데이트하고, hooks.json에서 이전 Herdr Droid 훅 항목이 있는 경우 제거합니다. 제거는 두 설정 파일 모두에서 Herdr 항목을 제거하고 훅 스크립트를 삭제합니다.

Droid가 세션 시작 이벤트를 내보낸 후 Herdr는 보고된 세션 ID를 사용하여 droid --resume <id>으로 패널을 재개할 수 있습니다.

OpenCode 플러그인을 설치합니다.

herdr integration install opencode

통합은 OpenCode V1 1.18.29 이상 및 OpenCode V2(베타 19242로 테스트됨)를 지원합니다. OpenCode 구성 디렉터리가 이미 존재해야 합니다. Herdr는 해당 구성 디렉터리의 ~/.config/opencode/plugins/herdr-agent-state.js에 서버 진입점, herdr-tui-session.js에 공유 TUI 플러그인, herdr-opencode/tui.js에 V2 TUI 진입점을 설치합니다.

설치는 tui.jsonc에 V1 TUI 플러그인을 등록하고 cli.json에 V2 TUI 플러그인을 등록하여 다른 기본 설정과 플러그인을 유지합니다. tui.json의 기존 V1 등록도 설치된 것으로 간주되며 tui.jsonc을 생성하지 않고 재사용됩니다. 제거는 파일 및 기타 기본 설정을 유지하면서 두 TUI 설정 파일 모두에서 Herdr 등록을 제거합니다. OpenCode에 가져올 V1 TUI 기본 설정(tui.json 또는 kv.json)이 여전히 있는 경우 Herdr는 첫 번째 시작 마이그레이션이 실행될 수 있도록 등록을 연기합니다. opencode2을 한 번 시작하고 나중에 통합을 다시 설치하세요. 그렇지 않으면 Herdr는 플러그인 등록으로 cli.json을 생성합니다. 설치 후 OpenCode TUI를 다시 시작하십시오. 제거하면 관리되는 플러그인 파일과 해당 구성 항목이 제거됩니다.

V2 수명 주기 보고는 여러 패널이 하나의 OpenCode 서버를 공유하는 경우에도 이벤트를 선택한 루트 세션과 연결하는 창-로컬 TUI에서 실행됩니다. 완료 및 중단은 작업 상태를 지웁니다. 보류 중인 권한 요청, 보류 중인 양식 및 실패한 실행으로 인해 패널이 차단된 상태로 유지됩니다. V2 Mini 및 헤드리스 클라이언트는 TUI 플러그인을 실행하지 않으므로 이 수명 주기 보고를 제공하지 않습니다.

V1 TUI 보고는 패널에서 선택한 세션과 해당 하위 항목을 따릅니다. 패널은 사용 중이거나 재시도하는 동안 계속 작동하며 보류 중인 권한이나 질문이 있는 동안에는 차단됩니다. 연결하면 기존 활동이 로드됩니다. 취소된 도구 요청은 다시 연결한 후에도 다시 차단되지 않습니다. 하위 에이전트를 찾아보면 원래 세션 계열이 유지되는 반면, 하위 에이전트에 직접 연결하면 형제가 아닌 해당 하위 트리를 추적합니다.

로컬 V1 opencode run 및 opencode --mini은 레거시 서버 훅를 유지합니다. 이 변경 사항은 미니/헤드리스 클라이언트에 대한 창-로컬 수명 주기 보고를 추가하지 않습니다. 통합을 업데이트한 후 공유 OpenCode 서버와 해당 TUI를 다시 시작하여 이전 서버 보고자가 창-로컬 상태를 덮어쓸 수 없도록 하세요.

플러그인은 OpenCode가 Herdr 패널 내에서 실행되는 동안 수명 주기 상태와 세션 ID를 보고합니다. OpenCode가 세션 보유 이벤트를 내보낸 후 Herdr는 보고된 세션 ID를 사용하여 opencode --session <id>으로 패널을 재개할 수 있습니다. 플러그인이 설치되지 않은 경우에도 기본 화면 매니페스트 감지를 계속 사용할 수 있습니다.

Kilo Code CLI 플러그인을 설치합니다.

herdr integration install kilo

Herdr는 플러그인을 ~/.config/kilo/plugin/herdr-agent-state.js에 작성합니다. Kilo 구성 디렉터리가 이미 존재해야 합니다. 제거하면 해당 플러그인 파일만 제거됩니다.

플러그인은 Kilo가 Herdr 패널 내에서 실행되는 동안 수명 주기 상태와 세션 ID를 보고합니다. Kilo가 세션 보유 이벤트를 내보낸 후 Herdr는 보고된 세션 ID를 사용하여 kilo --session <id>으로 패널을 재개할 수 있습니다. 플러그인이 설치되지 않은 경우에도 기본 화면 매니페스트 감지를 계속 사용할 수 있습니다.

Hermes 에이전트 플러그인을 설치합니다:

herdr integration install hermes

Herdr는 Hermes 홈 디렉터리 아래에 plugins/herdr-agent-state/을 쓰고 config.yaml에서 herdr-agent-state을 활성화합니다. HERMES_HOME의 기본값은 Unix에서는 ~/.hermes이고 Windows에서는 %LOCALAPPDATA%\hermes입니다. Hermes 구성 디렉터리가 이미 존재해야 합니다. 설치 후 Hermes를 다시 시작하면 플러그인이 로드됩니다. 제거하면 플러그인 디렉터리가 제거되고 plugins.enabled에서 herdr-agent-state이 제거됩니다.

플러그인은 Hermes가 Herdr 패널 내에서 실행되는 동안 재개 가능한 세션 ID를 보고합니다. Herdr는 working, idle 및 blocked에 대한 화면 매니페스트 감지를 사용하고 보고된 세션 ID를 사용하여 hermes --resume <id>으로 패널을 재개할 수 있습니다.

Qoder CLI 훅를 설치합니다.

herdr integration install qodercli

훅는 기본 복원을 위해 Qoder CLI 세션 ID를 Herdr에 보고합니다. 수명주기 상태는 Qoder 훅가 모든 수명주기 전환을 다루지 않기 때문에 여전히 Herdr의 화면 매니페스트 감지에서 비롯됩니다.

Herdr는 기본적으로 ~/.qoder을 사용하거나 설정 시 QODER_CONFIG_DIR을 사용합니다. Qoder 구성 디렉터리가 이미 존재해야 합니다. Install은 hooks/herdr-agent-state.sh를 쓰고 Herdr 훅 항목으로 settings.json을 업데이트합니다. 제거는 일치하는 훅 항목을 제거하고 훅 스크립트를 삭제합니다.

Herdr는 qodercli --resume <id>를 사용하여 저장된 Qoder CLI 세션을 재개합니다.

훅가 설치되지 않은 경우에도 기본 화면 매니페스트 감지를 계속 사용할 수 있습니다.

Qwen Code 훅를 설치합니다.

herdr integration install qwen

SessionStart 훅는 기본 복원을 위한 Qwen Code의 세션 ID만 보고합니다. 수명주기 상태는 Herdr의 화면 매니페스트 감지에 유지됩니다.

Herdr는 기본적으로 ~/.qwen을 사용하거나 설정 시 QWEN_HOME을 사용합니다. Qwen 구성 디렉터리가 이미 존재해야 합니다. Install은 hooks/herdr-agent-session.sh(Windows의 경우 hooks/herdr-agent-session.ps1)를 쓰고 settings.json에 Herdr 항목을 추가합니다. 제거는 일치하는 항목과 관리되는 스크립트만 제거합니다.

Herdr는 qwen --resume <id>를 사용하여 저장된 Qwen Code 세션을 재개합니다.

Letta Code 통합 설치는 실험적이며 CLI 전용입니다. 설정 통합 화면이나 JSON 통합 API에는 나열되지 않습니다. herdr integration status은(는) letta (experimental)로 보고합니다. 에이전트 감지 및 herdr agent start --kind letta는 이 설치 제한과 별도로 지원됩니다.

Letta Code 훅를 설치합니다.

herdr integration install letta

자동 SessionStart 훅는 기본 복원을 위한 대화 ID를 보고합니다. Letta 코드 상태는 여전히 Herdr의 화면 매니페스트 감지에서 비롯됩니다.

Herdr는 ~/.letta을 사용합니다. 구성 디렉터리가 이미 존재해야 합니다. Install은 hooks/herdr-agent-session.sh(Windows의 경우 hooks/herdr-agent-session.ps1)을 쓰고 settings.json에 Herdr 항목을 추가합니다. 제거는 일치하는 항목과 관리되는 스크립트만 제거합니다.

Herdr는 letta --conversation <id>과의 명명된 대화를 재개합니다. 기본 대화를 default:<agent-id>로 녹음하고 letta --conversation default --agent <agent-id>로 다시 시작합니다.

커서 에이전트 CLI 훅를 설치합니다.

herdr integration install cursor

Cursor Agent CLI가 Herdr 패널 내에서 실행되는 동안 훅는 Cursor의 sessionStart 훅를 통해 세션 ID를 보고합니다. 커서 상태는 Herdr의 화면 매니페스트 감지에서 비롯됩니다.

Herdr는 기본적으로 ~/.cursor을 사용하거나 설정 시 CURSOR_CONFIG_DIR을 사용합니다. 커서 구성 디렉터리가 이미 존재해야 합니다. Install은 herdr-agent-state.sh(Windows의 경우 herdr-agent-state.ps1)를 쓰고 Herdr sessionStart 항목을 hooks.json에 추가합니다. 제거는 일치하는 훅 항목을 제거하고 훅 스크립트를 삭제합니다.

Cursor가 세션 시작 이벤트를 내보낸 후 Herdr는 보고된 세션 ID를 사용하여 cursor-agent --resume <id>으로 패널을 재개할 수 있습니다. Herdr가 패널을 복원할 때 cursor-agent 명령은 PATH에 있어야 합니다. Herdr는 일반 agent 명령을 실행하지 않습니다.

MastraCode 훅를 설치합니다.

herdr integration install mastracode

훅는 신뢰할 수 있는 idle, working 및 blocked 상태 및 기본 복원을 위해 MastraCode 수명 주기 상태 및 스레드 ID를 Herdr에 보고합니다. MastraCode에는 화면 매니페스트 대체가 없습니다. 상태는 훅에서 나오는 반면 MastraCode는 Herdr 패널 내에서 실행됩니다.

Herdr는 ~/.mastracode을 사용합니다. Install은 hooks/herdr-agent-state.sh(Windows의 경우 hooks/herdr-agent-state.ps1)을 쓰고 Herdr 명령 항목을 hooks.json에 추가하여 누락된 경우 디렉터리를 만듭니다. 제거는 일치하는 훅 항목을 제거하고 훅 스크립트를 삭제합니다.

Herdr는 mastracode --thread <id>를 사용하여 저장된 MastraCode 스레드를 재개합니다.

Antigravity CLI 훅를 설치합니다.

herdr integration install antigravity-cli

Herdr는 기본적으로 ~/.gemini/config/을 사용하거나 설정 시 ANTIGRAVITY_CLI_CONFIG_DIR을 사용합니다. 이는 Antigravity CLI가 전역 사용자 정의를 읽는 디렉터리이며 이미 존재해야 합니다. Install은 hooks/herdr-agent-state.sh(또는 Windows의 경우 herdr-agent-state.ps1)를 쓰고 Herdr 소유의 herdr 블록을 hooks.json에 추가합니다. 반중력 CLI 키는 훅 이름으로 hooks.json이므로 설치 시 해당 블록만 다시 작성하고 다른 명명된 훅는 그대로 둡니다. 제거하면 herdr 블록이 제거되고 훅 스크립트가 삭제됩니다.

이 세션 전용 통합은 패널의 현재 대화를 보고하지만 에이전트 상태는 보고하지 않습니다. Herdr는 Antigravity CLI가 화면에 그리는 것에서 계속 작동하고, 유휴 상태이고, 차단되었습니다.

훅는 PreInvocation에서 실행되므로 Herdr는 첫 번째 프롬프트가 전송되면 대화를 학습합니다. 그때부터 Herdr는 Herdr 서버를 다시 시작한 후 agy --conversation <id>을 사용하여 패널을 다시 시작할 수 있습니다.

Grok CLI 훅를 설치합니다.

herdr integration install grok

Grok CLI가 Herdr 패널 내에서 실행되는 동안 훅는 Grok의 SessionStart 훅를 통해 세션 ID를 보고합니다. Grok 상태는 Herdr의 화면 매니페스트 감지에서 비롯됩니다.

Herdr는 기본적으로 ~/.grok을 사용하거나 설정 시 GROK_HOME을 사용합니다. Grok 구성 디렉터리가 이미 존재해야 합니다. Grok은 해당 디렉터리의 모든 hooks/*.json 파일을 병합하므로 install은 hooks/herdr-agent-state.sh(Windows의 경우 hooks/herdr-agent-state.ps1) 옆에 Herdr SessionStart 항목이 포함된 독립형 hooks/herdr.json을 작성하고 다른 훅 파일을 편집하지 않습니다. 제거는 Herdr 소유의 두 파일을 정확하게 제거합니다.

Grok이 세션 시작 이벤트를 내보낸 후 Herdr는 보고된 세션 ID를 사용하여 grok --resume <id>으로 패널을 재개할 수 있습니다.

통합은 수명 주기 상태를 의미 상태로만 보고합니다. 예를 들어 수명 주기 보고서에 표시 필드를 추가하지 않고 에이전트를 working로 보고합니다.

herdr pane report-agent w1:p1 \
  --source custom:docs \
  --agent docs-bot \
  --state working

Herdr 관리 통합 옆에서 실행되는 사용자 훅는 report-agent 대신 메타데이터를 사용해야 합니다. 메타데이터는 통합의 idle, working, blocked 또는 세션 복원 권한을 인수하지 않고 프레젠테이션을 변경합니다. --agent 및 --applies-to-source는 프레젠테이션 필드(--title, --display-agent 및 --state-label)만 보호합니다. 토큰 패치는 항상 적용됩니다. 해당 기자는 청산 또는 TTL 새로 고침을 소유합니다. --display-agent은 표시되는 이름을 변경합니다.

herdr pane report-metadata "$HERDR_PANE_ID" \
  --source user:claude-title \
  --agent claude \
  --title "Refactor auth middleware" \
  --display-agent "Claude: auth" \
  --token summary="refactor auth" \
  --state-label working="refactoring auth" \
  --ttl-ms 3600000

토큰과 상태 레이블은 시각적으로만 제공됩니다. 대기, 알림 및 작업 공간 롤업은 여전히 ​​의미 상태를 사용합니다.

알려진 에이전트 나열:

herdr agent list

Herdr가 볼 수 있는 내용을 확인해야 할 때 패널을 읽으십시오.

herdr pane read w1:p1 --source recent --lines 50

통합 상태가 잘못된 것으로 보이면 먼저 에이전트가 Herdr 내부에서 실행 중이고 동일한 사용자 계정에 대해 관련 훅 또는 플러그인이 설치되었는지 확인하십시오.