gitnotify

Monitor GitHub repositories from your terminal. Get macOS desktop notifications when there are new commits, pull requests, issues, releases, and more.

Install

npm install -g gitnotify

Usage

# Add repos to your watch list
gitnotify add facebook/react
gitnotify add vercel/next.js

# See what you're watching
gitnotify list

# Start monitoring (checks every 5 minutes by default)
gitnotify watch

# Check more frequently (minimum 30s)
gitnotify watch --interval 60

# Test notifications for a repo
gitnotify test facebook/react

# Check last activity timestamps
gitnotify status

# Stop watching a repo
gitnotify remove facebook/react

Features

• Desktop notifications - macOS notifications via native Notification Center
• Multiple repos - Watch as many repos as you want
• Smart dedup - Only notifies for new events since last check
• Event types - Commits, PRs, issues, releases, forks, stars, comments
• Rate limit aware - Respects GitHub API limits (60 req/hr unauthenticated)
• Persistent state - Remembers what you've seen across sessions (~/.gitnotify.json)

Example notifications

facebook/react: gaearon pushed 3 commits to main
  abc1234 Fix: memory leak in useEffect
  def5678 Add: new concurrent features
  ghi9012 Docs: update API reference

vercel/next.js: rauchg created Release
  v14.3.0 - Stable release with Turbopack improvements

Requirements

• Node.js >= 16
• macOS (for desktop notifications)
• Works on Linux/Windows too, but without desktop notifications

License

MIT