All docs
Docs/Columns/15

GitHub

Your pull requests, issues and repositories on GitHub: act on them, and check them out on your runners for agents.

Linking GitHub

Add a GitHub column from Start. The first time, Link GitHub App signs you in with GitHub, and installing ORVEN's GitHub App on your accounts chooses which repositories the column can reach. It reads and writes code, pull requests, issues and workflows, and reads checks and statuses. The column's settings add an account, change one on GitHub, or Unlink.

The lists

Pull requests lists those waiting for Your review, Yours, or All. Issues lists those Assigned to you, Created by you, Mentioned, or All open. Repositories lists all of them, or those Checked out on a runner. Filter narrows any list. Click a row for more: its checks, reviews and what's in it. What changes on GitHub shows as it happens.

Acting on them

More, on a pull request, has Approve, Request changes, Comment, Merge (squash, a merge commit or rebase), Open on GitHub, Copy branch name and Close pull request. On an issue: Comment, Assign to me, Open on GitHub and Close issue.

Checking out

Check out on a runner picks a runner, a folder and a branch: the column clones the repository there, or adds a worktree beside a clone it already has. Start on a branch does the same for an issue, on a new branch. In a checkout, git fetches and pushes without a key of yours. A row shows where it's checked out; from there, open an agent, a terminal or an editor in it.

Agents on a pull request or issue

Agent, on a row, opens an agent in its checkout with a prompt filled in from the pull request or issue, and checks it out first if it isn't yet. The prompts are yours to edit in the column's settings, where {url}, {title}, {number}, {body}, {branch}, {base} and {repo} are filled in. Agents working in a checkout show on its rows.

Close the other windows.

Get ORVEN