GitHub — подключение

Коннектор GitHub показывает issues из репозиториев, где вы участвуете (исполнитель, автор, упомянуты или подписаны), и позволяет комментировать, закрывать/открывать задачи и двигать их по колонкам доски Projects.

Время в GitHub не записывается — у GitHub нет учёта времени в принципе. Длительность GPS-сессий и таймера сохраняется в Taskloc и видна в отчётах приложения.

Шаг 1. Создайте Personal Access Token (fine-grained)

1. Откройте github.com/settings/personal-access-tokens (Settings → Developer settings → Personal access tokens → Fine-grained tokens).
2. Generate new token.
3. Repository access — выберите репозитории, задачи которых хотите видеть (или All repositories).
4. Permissions → Repository permissions:
   • Issues — Read and write (просмотр, комментарии, закрытие).
   • Metadata — Read-only (включается автоматически).
5. Если будете привязывать доску Projects (см. шаг 3):
   • Organization permissions → Projects — Read and write (для досок организации);
   • либо Account permissions → Projects (для личных досок).
6. Generate token и скопируйте строку github_pat_… — она показывается один раз.

Классический PAT (scopes repo, project) тоже работает, но fine-grained безопаснее: вы выдаёте доступ только нужным репозиториям.

Шаг 2. Подключите коннектор

1. В приложении: Настройки → Организации → организация → Интеграции → «+» → GitHub.
2. Вставьте токен.
3. (Опционально) укажите привязку доски Projects — шаг 3.
4. Подключить — задачи появятся в списке.

Шаг 3 (опционально). Привяжите доску Projects v2

Без привязки статус задачи — только «Открыта» / «Закрыта». Если команда ведёт kanban-доску GitHub Projects, привяжите её — на карточках появится колонка доски (Todo / In Progress / Done…), и статус можно будет менять прямо из приложения.

В полях подключения укажите:

• Владелец — логин пользователя или организации, которой принадлежит доска (из URL github.com/orgs/<owner>/projects/<N> или github.com/users/<owner>/projects/<N>).
• Номер — число <N> из того же URL.

Привязывается одна доска. Задачи, не добавленные на неё, продолжают показывать «Открыта/Закрыта».

Что не поддерживается

• Pull request'ы (показываются только issues).
• Запись времени в GitHub (его там нет — время живёт в Taskloc).
• Вложения, подзадачи (sub-issues), связи задач.
• GitHub Enterprise Server (только github.com).

Troubleshooting

• Список пуст — проверьте, что токен имеет доступ к нужным репозиториям (Repository access) и что вы участвуете в задачах (исполнитель/автор/упомянуты). Issues чужих репозиториев без вашего участия не показываются.
• 403 при смене колонки доски — токену не выдано право Projects для организации-владельца доски. Пересоздайте токен с Organization permissions → Projects → Read and write.
• Колонки доски не видны — проверьте владельца и номер доски (шаг 3); название поля статуса на доске должно быть стандартным Status.
• Токен истёк — fine-grained PAT имеет срок действия; создайте новый и переподключите коннектор (Настройки → Интеграции → GitHub).