vinzdg/codenotch

Codenotch – AI 코딩 어시스턴트 사용 제한용 작은 화면 모니터

그것이 무엇인가

• macOS(및 Rust/Tauri 포트를 통한 Windows) 유틸리티로, 화면의 임의의 가장자리에 고정된 작은 "노치"로 존재합니다. 노치의 각 링은 코딩 어시스턴트 제공자(Claude, Cursor, Codex, Ollama 등)를 나타내며, 제공자의 사용 할당량이 얼마나 소비되었는지, 할당량이 언제 재설정되는지, 어시스턴트가 현재 바쁜지, 완료되었는지, 대기 중인지 표시합니다.

왜 필요할 수 있는가

• 일일/주간 토큰 제한이 있는 여러 AI 코딩 도구를 정기적으로 사용하는 경우, Codenotch는 한눈에 볼 수 있는 보기를 제공하여 예기치 않게 할당량에 도달하는 것을 방지합니다.
• 또한 제한이 80%를 초과하거나 100%에 도달할 때 알림을 제공합니다.
• UI는 눈에 거슬리지 않습니다: 호버 시 확장되는 얇은 알약 모양이며, 항상 표시 또는 메뉴 바 모드를 선택할 수 있습니다.

주요 기능(README에 설명된 대로)

• 제공자 지원 – 클라우드(Claude, DeepSeek, Antigravity, OpenCode, GitHub Copilot 등) 및 로컬 런타임(Ollama, LM Studio, oMLX)을 포함한 수십 개 서비스에서 사용 데이터를 읽습니다. 대부분의 제공자는 각 CLI 또는 데스크톱 앱이 이미 저장한 자격 증명을 재사용합니다. 일부(DeepSeek, MiniMax, QianwenAI)는 내장 WebView를 통한 명시적 로그인이 필요합니다.
• 실시간 상태 – 세션이 바쁜 동안 링이 회전하고, 차단되면 호박색으로 펄스하며, 현재 제한 창, 재설정 시간 및 세션 상태를 표시하는 도구 설명을 보여줍니다.
• 다중 계정 처리 – 별도의 구성 디렉터리(예: ~/.claude-work)를 감지하고 각 계정에 대해 별도의 링을 만듭니다.
• 전화 동반 앱 – iOS/Android 앱이 로컬 네트워크 QR 코드 페어링을 통해 동일한 사용 백분율을 미러링할 수 있습니다.
• 사용자 지정 엔드포인트 – 임의의 OpenAI 호환, Anthropic 또는 Gemini 엔드포인트를 추가하고 사용 데이터를 수동으로 입력할 수 있습니다.
• 속도 및 사고 메트릭 – 로컬 모델(Ollama, LM Studio, oMLX)의 경우 초당 토큰 수 및 "사고" 시간 측정을 활성화할 수 있습니다. Codenotch에 프롬프트를 보낼 필요가 없습니다.
• 고도로 구성 가능한 UI – 가장자리 배치, 크기, 색상, 항상 표시 vs 호버 전용, Dock/메뉴 바 표시 여부, 메뉴 바 요약에 표시할 제공자를 선택할 수 있습니다.
• 알림 – 제공자의 사용률이 80%를 초과하거나 100%에 도달하면 macOS 알림이 한 번 발생하며, 제공자별 음소거 제어가 있습니다.
• 업데이트 – macOS용 서명 및 공증된 릴리스; Tauri 포트용 Windows 설치 프로그램(서명되지 않음); main 브랜치용 미리 보기 빌드.

설치

• macOS – 릴리스 페이지에서 최신 Codenotch.dmg를 다운로드합니다. 앱은 서명 및 공증되었습니다. 응용 프로그램으로 드래그한 후 격리 플래그를 지워야 할 수 있습니다(xattr -dr com.apple.quarantine /Applications/Codenotch.app).
• Windows – Codenotch-Setup.exe를 다운로드합니다. 설치 프로그램은 관리자 권한 없이 실행되며 필요한 경우 WebView2를 가져옵니다.
• 소스에서 – README는 Swift macOS 앱 또는 Rust/Tauri Windows 버전을 컴파일하기 위한 빌드 섹션(여기서는 재현되지 않음)을 가리킵니다.

내부 작동 방식

• 클라우드 제공자의 경우 공식 CLI 또는 데스크톱 앱이 사용하는 동일한 사용 엔드포인트를 쿼리하여 머신에 이미 존재하는 OAuth 토큰, API 키 또는 키체인 항목을 재사용합니다.
• 로컬 런타임의 경우 실행 중인 서버를 발견하고 상태 소켓 또는 로그 파일(~/.lmstudio/server-logs, ~/.omlx/logs/server.log)을 읽고 토큰 수 및 속도 메트릭을 추출합니다. 프롬프트나 응답 데이터가 Codenotch로 전송되지 않습니다.
• 전화 앱은 동일한 네트워크에서 로컬로 통신합니다. 페어링은 5분 후 만료되는 일회용 QR 코드를 사용합니다.

라이선스

• MIT(README의 배지에 표시됨).

누가 사용할 수 있는가

• 여러 AI 코딩 어시스턴트를 관리하고 할당량 제한 내에 있어야 하는 개발자.
• 어시스턴트가 사용자 입력을 기다릴 때 공유 시각적 신호를 원하는 팀.
• 각 제공자의 대시보드를 여는 대신 가볍고 항상 표시되는 상태 표시줄을 선호하는 모든 사람.

---

위의 모든 정보는 프로젝트의 README에서 직접 가져온 것입니다. 추가 기능은 추론되지 않았습니다.