GitHub

Preview

Repository, issue, pull request and workflow operations.

The GitHub connector supports the full engineering loop: read the repository, make a change, prove it, open a pull request with evidence attached.

Operations#

OperationScopeEffect class
github.repo.readrepo:readread_external
github.search.coderepo:readread_external
github.issue.list / readissues:readread_external
github.issue.create / commentissues:writeexternal_write
github.branch.createrepo:writeexternal_write
github.commit.pushrepo:writeexternal_write
github.pr.open / reviewpr:writeexternal_write
github.actions.readactions:readread_external

Pull request conventions#

  • The description states the problem, the cause, the change and the evidence — in that order.
  • Execution and test output is linked as an artifact, not pasted as a claim.
  • Scope deliberately left out of the change is listed explicitly.
  • Branches are created from the current default branch head and never force-pushed.
ts
await pimsy.tasks.create({
  projectId: class="tok-str">"prj_checkout",
  objective: class="tok-str">"Triage issues labelled 'needs-repro', reproduce each one, and comment with findings.",
  capabilities: [class="tok-str">"connector.github", class="tok-str">"code.execute", class="tok-str">"files.read"],
  approvals: { required: [class="tok-str">"github.issue.comment"], mode: class="tok-str">"batch" }
});

Last updated 2026-09-07