Installation

Slack Installation (and scopes)

To install Axolo, you’ll need to sign up from our home page. We will require access to specific scopes in order to be able to push notifications and create channels as a Slack application.

Required Slack scopes:

Bot Scopes

The following scopes are the scopes we require for Axolo to work.

Slack installation
Bot ScopesReason
app_mentions:readView messages that directly mention @axolo in conversations
channels:manageManage public channels that Axolo has been added to and create new ones
channels:historySee which messages need to be updated in a channel (for example, a pull request doesn't have a conflict anymore we need to delete that message)
channels:readView basic information about a channel
commandsLGTM command to allow approving a PR right from Slack
groups:historyView messages and other content in private channels that Axolo has been added to
groups:writeManage private channels that Axolo has been added to and create new ones
reactions:writeAdd and edit emoji reactions
chat:writePost messages in approved channels & conversations
chat:write.publicSend messages to public channels @axolo isn't a member of
im:historyView messages and other content in direct messages that Axolo has been added to
im:readView basic information about direct messages that Axolo has been added to
im:writeStart direct messages with people
users:readView people in a workspace
reactions:readView emoji reactions and their associated content in channels and conversations that Axolo has been added to
emoji:readView custom emoji in a workspace

User Scopes

Optional scopes are to be granted from every user onboarded on Axolo. They allow us to reduce notifications when the engineer does an action in GitHub.

User ScopeReason
chat:writePost messages in approved channels & conversations
channels:writeManage a user’s public channels and create new ones on a user’s behalf
groups:writeManage private channels that Axolo has been added to and create new ones
reactions:writeAdd and edit emoji reactions

GitHub installation (and scopes)

When the Slack application is installed, you will need to install our GitHub application.

You need to choose between installing Axolo on all of your organization repositories or selecting only specific repositories. You will be able to add new repositories along the way if you choose the latter.

Axolo GitHub integration

Axolo does not have access to your company’s code. GitHub code lies in the “Content API”. More information about GitHub scopes can be found here.

Required GitHub scopes:

ScopePermissionDescription
ActionsReadWorkflows, workflow runs, and artifacts
AdministrationReadRepository creation, deletion, settings, teams, and collaborators
DeploymentsReadDeployments and deployment statuses
MembersReadOrganization members and teams
MetadataReadSearch repositories, list collaborators, and access repository metadata
Repository hooksReadRepository created, deleted, archived, unarchived, publicized, privatized, edited, renamed, or transferred
StatusreadCommit status updated from the API
Team discussionsReadDiscussions and related comments and labels
IssuesRead & WriteIssues and related comments, assignees, labels, and milestones
Pull requestsRead & WritePull requests and related comments, assignees, labels, milestones, and merges
Workflow runReadWorkflow run requested or completed on a repository

GitLab installation (and scopes)

WIP... 🛠

Axolo onboarding

Now that Slack and GitHub applications are configured, we only need to match GitHub members to Slack users.

You can filter your team members by specific GitHub teams, or search your a GitHub login.

Select team members on Axolo

🎉 Congratulations! You can start using Axolo and select open pull requests in the same modal to create your first code review channels right away.