GitHub — connecting

The GitHub connector shows issues from repositories you take part in (assignee, author, mentioned or subscribed) and lets you create issues, comment, close/reopen them and move them across the columns of a Projects board.

Creating a task — ✅ supported: the "+" button on the task list creates an issue right in the repository (more).

Time is not written to GitHub — GitHub has no time tracking at all. The duration of GPS sessions and the timer is saved in Taskloc and is visible in the app's reports.

Step 1. Create a Personal Access Token (fine-grained)

1. Open github.com/settings/personal-access-tokens (Settings → Developer settings → Personal access tokens → Fine-grained tokens).
2. Generate new token.
3. Repository access — choose the repositories whose issues you want to see (or All repositories).
4. Permissions → Repository permissions:
   • Issues — Read and write (viewing, comments, closing).
   • Metadata — Read-only (turned on automatically).
5. If you are going to link a Projects board (see step 3):
   • Organization permissions → Projects — Read and write (for organization boards);
   • or Account permissions → Projects (for personal boards).
6. Generate token and copy the github_pat_… string — it is shown only once.

A classic PAT (scopes repo, project) also works, but a fine-grained one is safer: you grant access only to the repositories you need.

Step 2. Connect the connector

1. In the app: Settings → Organizations → organization → Integrations → "+" → GitHub.
2. Paste the token.
3. (Optional) set up the Projects board link — step 3.
4. Connect — the issues will appear in the list.

Step 3 (optional). Link a Projects v2 board

Without a link, the task status is only "Open" / "Closed". If your team runs a kanban board in GitHub Projects, link it — the cards will show the board column (Todo / In Progress / Done…), and you will be able to change the status right from the app.

In the connection fields enter:

• Owner — the login of the user or organization that owns the board (from the URL github.com/orgs/<owner>/projects/<N> or github.com/users/<owner>/projects/<N>).
• Number — the number <N> from the same URL.

One board is linked. Issues not added to it keep showing "Open/Closed".

What is not supported

• Pull requests (only issues are shown).
• Time entries to GitHub (there are none — the time lives in Taskloc).
• Attachments, sub-issues, issue relationships.
• GitHub Enterprise Server (github.com only).
• Assigning an assignee from the app. The connector does not write the assignee: GitHub expects the user's login as a string, and the app does not send it. If you change the assignee in the app, the change is silently lost — there will be no error, but in GitHub the issue stays with the previous person. The assignee is visible in the list and in the card; change it in GitHub itself. The "Assign the task to me on start" switch does not work for GitHub for the same reason.

Troubleshooting

• The list is empty — check that the token has access to the repositories you need (Repository access) and that you take part in the issues (assignee/author/mentioned). Issues of other repositories without your participation are not shown.
• 403 when changing the board column — the token was not granted the Projects permission for the organization that owns the board. Recreate the token with Organization permissions → Projects → Read and write.
• Board columns are not visible — check the board owner and number (step 3); the name of the status field on the board must be the standard Status.
• The token has expired — a fine-grained PAT has an expiration date; create a new one and reconnect the connector (Settings → Integrations → GitHub).