GitHub issues to pull requests
In this guide, adding the label jimothy to a GitHub issue starts a run of the Bug fix (fast lane) pipeline: the Claude API triages the bug, Claude Code writes a failing regression test and fixes it, your tests run (looping back to the fix on failure), and a pull request opens automatically with Closes #<number> so merging it closes the issue. Jimothy labels the issue jimothy:done or jimothy:failed.
Prerequisites
Section titled “Prerequisites”- Claude Code installed and signed in; an Anthropic API key for the Claude API triage step (or switch that step to Claude Code).
- A local clone of the repository, and
ghsigned in with push access (see Linear guide → step 2).
1. Create a GitHub token and sign in
Section titled “1. Create a GitHub token and sign in”- Open
https://github.com/settings/personal-access-tokens/new. - Repository access → Only select repositories → your repository.
- Repository permissions → Issues: Read and write.
- Generate and copy the token.
- In Jimothy: Settings → Accounts & integrations, Sign in under GitHub, paste it into Token, Sign in.
This token is used only to read issues and write comments and labels. Opening the PR uses gh’s own credentials.
2. Set up the pipeline
Section titled “2. Set up the pipeline”-
Click the + on your project in the sidebar (or New pipeline in the ⌘K palette) and choose Bug fix (fast lane).
-
Pipeline settings → Workspace (or the project’s Settings tab, if the pipeline uses the project’s workspace): Git worktree, Local repository = your clone, Base branch
main. The branch template isfix/{{issue.key | slug}}, so issueweb-app#42gets branchfix/web-app-42. -
Variables: set
testCommand. -
The Triage step uses Claude API with
claude-opus-5. Add your key in Settings → Harnesses → Claude API → Configure → API key (or setANTHROPIC_API_KEY), or switch the step’s harness to Claude Code. -
Select Open pull request and change the command so the PR closes the issue:
Terminal window git push -u origin HEAD && gh pr create --base {{run.baseBranch}} --head {{run.branch}} --title "$FACTORY_ISSUE_TITLE" --body "Closes #{{issue.raw.number | raw}}. Automated by Jimothy run #$FACTORY_RUN_NUMBER."| rawinserts the issue number without shell quoting, which is safe because it’s always a number. Without it the body would contain literal quote characters (Closes #'42'). -
Save.
3. Add the GitHub trigger
Section titled “3. Add the GitHub trigger”-
Open the project’s Triggers tab (or All triggers in the ⌘K palette), click Add trigger and choose GitHub Issues.
-
Runs pipeline: Bug fix (fast lane). GitHub account: from step 1.
-
Owner
acme, Repositoryweb-app. -
Labels (all of):
jimothy(addbugtoo if both should be required). -
Assignee: empty (or a login to only pick up issues assigned to someone).
-
Write back to the issue:
- Run starts: Post a status comment on, Move to
jimothy:running - Succeeds: Post a status comment on, Move to
jimothy:done - Fails: Post a status comment on, Move to
jimothy:failed
On GitHub, Move to lists
closed/open(which change the state) and the repository’s labels (which are added). Create thejimothy:running,jimothy:doneandjimothy:failedlabels in the repository first so they appear in the list. - Run starts: Post a status comment on, Move to
-
Preview matching issues, then Save trigger.
4. Run it
Section titled “4. Run it”Add the jimothy label to an open issue. On the next poll (or Check now), a run starts and the issue gets a comment and the jimothy:running label. When the run finishes, the issue gets the run summary with the PR link, and jimothy:done.
Labels are only added, never removed, so a finished issue carries both jimothy:running and jimothy:done. Dedup keeps it from running again even though it still has jimothy. To run it again, Forget it in the trigger’s Processed issues (the eraser button), or set a processed label on the trigger and remove it from the issue.
Optional: instant starts
Section titled “Optional: instant starts”Add a repository webhook so runs start seconds after labelling:
- Enable Settings → Accounts & integrations → Webhook server and start a tunnel, e.g.
ngrok http 7717. - In the trigger editor, set a Webhook secret and copy the URL from Instant webhook; replace
http://127.0.0.1:7717with your tunnel URL. - Repository Settings → Webhooks → Add webhook: that URL, content type
application/json, the same secret, event Issues.
For webhook events, labels match if any listed label is present, so keep a single hand-off label. See GitHub → Webhooks.
Variations
Section titled “Variations”- Features instead of bugs: use the Feature: Plan → Build → Review → PR template with a
featurelabel, and a second trigger for bugs. - Cross-repo: one GitHub account can feed triggers on many repositories; each trigger points at one repository and one pipeline (whose workspace must be a clone of that repository).
- Issue forms: GitHub issue forms produce Markdown sections in the body. They arrive intact in
{{issue.description}}.