# GitHub

Репозитории, issues, pull requests, коммиты и GitHub Actions

## Сценарии

### Что висит без ревью
Агент соберёт открытые pull request по вашим репозиториям и покажет, что дольше всех ждёт ревью и кого стоит подтолкнуть.

### Разбор упавших сборок
Агент найдёт упавшие прогоны GitHub Actions и покажет, в каком коммите и на каком шаге сломалась сборка.

### Сводка по репозиторию
Агент пришлёт ежедневную сводку: новые PR, закрытые issues и статус сборок по согласованному с вами расписанию.

### События в рабочий чат
Агент поймает push, новый issue или запрос ревью по вебхуку и напишет об этом в чат команды сразу, а не утром.

## Как подключить

### Войдите под рабочим аккаунтом GitHub
Откройте github.com под тем аккаунтом, у которого уже есть доступ к нужным репозиториям. Права агента не шире прав этого аккаунта: чего он не видит, того не увидит и агент.

### Уточните, кто ставит приложения в организации
Если репозитории принадлежат организации, GitHub App ставит её владелец: участник видит кнопку «Install and request», и установка повисает заявкой. Договоритесь с владельцем заранее.

### Откройте SAML-сессию организации
Если в организации включён SAML SSO, зайдите на github.com/orgs/ORG/sso и начните активную сессию до установки. Без неё организация просто не появится в списке аккаунтов при установке.

### Выберите репозитории для приложения
На экране установки укажите «All repositories» или «Only select repositories» и отметьте нужные. Доступ задаётся установкой, токены и scope выпускать не нужно: репозиторий вне списка для агента не существует.

### Запомните, где менять доступ потом
Личный аккаунт: Settings → Integrations → Applications → «Installed GitHub Apps» → «Configure». Организация: Settings → Third-party Access → «GitHub Apps» → «Configure». Там же добавляются новые репозитории.

## Частые вопросы

### Как подключить GitHub?
Входом через GitHub: нажмите кнопку подключения и подтвердите установку приложения, ключи вводить не нужно. В организации приложение ставит владелец, а при SAML SSO сначала откройте сессию на github.com/orgs/ORG/sso, иначе организации не будет в списке.

### Что агент видит в GitHub?
Только репозитории, отмеченные при установке: issues, pull request, комментарии, коммиты и прогоны GitHub Actions по ним.

### Как расширить доступ?
При установке выбирается «All repositories» или «Only select repositories». Список можно поменять позже через «Configure» у приложения — агент сразу начнёт видеть добавленные репозитории.

### Что с событиями и лимитами?
Вебхук приносит push, PR, issues, ревью и завершённые workflow, поэтому опрашивать API не нужно. Сами запросы идут не чаще 10 в секунду, чтобы не упереться в лимиты GitHub.

[Открыть GitHub](https://github.com)