realfishsam/agent-notch

해결하는 문제

Agent Notch는 macOS에서 AI 에이전트(특히 Claude Code 및 Codex)의 시각적 상태 표시기를 제공하여, 터미널 창을 열어두지 않아도 현재 에이전트가 작업 중인지, 대기 중인지, 작업을 완료했는지 한눈에 확인할 수 있도록 합니다.

작동 방식

이 도구는 3초마다 시스템을 훑어보는 '제로 설정' 방식으로 에이전트 활동을 감지합니다. TTY에 연결된 claude 또는 codex 프로세스가 실행 중인지 식별하고, 디스크上的 해당 트랜스크립트 파일에 매핑합니다.

활동 여부는 하이브리드 체크로 판단됩니다: 프로세스가 살아있고, 트랜스크립트가 지난 30초 이내에 업데이트된 경우, 에이전트는 "작업 중"으로 표시되며, 마스코트가 MacBook의 노치 옆을 걷습니다. 프로세스가 두 번의 훑기 사이클 동안 사라지면 "완료"로 표시됩니다(녹색 블롭으로 표시). 클릭 가능한 패널은 사용자의 최신 프롬프트별로 그룹화된 세션을 보여주며, 서브에이전트는 드롭다운으로 정리됩니다.

대상 사용자

터미널에서 Claude Code 또는 Codex 같은 AI 에이전트를 실행하는 macOS 사용자로, OS 어디서든 여러 에이전트 세션과 진행 상황을 방해받지 않고 모니터링하고 싶은 사람들을 위한 도구입니다.

주요 기능

• 제로 설정 설정: API, 훅, 계정이 필요 없습니다.
• 노치 통합: 활동 중인 작업을 나타내는 마스코트가 MacBook의 노치 옆을 걷습니다.
• 세션 관리: 투명하고 클릭 가능한 패널로 활성 세션, 사용 중인 모델, 서브에이전트 계층을 표시합니다.
• 사용자 정의 마스코트: 다양한 공식 Codex Pets 스프라이트 시트를 지원합니다.
• 낮은 부하: ps와 lsof를 사용해 프로세스 생존 여부를 감지하고, 트랜스크립트 쓰기 시간을 모니터링하여 활동 상태를 판단합니다.