RepoBell

RepoBell은 GitHub 알림을 macOS 시스템 알림으로 전달하는 네이티브 메뉴 막대 앱입니다. 이메일 알림을 켜지 않아도 새 PR, Issue, Discussion, Commit과 기존 알림의 갱신을 바로 확인할 수 있습니다.

설치

RepoBell은 macOS 14 이상을 지원합니다. Homebrew로 설치하세요.

brew install --cask wibaek/tap/repobell

RepoBell이 사용하는 GitHub CLI gh가 없다면 Homebrew가 함께 설치합니다.

GitHub 로그인

RepoBell은 활성화된 gh 로그인을 재사용하며 GitHub token을 별도로 저장하지 않습니다. 다음 명령으로 로그인하고 알림 접근 권한을 추가하세요.

gh auth login -h github.com
gh auth refresh -h github.com -s notifications
gh auth status -h github.com

여러 GitHub 계정이 등록되어 있다면 RepoBell에서 사용할 계정을 활성화합니다.

gh auth switch -h github.com -u <username>

GitHub Notifications API에는 notifications 또는 repo scope가 필요합니다. fine-grained PAT와 GitHub App token은 이 API를 지원하지 않습니다.

첫 실행

응용 프로그램 폴더에서 RepoBell을 열거나 다음 명령을 실행합니다.

open -a RepoBell

첫 실행에서 macOS 알림 권한을 허용하세요. RepoBell은 Dock에 나타나지 않으며 메뉴 막대의 종 아이콘에서 사용할 수 있습니다.

첫 동기화에서는 현재 GitHub 알림함을 기준선으로만 저장합니다. 기존 알림이 한꺼번에 표시되지 않으며, 이후 새로 생기거나 갱신된 알림부터 전달합니다.

주요 기능

• 새 알림과 갱신된 알림을 macOS 시스템 알림으로 전달
• 시스템 알림이나 최근 목록을 눌러 실제 GitHub 페이지 열기
• 메뉴 막대에서 미확인 개수, 계정과 폴링 상태 확인
• 최근 알림 표시 개수를 5, 10, 20, 50개 중에서 선택
• GitHub 알림함 열기와 폴링 일시정지·재개
• 알림을 연 뒤 GitHub thread를 읽음 처리하는 옵션
• macOS 로그인 시 자동 실행
• 재시작 후에도 같은 알림이 반복되지 않도록 로컬 상태 보존

RepoBell은 GitHub가 안내하는 폴링 간격을 준수하며, 변경이 없을 때는 조건부 요청을 사용합니다.

설정

• Recent notifications: 메뉴에 표시할 최근 알림 수입니다. 기본값은 10개입니다.
• Mark GitHub thread as read after opening: GitHub 페이지를 연 뒤 해당 thread를 읽음 처리합니다. 기본값은 켜짐입니다.
• Launch RepoBell at login: macOS 로그인 시 RepoBell을 자동으로 실행합니다. 추가 승인이 필요하면 설정에서 로그인 항목 설정을 열 수 있습니다.
• Pause Polling: 현재 실행 중인 앱의 폴링을 멈춥니다. 앱을 다시 실행하면 폴링이 재개됩니다.

업데이트와 삭제

최신 버전으로 업데이트합니다.

brew update
brew upgrade --cask wibaek/tap/repobell

RepoBell을 삭제합니다.

brew uninstall --cask wibaek/tap/repobell

설정과 최근 알림 상태까지 함께 삭제하려면 --zap을 추가합니다.

brew uninstall --zap --cask wibaek/tap/repobell

데이터와 개인정보

RepoBell은 활성 gh 로그인을 사용하며 GitHub token을 앱 내부에 저장하지 않습니다. 중복 알림 방지와 최근 목록에 필요한 알림 메타데이터만 다음 위치에 저장합니다.

~/Library/Application Support/RepoBell/notification-state.json

문제 해결

• Sign in with gh: gh auth status -h github.com을 확인하고 다시 로그인합니다.
• Notification access required: gh auth refresh -h github.com -s notifications로 알림 scope를 추가합니다.
• 알림 기록에는 있지만 배너나 소리가 없음: macOS 집중 모드에서 RepoBell 알림을 허용했는지 확인합니다.
• 시스템 알림이 전혀 보이지 않음: macOS 시스템 설정 → 알림 → RepoBell에서 알림, 배너와 사운드를 허용합니다.
• 첫 실행 후 기존 알림이 표시되지 않음: 정상 동작입니다. 첫 동기화 이후 새로 생기거나 갱신된 알림부터 전달합니다.
• 로그인 항목이 Approval required로 표시됨: RepoBell 설정의 Open Login Items Settings를 눌러 macOS에서 허용합니다.

소스 빌드와 릴리스 방법은 개발 문서를 참고하세요.