Pull Requests & Issues

Terminay lists the pull requests waiting for your review and the issues assigned to you, across every GitHub and Gitea account it can reach. From an item you can open its worktree, check it out in a new one, hand it to an agent, or start work on an issue, without leaving for a browser.

Terminay Home Pull Requests section with pull requests grouped by repository and one pull request's detail open beside the list

Accounts

The bundled GitHub and Gitea extensions supply the lists. They find your accounts from the gh and tea CLI logins on the server, and you can sign in with more under the server's Extensions → GitHub or Gitea in Settings. Gitea covers Forgejo too.

The same page chooses which Repositories to list: Everything I can access, Repositories of open projects, or Chosen owners. Switches turn Pull Requests on Home, Issues on Home, and the Project Git tab on or off. Terminay only reads from the forge; it never changes a pull request or issue.

On Home

Home gains a Pull Requests and an Issues section, after Recordings, while an account provides them. Each lists items from every account, newest activity first, grouped under the forge and owner/repo of their repository.

  • Scope chips: Needs my review, Mine, Involved, and All for pull requests; Assigned to me, Created by me, Mentioned, and All for issues. Each shows its count.
  • State: Open, Merged, or All for pull requests; Open, Closed, or All for issues.
  • Group: by Repo, or None.
  • Account: with two or more accounts, narrow the list to one of them, or All accounts.

Each row shows the item's state, title, number, author, checks, labels, and when it was last updated, and a worktree chip when its branch is already checked out in an open project. Your choices are remembered on this device. Lists refresh when you show them and when you choose Refresh, never on a timer.

The Detail Pane

Click a row to show the item beside the list: its state, repository, labels, author, and description. A pull request adds its branches, its checks with failures first, and the worktree its branch is checked out in. An issue adds its most recent comments. Drag the pane's left edge to resize it, or focus the edge and use the arrow keys; the width is remembered on this device. In a narrow window the pane sits under the list.

To keep an item open while you look at another, double-click its row or choose Open in tab. It opens as a Home tab of its own, with the same detail and actions. Opening an item that is already open brings its tab forward.

Working On A Pull Request

The pull request detail offers:

  • Open worktree: when its branch is already checked out in a worktree of an open project, select that project and worktree folder.
  • Check out in new worktree: when the repository is open as a project, create a worktree tracking the pull request's branch and select it.
  • Review with agent: open a terminal in that worktree, creating it first if needed, and start the agent you choose with an editable review prompt naming the pull request.
  • Open it on the forge.

An action that is not available is shown disabled with the reason, such as the repository not being open as a project, or the pull request coming from a fork. See Worktrees for what the new worktree folder shows.

Starting Work From An Issue

When the issue's repository is open as a project, the issue detail ends in Start work. It shows a branch name built from the issue number and title, which you can edit, and where the worktree will go. Choose an agent, with an editable prompt that names the issue and quotes the start of its description, or Shell only.

Confirm to create a worktree on a new branch from the repository's default branch and open a terminal there running your choice. If the branch already exists, Start work says so and offers to use it. If something fails, the reason is shown and the panel stays open to try again.

In A Project

A Terminay project's Git tab in the left column with Issues and Pull Requests panes

When a GitHub or Gitea account covers a project's repository, the project's left column gains a Git tab beside Tabs and Agents. It holds two panes, Issues and Pull Requests, for that repository. Collapse, reorder, and resize them as you do the sidebar's other panes. The Pull Requests pane lists the selected worktree's pull request under This worktree first, then Open, then up to five Recently merged.

Click a row to open Home's section filtered to that repository with the item selected, or Show all on Home for the whole repository. Double-click a row to open the item as a tab in the selected folder, beside the terminals working on it.

When A List Is Empty

An empty list says why: nothing matches the scope, no account is set up (with a link to Settings → Extensions), or a source failed, with Retry. When one account fails, the others' items still show. When an account filter leaves nothing, Show all accounts clears it.