Mac의 노치(Notch)에서 확인하는 실시간 AI 코딩 어시스턴트 텔레메트리 (telemetry)

기능 • 설치 • 사용법 • 요구사항

AgentNotch는 Mac의 노치(Notch)에 상주하며 AI 코딩 어시스턴트의 상태를 실시간으로 보여주는 세련된 macOS 메뉴 바 앱입니다. 에디터를 떠나지 않고도 Claude Code와 OpenAI Codex가 생각하고, 파일을 읽고, 도구(tools)를 실행하는 과정을 지켜보세요.

파일 읽기, 코드 수정, 셸 명령(shell commands) 등 모든 도구 호출(tool call)이 발생하는 즉시 확인하세요. AI 어시스턴트가 매 순간 정확히 무엇을 하고 있는지 알 수 있습니다.

토큰 사용량(입력/출력)과 예상 비용을 실시간으로 추적하세요. 더 이상 API 비용 청구서에 놀라는 일은 없을 것입니다.

주황색 표시: Claude Code
파란색 표시: Codex
하늘색 표시: 알 수 없는 소스

시각적 구분을 통해 어떤 AI가 활성화되어 있는지 한눈에 알 수 있습니다.

AI 어시스턴트가 작업을 완료하면 알림을 받으세요. 더 이상 "아직 생각 중인가?"라고 궁금해할 필요가 없습니다.

• Mac의 노치(Notch)에 상주 — 화면 공간을 전혀 차지하지 않음

• 네이티브 macOS 앱 — 빠르고 효율적이며 배터리 소모가 적음

• 마우스를 올리면(hover) 상세 정보가 확장됨

• 토큰 수 표시/숨기기

• 예상 비용 표시/숨기기

• 소스별 필터링 (Claude/Codex)

• 메뉴 바 아이콘 토글

brew tap AppGram/tap
brew install --cask agentnotch

• 다운로드
  AgentNotch-1.0.0.zip

Releases에서 다운로드하여 압축을 풀고
AgentNotch.app을
/Applications로 드래그하세요.

• AgentNotch 실행

텔레메트리(telemetry)를 전송하려면 Claude Code 설정에 다음을 추가하세요:

# OTEL 엔드포인트를 AgentNotch로 설정 (기본 포트 4318)
export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318"

AgentNotch는 기본적으로 4318 포트에서 OTLP/HTTP를 수신하며, 현재 OTLP 로그 (/v1/logs) 및 메트릭 (metrics) (/v1/metrics)를 디코딩합니다.

Codex CLI (v0.79+)는 [telemetry] 섹션이 아닌 [otel] 섹션이 포함된 ~/.codex/config.toml을 사용합니다. 다음을 추가하세요:

[analytics]
enabled = true
[otel]
...

Launch (실행)— Notch(노치) 영역(또는 노치가 없는 Mac의 경우 메뉴 바)에 AgentNotch가 나타납니다
Hover (호버)— 마우스를 올리면 상세 정보와 함께 최근 도구 호출 (tool calls) 내역이 확장되어 보입니다
Click (클릭)— 토큰 분석 (token breakdown) 및 설정이 포함된 전체 보기 화면을 엽니다
Settings (설정)— 톱니바퀴 아이콘을 통해 디스플레이 옵션을 구성합니다

• macOS 14.0 (Sonoma) 이상
• 노치가 있는 Mac (MacBook Pro 14"/16" 2021년형 이후 모델) 또는 모든 Mac (노치가 없는 경우 메뉴 바를 사용하도록 폴백 (fallback) 처리됨)

AgentNotch는 **100% 로컬 (locally)**에서 실행됩니다. 어떤 데이터도 외부로 전송되지 않으며, 오직 로컬 AI 도구로부터의 텔레메트리 (telemetry)만을 수신합니다.

MIT License — 자세한 내용은 LICENSE를 참조하세요.

AI 코딩 어시스턴트를 사랑하는 개발자들을 위해 ❤️로 제작되었습니다.