Skip to content

Connect GitHub

You will learn how to connect the Tixio GitHub App, map repositories to projects, link pull requests and commits to issues, and optionally move issues to done when a linked PR merges.

Only workspace owners and admins can connect GitHub or change repository mappings. Any member can see linked development activity on issues once GitHub is connected.

1. Open GitHub settings

  1. Open your workspace.
  2. Choose Settings > Integrations.
  3. Open the GitHub tile.

If the page says GitHub is not configured on this deployment, ask your Tixio administrator to enable the GitHub App for your environment.

2. Connect the GitHub App

  1. Choose Connect GitHub.
  2. Complete the GitHub install or authorization flow for your organization or personal account.
  3. Confirm the page shows Connected as your GitHub account login.

You can open View on GitHub to inspect the installation, or Disconnect (then Confirm disconnect) if you need to remove it later.

3. Map repositories to projects

Under Repositories:

  1. For each GitHub repository, choose the Tixio project that owns that code, or leave — Not mapped — until you are ready.
  2. Choose Refresh after you grant the GitHub App access to additional repositories in GitHub.

Only mapped repositories participate in auto-linking and auto-transition for their project.

4. Configure auto-transition on merge

Under Auto-transition on PR merge, enable or disable the checkbox for each project.

When enabled, merging a pull request that references an issue key (for example PROJ-123 in the PR title or branch) moves that issue into the project's first completed status.

Open an issue and scroll to the Development section.

Tixio auto-links when the issue key appears in:

  • A pull request title or branch name.
  • A commit message.
  • A branch name such as feature/PROJ-42-thing.

You can also choose Link PR, paste a GitHub pull request URL, and choose Link.

The PRs, Commits, and Branches tabs show linked items. Pull request rows can include state (open, merged, draft, closed) and a CI status indicator when GitHub reports checks.

6. Turn on GitHub notifications

Open Settings > Notifications and review the development event types:

  • Pull requests
  • Commits & branches
  • CI checks

Choose In-app, Email, and Slack delivery modes that match how you want to hear about linked development activity. See Tune notification settings.

What members see without admin access

Members who are not workspace owners or admins see that only owners and admins can manage GitHub integration settings. They can still use linked PRs, commits, and branches on issues after an admin connects GitHub.

Next