# Github

## GitHub + Multitudes Integration Benefits

* Integrating with GitHub is a prerequisite for using Multitudes&#x20;
* Select GitHub teams/team members to get contributor data in Multitudes&#x20;
* See a range of insights include [DORA](https://cloud.google.com/blog/products/devops-sre/using-the-four-keys-to-measure-your-devops-performance) and [SPACE](https://queue.acm.org/detail.cfm?id=3454124) metrics.

## How it works

### GitHub Data&#x20;

Multitudes pulls in code metadata from GitHub; our app does not ingest your codebase. This metadata includes information about pull requests – such as when they were created, who the author was, commits made on the pull request, number of lines changed, etc. and about comments – including comments written on pull requests and reviews submitted.  This metadata informs Multitudes metrics across [Flow of Work](/metrics-and-definitions/process-metrics/flow-of-work.md), [Value Delivery](/metrics-and-definitions/process-metrics/value-delivery.md), [Quality of Work](/metrics-and-definitions/process-metrics/quality-of-work.md), [Wellbeing](/metrics-and-definitions/people-metrics/wellbeing.md) and [Collaboration](/metrics-and-definitions/people-metrics/collaboration.md). &#x20;

When you set up the GitHub installation, you can see the full list of permissions that Multitudes requests.

### Teams and people

Multitudes also gets some data from teams about their structure, e.g., which teams people are on, their roles, and their levels. This is used to populate your [Multitudes teams](/configuration-and-setup/adding-users-and-teams.md) and associate data with contributors. &#x20;

You can enable [GitHub Teams Sync](/configuration-and-setup/adding-users-and-teams.md#automatically-adding-team-members-via-github-teams-sync) to automatically update your Multitudes contributors based on GitHub teams. &#x20;

## Requirements

**Required role:** [Organization Owner](https://docs.github.com/en/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#about-organization-roles)&#x20;

**Notes:** You must have admin access to select repositories and Github teams/contributors.

## How to install

Follow the GitHub installation steps when you onboard to Multitudes. When installing, you will select which users/teams and repositories to integrate with Multitudes. &#x20;

### How to add additional repos

1. Check what existing repos are synced at the top of any deep-dive page, e.g., <https://app.multitudes.co/flowOfWork>

<figure><img src="/files/8VKa8aHSkhtQfxsiWP5N" alt="App header showing filters, with Repositories filter highlighted.  "><figcaption></figcaption></figure>

2. If you need additional repos, add them via our GitHub App – go to [Integrations](https://app.multitudes.co/teamSettings/integrations), click Configure, and follow the flow to GitHub.

<figure><img src="/files/4A8al8Hg9hgFmrvY9wfx" alt="Integrations page in Multitudes app showing GitHub card with Configure button. "><figcaption></figcaption></figure>

3. The repos will sync for all data moving forward. To get 6 weeks of historic data, contact <support@multitudes.com> with a list of the repos you added and we’ll trigger a historic data pull.&#x20;

&#x20;&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.multitudes.com/integrations/github.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
