Skip to main content
GitHub is how Xerg finds everything else. You connect it by signing up: Sign up with GitHub installs the Xerg App on your organization or account and signs you in. See the Quickstart.

​
Permissions

The Xerg App asks for read-only access, and nothing else: It can’t push code, open pull requests, change settings or see issues.

​
Which repos

Xerg maps every repo the app can see. When you install it, GitHub asks whether that’s all repos or only the ones you pick. To change the list later, a workspace admin or owner chooses choose repos in Xerg’s left rail, which opens the app’s settings on GitHub. A repo the app can no longer see comes off the map. Earlier days in history still have it.

​
Not an owner?

GitHub sends your install to the organization’s owners as a request. Xerg picks it up once they approve it. Meanwhile you can map public repos.

​
Who joins

The first person in through GitHub is the workspace’s owner. Others with access to the install join as viewers when they sign in, and an admin can make them members. See Teams and roles.

​
Removing it

Uninstall the Xerg App from your organization’s Settings → GitHub Apps on GitHub. Xerg can no longer read your repos; to delete the workspace and its map, see Security and data.