GitHub

The GitHub integration watches your connected repositories for pull requests that reference task IDs. When a PR is linked to a task, you see its status inline — open, reviewed, merged, closed — and merging the PR can auto-close the task.

Screenshot needed — add an annotated image showing this UI

Connecting GitHub

1. Open a project
2. Go to Settings → Integrations → GitHub
3. Click Connect repository
4. Authorize the Workestra GitHub App and pick the repositories you want to link

Multiple projects can link to the same repository; multiple repositories can link to one project.

How PRs Get Linked

Workestra auto-links PRs to tasks when the task ID appears in:

• The PR title (e.g. PROJ-142 Fix login bug)
• The branch name (e.g. fix/PROJ-142-login-bug)
• The PR description (e.g. Closes PROJ-142)

Task IDs follow the format <PROJECT-SLUG>-<NUMBER>.

Auto-Close on Merge

When a linked PR is merged:

• The task auto-transitions to a Done status (configurable at the project's GitHub settings)
• The merge timestamp, commit SHA, and PR author are recorded in the activity feed
• Any subtasks attached to the task are left unchanged

If you'd rather not auto-close, turn off Auto-close on merge at the integration settings.

What You See on the Task

A linked PR shows on the task detail with:

• PR title and number
• Branch name
• Current status (Open, Review requested, Approved, Merged, Closed)
• Checks status (CI passing, failing, pending)
• Clickable link to GitHub

What You See on the PR

The Workestra GitHub App posts a comment on linked PRs with:

• Task title, assignee, status, priority
• Clickable link back to the Workestra task
• Status updates as the task changes

Disconnecting

At Settings → Integrations → GitHub, click Remove repository. Already-linked PRs stay linked for history, but new PRs stop auto-linking.

---

Next Steps

• Tasks — task IDs and statuses
• Webhooks — build your own PR-aware automations
• GitHub integration overview — GitHub's other uses in Workestra