Repolode
sk-ruban

sk-ruban/notchi

Claude Code와 Codex 에이전트의 활동에 실시간으로 반응하는 macOS 노치 영역 앱입니다.

스타
1,042
포크
78
열린 이슈
16
마지막 커밋
16일 전

어떤 프로젝트인가요?

Notchi는 macOS 노치에 자리 잡고, Claude Code와 Codex의 작업에 반응하는 애니메이션 마스코트를 보여주는 앱입니다. 실행 시 두 에이전트에 셸 스크립트 훅을 등록하고, 생각 중, 도구 사용, 권한 요청, 컨텍스트 압축, 오류, 작업 완료 등의 이벤트를 Unix 소켓으로 받아 스프라이트 애니메이션에 연결합니다. 동시에 실행되는 각 세션에는 Claude 또는 Codex 스프라이트 계열에서 마스코트가 하나씩 배정됩니다.

노치를 클릭하면 실시간 활동 피드, 세션 시간, 사용량 한도가 표시되는 패널이 열립니다. 30일 보기에서는 제공자별 또는 전체 기준으로 일일 비용과 토큰 사용량을 추적합니다. 설정에 Anthropic 또는 OpenAI API 키를 추가하면 앱이 프롬프트의 감정을 분석해 마스코트가 감정적으로 반응합니다. 이벤트별 효과음은 선택 사항이며 사용자 지정 사운드로 바꿀 수 있습니다. 터미널 창에 포커스가 있으면 효과음이 자동으로 음소거됩니다.

앱을 사용하려면 macOS 15 이상과 노치가 있는 MacBook이 필요하며, Sparkle을 통해 자동 업데이트됩니다.

핵심 기능

  • 01생각 중, 작업 중, 권한 요청, 오류 등 Claude Code와 Codex의 이벤트에 반응합니다.
  • 02동시에 실행되는 세션마다 별도의 마스코트를 표시합니다.
  • 03Anthropic 또는 OpenAI API로 프롬프트 감정을 분석해 감정 표현을 이끌어냅니다.
  • 04세션 시간, 사용량 한도, 30일간의 비용 및 토큰 사용량 차트를 보여줍니다.
  • 05선택적 효과음과 사용자 지정 사운드 가져오기를 지원합니다.
  • 06여러 언어를 지원하며 시스템 언어를 따릅니다.

활용 사례

  • 창을 전환하지 않고 오래 실행되는 Claude Code 또는 Codex 세션을 확인할 때.
  • 코딩 에이전트의 권한 요청이나 오류를 한눈에 파악할 때.
  • 여러 제공자에 걸친 일일 AI 코딩 비용과 토큰 사용량을 추적할 때.

빠른 시작

  1. 1

    릴리스 페이지에서 최신 DMG를 다운로드하세요

  2. 2

    DMG를 열고 Notchi를 응용 프로그램으로 드래그하세요

  3. 3

    Notchi를 실행하면 Claude Code 및 Codex hooks가 자동으로 설치됩니다

사용 전 알아둘 점

  • macOS 15.0 이상만 지원하며, 노치가 있는 MacBook이 필요합니다.
  • Claude Code 및/또는 Codex가 설치되어 있어야 합니다.
  • 감정 분석에는 Anthropic 또는 OpenAI API 키가 필요합니다(선택 사항).

토픽

자주 묻는 질문

notchi은(는) 무엇인가요?
Claude Code와 Codex 에이전트의 활동에 실시간으로 반응하는 macOS 노치 영역 앱입니다. Notchi는 macOS 노치에 자리 잡고, Claude Code와 Codex의 작업에 반응하는 애니메이션 마스코트를 보여주는 앱입니다. 실행 시 두 에이전트에 셸 스크립트 훅을 등록하고, 생각 중, 도구 사용, 권한 요청, 컨텍스트 압축, 오류, 작업 완료 등의 이벤트를 Unix 소켓으로 받아 스프라이트 애니메이션에 연결합니다. 동시에 실행되는 각 세션에는 Claude 또는 Codex 스프라이트 계열에서 마스코트가 하나씩 배정됩니다.
notchi은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
notchi은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
notchi은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. notchi의 마지막 커밋은 2026년 10월 4일입니다.
notchi은(는) 어디에 사용할 수 있나요?
창을 전환하지 않고 오래 실행되는 Claude Code 또는 Codex 세션을 확인할 때. 코딩 에이전트의 권한 요청이나 오류를 한눈에 파악할 때. 여러 제공자에 걸친 일일 AI 코딩 비용과 토큰 사용량을 추적할 때.
notchi는 어떻게 설치하나요?
릴리스 페이지에서 최신 DMG를 다운로드하세요 DMG를 열고 Notchi를 응용 프로그램으로 드래그하세요 Notchi를 실행하면 Claude Code 및 Codex hooks가 자동으로 설치됩니다
notchi은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/sk-ruban/notchi

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트