긴 Claude 세션은 아무것도 하지 않으면서 채팅창에서는 바빠 보일 수도 있고, 서브에이전트(subagent)가 15분 동안 빌드를 수행하는 동안에는 조용해 보일 수도 있습니다. 그리고 세션에 어떻게 진행되고 있는지 물어볼 수도 없습니다. 세션은 스스로에 대해 잘못된 정보를 줄 수 있고, 멈춰버린 세션은 아예 대답을 할 수 없기 때문입니다. 그래서 이 도구는 절대 물어보지 않습니다. 약 250줄의 Python 스크립트가 60초마다 외부에서 관찰합니다. 작동 중인 세션은 지속적으로 파일을 작성하지만, 멈춘 세션은 그렇지 않습니다. 최신 파일의 수정 시간(mtime)이 진실입니다. 모든 단계는 디스크의 트랜스크립트(transcript)에 기록됩니다. 해당 트랜스크립트의 끝부분(tail)을 통해 각 에이전트와 각 서브에이전트가 현재 무엇을 하고 있는지, 누구인지(자신의 지침에서 파싱된 "Sonnet BUILDER", "Opus SPEC" 등), 얼마나 오래 실행되었는지, 그리고 얼마나 많은 토큰을 사용했는지를 알 수 있습니다.

제공되는 기능:
메뉴 바 (SwiftBar): 초록색 + 숫자 = 활발히 작동 중인 세션. 빨간색 = 워처(watcher) 자체가 종료됨(그 자체로 알림 기능). 드롭다운 메뉴는 모든 세션, 서브에이전트 및 활동 스파크라인(sparkline)을 보여줍니다. 대시보드: 필터 칩(작동 중 / 조용함 / 유휴 상태 / CLI), 실시간 검색, 서브에이전트별 역할 칩 + 실행 시간 + 토큰 사용량, 세션별 시간당 스파크라인, 완료된 에이전트는 접기 기능. Claude Code CLI 실행 및 서브에이전트 팬아웃(fan-outs)을 포함한 Cowork(데스크톱 에이전트) 세션을 지원합니다. 실행 시 토큰 소모 제로 — AI는 관찰 대상이지, 관찰을 수행하는 주체가 아닙니다. 기존에 훌륭한 후크 기반 모니터들(Claude-Code-Agent-Monitor, agents-observe)이 있습니다. 차이점은 다음과 같습니다: 후크는 각 세션에 계측(instrumenting)이 필요하며 설정하지 않은 세션은 볼 수 없습니다. 반면 이 도구는 이미 디스크에 있는 내용을 읽습니다. README에는 실제 디버깅 과정을 소모하게 만든 다섯 가지 함정을 문서화해 두었습니다 (제가 가장 좋아하는 것은 ISO 타임스탬프를 고정 너비 슬라이스(fixed-width-slice)로 처리하지 마라는 것입니다. 소수점 초 단위 때문에 fromisoformat이 조용히 실패하며, 그 증상은 그럴듯해 보이는 '모두 0인 스파크라인'으로 나타납니다). 또한 리포지토리에는 클론(clone)하는 대신 프롬프팅을 선호하는 분들을 위해, Claude 세션에서 이 모든 것을 처음부터 구축할 수 있는 네 개의 마스터 프롬프트가 포함되어 있습니다.

Repo: https://github.com/jeremyinthebay/claude-watcher (MIT) 수정 사항: 미리 문의하신 몇몇 분들을 위해 — 이제 한 번의 붙여넣기로 가능한 버전이 추가되었습니다: 전체 빌드 과정을 세 개의 검증 게이트(verification-gated) 단계로 실행하는 단일 오케스트레이터 프롬프트(orchestrator prompt, prompts/master-build-all.md)입니다. 각 단계는 다음 단계가 시작되기 전, 붙여넣은 증거를 통해 자체 체크를 통과해야 합니다. 두 번의 실패가 발생하면 빌드가 중단됩니다. 수정 사항 2 (이미 보고된 현장 보고): 빌드 프롬프트는 사용자의 실제 Mac에서 실행되는 셸(shell)이 필요합니다. Claude Code (터미널)는 네이티브로 작동합니다. Cowork의 기본 샌드박스(sandbox)는 ~/Library를 볼 수 없거나 launchctl을 실행할 수 없는 Linux VM입니다 — 이제 프롬프트가 이를 먼저 확인하며(Phase 0), 검증 불가능한 것을 빌드하는 대신 사용자에게 옵션을 안내합니다. 또는 프롬프트를 완전히 건너뛸 수도 있습니다: 터미널에서 clone + ./install.sh를 실행하세요. submitted by /u/HighAltitudeHorology [link] [comments]