AI 코딩 보조 도구의 사용 한도를 보여주는 macOS 노치 앱
vinzdg/codenotch
GitHubmacOS용 Codenotch는 화면 가장자리에 노치 형태로 자리 잡아, 사용자가 여러 코딩 보조 도구의 남은 사용량 한도를 실시간으로 시각화해 보여주는 유틸리티입니다.
- 클로드 코드, 코파일럿 등 다양한 AI 도구의 공식 API나 로컬 세션 정보를 읽어와 사용량과 현재 작업 상태(대기/작업 중)를 한눈에 제공합니다.
- 개발자가 여러 AI 도구를 사용할 때 남은 크레딧이나 세션 대기 상태를 놓치지 않아, 작업 흐름을 끊김 없이 관리하고 비용 효율성을 높이는 데 도움을 줍니다.
- 다만, 각 도구의 사용량 정보는 해당 서비스가 제공하는 내부 API나 로컬 데이터에 의존하므로, 원본 서비스 측 변경 시 표시 오류가 발생할 수 있습니다.
이 macOS 애플리케이션은 화면 가장자리에 작은 검은색 노치를 고정하여, 여러 코딩 보조 도구 각각의 남은 사용량 한도와 현재 상태(작동 중, 완료, 대기)를 시각적으로 보여줍니다. Claude Code, Cursor, Codex, Copilot 등 다양한 서비스에 대해 공식적인 경로를 통해 사용량을 읽어오며, 각 제공업체별로 어떤 소스(예: `/usage` 엔드포인트, 로컬 SQLite 상태)를 사용하는지 명시하고 있습니다.
Codenotch는 자체적으로 로그인 절차를 거치지 않습니다. 대신 Mac에 이미 존재하는 크리덴셜이나 세션 정보에서 사용량을 읽어옵니다. 즉, 사용자가 특정 도구에 설치 및 로그인만 해두면 해당 도구의 링이 나타나며, 이는 계정 소유권을 침해하지 않고 기존 인증 정보를 활용하는 방식입니다. 또한, Claude Code와 같이 여러 작업 환경을 분리하여 사용하는 경우, 각 환경별로 별도의 링과 한도를 표시할 수 있습니다.
단순히 사용량만 보여주는 것이 아니라, 현재 세션의 상태 변화도 알려줍니다. 세션이 바쁘게 작동 중일 때는 얇은 호가 회전하며, 작업자가 개입하여 기다려야 하는 상태가 되면 맥동하는 황갈색 링으로 표시됩니다. 또한, 가 작동을 멈추거나 사용자에게 무언가를 요청할 때 노치가 열리면서 시스템 알림음을 발생시키고 해당 세션의 애플리케이션을 전면에 가져옵니다.
용어 풀이
- 에이전트
- 목표를 받으면 스스로 계획을 세우고 도구를 써서 여러 단계의 작업을 해내는 AI.