GitHub Integration
Connect your GitHub repositories to AgileTune to track branches, sync pull request statuses, and automatically close tasks when PRs are merged.
3-Step Setup
Step 1: Install the GitHub App
- Go to Organization Settings → Integrations
- Click Connect GitHub
- You'll be redirected to GitHub to install the AgileTune app
- Select the repositories you want to connect and click Install
Step 2: Link a Repository
- Navigate to Project Settings → GitHub
- Select a connected repository from the dropdown
- Click Link Repository
Each project can be linked to one repository. Multiple projects can link to the same repository if needed.
Step 3: Configure Branch Rules
Optionally configure how branches and PRs map to tasks:
- Branch prefix — auto-detect task IDs from branch names (e.g.,
feature/AT-123-add-login) - PR title pattern — extract task IDs from pull request titles
- Auto-link commits — link commits mentioning task IDs (e.g.,
fixes AT-123)
Automatic Branch Tracking
When a branch name contains a task ID, AgileTune automatically links it to the task. The task detail page displays the branch name, its status, and a quick link to the branch on GitHub. You can also create a branch directly from a task using the Create Branch button.
PR Status Sync
Pull requests linked to tasks are displayed on the task detail page with real-time status updates:
- Open — PR is open and awaiting review
- Review requested — reviewers have been assigned
- Changes requested — reviewers requested changes
- Approved — PR has been approved
- Merged — PR has been merged
Auto-Close on Merge
When enabled, merging a linked PR automatically moves the task to the Done column and marks it as resolved. To enable this:
- Go to Project Settings → GitHub
- Toggle Auto-close tasks on PR merge
You can also configure which column tasks are moved to on merge if your workflow uses a column other than "Done" (e.g., "QA Review").