Your GitHub companion — track PRs, manage branches and worktrees, all from a native macOS app.
| Pull requests | Branches / Worktrees |
|---|---|
 |
 |
- macOS (arm64 or x64)
- GitHub CLI (
gh) installed and authenticated (gh auth login)
brew install --cask adelbeke/donna/donnaOr download the latest .dmg from Releases, mount it, drag Donna to Applications.
Pull Requests
- Three sections: Review requested · My PRs · Mentioned
- Filter by repository, search by title, sort newest/oldest
- Filter by your own review state: changes requested / commented / not reviewed
- Star PRs as top priority — pinned at the top
- Hide PRs you don't care about; toggle drafts / hidden
- Cards show repo, author, diff size, review-state badges, CI status, conflict indicator, relative timestamps
Branches
- Add local repositories via directory picker
- Lists all branches across your repos, with worktree detection
- Shows dirty state and linked PR per branch
- One-click copy for
git switch <branch>orcd <worktree>
Donna queries GitHub's search API for open PRs directly — it is a PR tracker, not a mirror of your GitHub Notifications inbox.
| GitHub Notifications | Donna | |
|---|---|---|
| Source | Notification events | Live PR search |
| "Mark as done" | Dismisses the notification | No effect in Donna |
| Scope | Only PRs that generated a notification | All open PRs matching the search criteria |
This means:
- Hiding a PR in Donna marks it locally — it won't affect your GitHub Notifications.
- PRs you've marked as done in GitHub will still appear in Donna's Review requested section as long as GitHub still has you as a requested reviewer on that PR.
- If you're seeing a large number of stale review requests, the fastest fix is to ask the PR author to re-request review or dismiss the request on GitHub.
Donna's value is a focused, persistent view of what's actually open and needs your attention — independent of whether you've cleared the notification.
Donna delegates all GitHub API calls to the gh CLI — no token to manage, no PAT stored anywhere. Run gh auth login once and you're done.
The web version is no longer maintained. adelbeke.github.io/donna now points to a static notice linking to the latest release — download the desktop app instead.
npm install
npm run dev # vite dev server, required by dev:electron below
npm run dev:electron # Electron window (requires vite dev server running)
npm run lint
npm run test:run
npm run build:electronElectron, React 19, electron-vite, TypeScript, Tailwind v4, Zustand, TanStack Query, graphql-request.
See CONTRIBUTING.md.
MIT © Arthur Delbeke