Skip to content

README.md

Latest commit

 

History

History
93 lines (61 loc) · 3.59 KB

README.md

File metadata and controls

93 lines (61 loc) · 3.59 KB
Raw

donna

Your GitHub companion — track PRs, manage branches and worktrees, all from a native macOS app.

CI MIT License

Pull requests Branches / Worktrees
Screenshot 2026-06-27 at 09 56 18 Screenshot 2026-06-26 at 10 26 17

Requirements

  • macOS (arm64 or x64)
  • GitHub CLI (gh) installed and authenticated (gh auth login)

Install

brew install --cask adelbeke/donna/donna

Or download the latest .dmg from Releases, mount it, drag Donna to Applications.

Features

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> or cd <worktree>

How Donna works (vs GitHub Notifications)

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.

Auth

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.

Web version

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.

Dev

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:electron

Tech stack

Electron, React 19, electron-vite, TypeScript, Tailwind v4, Zustand, TanStack Query, graphql-request.

Contributing

See CONTRIBUTING.md.

License

MIT © Arthur Delbeke