01 / YOUR PR INBOX
See what needs
your attention.
Start with reviews requested from you, including team requests. Switch the Reviewers filter to All to include other PRs involving your account.
Read the status at a glance
See check results and review progress alongside each PR. Open PRs appear first.
Focus on the right repositories
Filter by repository, status, checks, or reviews. Your selections are remembered locally.
Stay up to date with notifications
Enable notifications for new PRs and PRs that become unblocked, so you know when to take a look.
Click the screenshot to enlarge.
02 / FROM INBOX TO ACTION
The right PR.
The right workspace.
Open a pull request in the browser to review it, or open its branch locally to work on the code.
Review on GitHub
Read diffs, check conversations, and submit your review on the PR’s GitHub page.
Work in code editor
Create or reuse a git worktree for the PR branch and open it in a new IDE window.
Editor handoff requires a local repository checkout, a configured project directory,
and a code command.
Your pull requestChoose where to open it
IN YOUR BROWSER
GitHub
Diffs, comments,
and code review
ON YOUR MAC
IDE
The PR branch in
a local worktree
Your browser and editor take it from there.
03 / GET SET UP
Use your existing
GitHub login.
MergePulse uses the GitHub CLI on your Mac. Authenticate with your GitHub.com account, then open the app. There’s no separate MergePulse account or token to manage.
- 1
Install the GitHub CLI
Install
ghif it isn’t already available. Get GitHub CLI - 2
Authenticate once
Run
gh auth loginif you aren't signed in. - 3
Open MergePulse
Choose repositories and filters, then set your refresh interval.
$ gh auth login
Open MergePulse from your menu bar.
QUESTIONS & ANSWERS
A few useful details.
Accounts, requirements, and what happens inside the app.
Does MergePulse write reviews or comments?
No. MergePulse is read-only on GitHub. It does not create comments, submit reviews, merge pull requests, or edit GitHub data.
Click a pull request to continue the review in your default browser.
Does it show diffs or discussion threads?
No. The app summarizes pull-request status and review progress to help you triage the queue.
Use GitHub in the browser for code diffs, conversations, and review actions.
How are stacked pull requests detected?
MergePulse matches one pull request’s base branch reference to another pull request’s head branch reference and places the child beneath that parent.
These are inferred dependencies, not verified commit ancestry. Ambiguous matches and cycles receive a visible warning.
Which pull requests are included?
The default scope is pull requests with a review request for you, including team review requests. Switch the Reviewers filter to All to include other pull requests involving you. Your other saved filters still apply.
What does MergePulse need to run?
MergePulse requires macOS 14 or later and the GitHub CLI. Authenticate in Terminal with gh auth login, then reopen the menu-bar window.
Does it support GitLab or GitHub Enterprise?
MergePulse currently uses the GitHub.com account authenticated through the GitHub CLI. GitLab and custom GitHub Enterprise hosts are not supported, yet.
READY WHEN YOU ARE
Your PR queue.
Now in your menu bar.
A smaller place to keep track of the work.
A quicker way to open what’s next.
macOS 14+ · Apple silicon or Intel
Requires the GitHub CLI. View setup