레시피

에이전트가 대기하거나 완료했을 때 Kilobat에 알리기

훅이 없으면 Kilobat은 트래픽과 CPU 사용량으로만 에이전트를 확인합니다. 훅은 프로젝트와 실행이 입력을 기다리는 시점 또는 완료된 시점을 알려줍니다.

앱과 CLI에서 무료확인일: 2026년 10월 29일

앱에서

  1. 설정을 열고 잠자기 방지 및 에이전트를 찾으세요.

  2. AI 에이전트가 작업하는 동안 Mac 잠자기 방지를 켜세요.

  3. 팝오버의 세션 표시줄을 확인하세요. 각 에이전트 실행이 상태와 함께 칩으로 표시됩니다.

CLI로 사용

  1. Claude Code의 경우 ~/.claude/settings.json에서 SessionStart, UserPromptSubmit, Notification, Stop, StopFailure, SessionEnd 아래에 명령 훅을 추가합니다.

    kilobat agent-event --agent claude --stdin-json

  2. Codex에서는 ~/.codex/config.toml에 이 줄을 추가하세요. 완료 상태만 보고합니다.

    notify = ["kilobat", "agent-event", "done", "--agent", "codex", "--json-arg"]

  3. Cline에는 Kilobat 플러그인을 설치하세요.

    cline plugin install https://kilobat.app/agents/cline/kilobat.ts

  4. 훅을 수동으로 테스트합니다. --verbose이 발생한 일을 알려줍니다.

    kilobat agent-event start --agent claude --verbose

  5. 기록된 실행을 확인합니다.

    kilobat sessions --days 1

MCP로 사용

claude mcp add kilobat -- kilobat mcp로 MCP 서버를 한 번 연결하세요. 다른 클라이언트는 문서를 참고하세요. 그러면 에이전트가 이 도구를 호출할 수 있습니다. 설정을 변경하는 도구는 에이전트에게 먼저 확인하도록 안내합니다.

도구 및 인수기능
list_sessions
{"days": 1}
project, state(working, waitingForYou, done, stalled, networkFailed 또는 failed) 및 사용된 데이터가 포함된 실행입니다.

알아두면 좋은 정보

  • kilobat agent-event은 아무것도 출력하지 않고 항상 0으로 종료하므로 에이전트의 동작을 방해하지 않습니다.
  • 앱이 실행 중이 아니면 이벤트가 작은 파일에 대기하며, 앱이 열릴 때 이를 읽습니다.
  • Kilobat은 세션 ID, 폴더 및 짧은 상태 텍스트를 읽습니다. 프롬프트나 답변은 읽지 않습니다.
  • 이 훅을 기존 훅과 합칩니다.

출처

2026년 10월 29일 확인했습니다.