Appearance
Install the GitHub App
EasyMerge is a GitHub App. Installing it is what grants access to repositories — signing in alone does not.
Sign in vs. install
These are two separate GitHub screens, and you will see both the first time:
| Step | What GitHub asks | What it grants |
|---|---|---|
| Sign in | Authorize EasyMerge to act as you | Your identity and the list of installations you can see |
| Install | Choose an account and repositories | Read the diff and write review comments on those repositories |
If you already have an installation and just want dashboard access — for example, a teammate installed it on your organization — signing in is enough.
Permissions requested
| Permission | Level | Why |
|---|---|---|
| Metadata | Read | Required by GitHub for every app |
| Contents | Read | Read the diff of a pull request |
| Pull requests | Read & write | Read PRs and post the review |
| Issues | Read & write | PR-level (non-inline) comments go through the Issues API |
| Checks | Read & write | Maintain the EasyMerge Review check run |
| Email addresses | Read | Read your email at sign-in when it is not public |
| Organization members | Read | Check whether you own the organization, to decide who gets the EasyMerge admin role |
EasyMerge never asks for write access to your code. It cannot push commits, create branches, or merge anything.
Choosing where to install
Personal account — installs immediately.
Organization — if you are an owner it installs immediately; otherwise GitHub sends a request an owner has to approve, and EasyMerge stays inactive until they do.
Then pick the repository scope:
- All repositories — including ones created later.
- Only select repositories — an explicit list you maintain.
Either choice can be changed later without reinstalling.
Changing repository access later
On GitHub, go to Settings → Applications → Installed GitHub Apps → EasyMerge → Configure (for an organization: the organization's settings page). Add or remove repositories there.
The dashboard picks the change up on its own, including one an organization owner makes without you. If you made it yourself, GitHub returns you to EasyMerge and the list is current by the time it loads. Switching between All repositories and Only select repositories works the same way.
If the list still looks stale, press Sync From GitHub on the dashboard home.
A repository you remove here leaves the dashboard along with its reviews, but is not deleted: add it back and its earlier reviews and findings come back with it. Uninstalling the app is what removes them for good.
Who can see the installation
EasyMerge shows an installation to a user only after that user has signed in — GitHub decides which installations each person can access. A teammate who has never signed in will not appear, and will not see the dashboard, even though the app is installed on your shared organization.
If you gain access to an installation after signing in — someone installs EasyMerge on another organization you belong to, or adds you to a repository in an existing one — you do not have to sign out and back in. Your access is re-checked each time you open the dashboard, so the new organization appears in the switcher on your next visit; Sync From GitHub brings it in without waiting for a reload.
An organization's admins are its GitHub owners: an owner becomes one when they sign in, whether or not they installed the app. On a personal account it is the account holder. Everyone else who signs in joins as a member. See Connect repositories for what each role may do, and Who becomes an admin for how the role moves when an admin leaves.
Uninstalling
Removing the app on GitHub stops all reviews for that account immediately, and removes that installation's repositories, reviews and findings from the dashboard — see Deleting your data.
Existing pull request comments stay where they are: EasyMerge does not delete anything from your repositories on the way out.