/
/
Bring BugHerd and GitHub back in step, row by row
For project leads who want linked BugHerd tasks and GitHub issues to agree on status, just by asking their AI assistant.
On this page
Connector
Connect BugHerd, pick your AI tool and paste the prompt.
The problem
Bulk status fixes risk closing the wrong item
Linked BugHerd tasks and GitHub issues fall out of step all the time. Fixing them means closing issues and marking tasks done one by one with a note on each, and doing it in bulk by hand risks closing the wrong item.
Without PopdockAI
- Find pairs where only one side is finished
- Close GitHub issues one by one
- Mark BugHerd tasks done and add a note
- Close the wrong item when working in bulk
With PopdockAI
- Pairs where only one side is finished are found
- Each proposed change appears in one table
- Only the rows you approve are applied, with a comment
- Nothing is reopened, titles and labels are left alone
The prompt
Use this prompt
Copy it into any AI tool connected to PopdockAI. Swap the values in braces for your own.
**Objective:** Bring linked items in the BugHerd project `{project-name}` and the GitHub repository `{repository}` back in step.
How the two systems are linked: a BugHerd task created from a GitHub issue carries "<repository>#<issue number>" in its external-id. A GitHub issue created from BugHerd starts its title with "[BugHerd <project name> #<task number>]".
**Step 1: Find the drifted pairs**
Call `bugherd-get-projects` with `name.contains` set to `{project-name}`. If nothing matches, say so and stop. If several match, list their names and project-id values and ask which one; do not guess. Then read the links as the reconcile job does: `bugherd-get-tasks` and `bugherd-get-archived-tasks` with `project-id` (external-id starting "{repository}#"), and `github-get-issue` with `company` and `title.contains` "[BugHerd". Keep the pairs where exactly one side is finished.
**Step 2: Propose**
* Closed on GitHub, open in BugHerd: set the task's status to done and comment "GitHub issue #<number> was closed on <closed-date>; please check on the site."
* Done in BugHerd, open on GitHub: close the issue and comment "BugHerd task #<task number> is done."
Show every proposal in one table and ask which rows to apply.
**Step 3: Apply approved rows**
* BugHerd: call `bugherd-update-task` once with `project-id`, `task-id` and `status` done, then `bugherd-add-comment` once.
* GitHub: call `github-add-issue-comment` once with `company`, `issue-number` and `body`, then `github-update-issue` once with `company`, `issue-number` and `state` closed.
**Step 4: Report**
What was changed on each side and anything that failed, with the error.
**Rules & Guidelines:**
* Tools named bugherd-... are on the bugherd MCP server; tools named github-... are on the github MCP server. Every GitHub tool takes the repository as its `company` parameter. If either set of tools is missing, say which server is not connected and stop.
* The only write tools this prompt may call are `bugherd-update-task`, `bugherd-add-comment`, `github-add-issue-comment` and `github-update-issue` (state only), and only for approved rows.
* Never reopen anything; never change titles, labels, assignees or milestones.
**Validation:**
* If nothing has drifted, say so and stop.
* If one update fails, report it and carry on with the other rows.Who it's for
One answer, three teams that use it
Project managers
Get closed issues checked on the site
Mark tasks done when the issue closes, with a comment asking for a check on the site.
Sync the Contoso Portal BugHerd project with contoso/portal.
Developers
Close issues the client signed off
Close GitHub issues whose task is done, with a comment explaining why.
Close the issues in fabrikam/shop whose Fabrikam Shop BugHerd task is done. Show me first.
Tech leads
Tidy up before a release
Approve a table of fixes in one go instead of closing items one at a time.
Propose status fixes between the Northwind Traders site BugHerd project and northwind/web before Friday's release.
How it works
What PopdockAI does when you ask
You name the BugHerd project and repository, and your AI assistant proposes how to bring each pair back in step. It applies only the rows you approve.
01
Ask
You name the BugHerd project and GitHub repository.
02
Find
It reads the links from both sides and keeps pairs where only one side is finished.
03
Approve
It shows every proposed change in one table and you choose which rows to apply.
04
Apply
It updates and comments on each approved row and reports anything that failed.
What PopdockAI provides
The tools behind the answer
Ready made tools for BugHerd and one secure connection to your AI tool. No code, no exports.
bugherd-get-projects
bugherd-get-tasks
bugherd-get-archived-tasks
github-get-issue
bugherd-update-task
bugherd-add-comment
github-add-issue-comment
github-update-issue
This report is built from Get data tools only. PopdockAI applies the row, field and parameter rules your admin sets, and every query is written to the audit trail.
The outcome
BugHerd and GitHub agree again
Related use cases
More ways to put this data to work
Check a BugHerd fix has shipped on GitHub
Ask your AI whether a BugHerd task is fixed and it traces the GitHub issue, fixing commits and deploy run to give a clear shipped or not yet verdict.
Learn More
Reconcile BugHerd tasks and GitHub issues
Ask your AI to reconcile BugHerd and GitHub and it lists linked tasks and issues whose open or closed state has drifted, plus any broken links.
Learn More
Send a BugHerd task to a GitHub issue
Ask your AI to send a BugHerd task to GitHub and it opens one linked issue with the page, severity and reporter after you confirm, never a duplicate.
Learn More
Check BugHerd bugs after a GitHub deploy
Ask your AI what has been reported since the last deploy and it lists new BugHerd bugs and feedback, links likely regressions to GitHub commits, and gives a verdict.
Learn More
Add an update to a BugHerd task
Ask your AI to add a note to a BugHerd task by its number, with an optional file from a link, and it posts the update only after you confirm.
Learn More
One prompt template with infinite possibilities.
Your AI assistant adapts its approach, tone, and capabilities to match each unique context while you maintain a single, manageable workflow.
Join forward-thinking companies that are transforming their operations with intelligent, secure AI automation.