GitHub Token Setup

Follow these simple steps to generate your Personal Access Token

The 20metrics app requires a GitHub Token to function. You need to generate this token from your GitHub account to allow the app to access and analyze your repository data.

1

Go to Developer Settings

Log in to GitHub and navigate to your Settings. Scroll down to the bottom of the left sidebar and click on Developer settings.

Alternatively, click this direct link: Generate New Token

2

Create Classic Token

Select Personal access tokens > Tokens (classic) from the sidebar. Then click the Generate new token button and select Generate new token (classic).

3

Configure Token

Give your token a descriptive name (e.g., "20metrics").

4

Select Scopes

This is the most important part. You need to select the following scopes:

  • ☑ repo (Full control of private repositories)
  • ☑ read:org (Read-only access to organization membership)
Note: We only need read access to analyze your data. The "repo" scope is required because GitHub doesn't have a granular "read-only" scope for private repositories in Classic tokens. Your code never leaves your machine.
Select Scopes
5

Generate and Copy

Scroll to the bottom and click Generate token.

Copy your new token immediately! You won't be able to see it again once you leave the page.

Finally, paste the copied token into the 20metrics app to start your analysis.

Paste token in app
6

Authorize Organization

If your organization is managed by SSO, you additionally need to authorize that organization.

Click Configure SSO and then Authorize on GitHub.

Configure SSO Authorize Organization

Got your token?

You're ready to start analyzing your engineering data.

Download 20metrics