DocsScreens

Pull Requests

The Pull Requests view lists a repository's open, merged and closed pull requests, and shows what each merge left behind.

Opening the view

In Graph, choose Pull Requests next to Commits and Tags. The header then switches between Summary, Open with its count, Merged and Closed, and ⌘R fetches the lists again. Click a pull request to open its panel.

Connect your account

This view needs your code host's server in Settings › Accounts. Until you add it, the view only asks you to. Your own sections also need the login that account reports. See Accounts.

Open

Open groups pull requests by whose turn it is: My turn, Review requests for you, Mine · their turn, and the rest folded under Other open PRs. Yours are those you opened, those the server's coding agent opened for you, and those you reviewed.

In your rows, NEXT names whose turn it is and the next step, such as resolving a conflict. CI tells failures new to this pull request from ones the base branch shares. LOCAL shows what the server can't know, such as an agent working in the tab where the branch is checked out. Review requests offer Hand Off Review.

The pull request panel

Selecting an open or merged pull request fetches its code as git objects only; your branches stay as they are. The panel has two tabs:

  • Change by commit draws each commit as a bar of lines removed and added, with reviews and comments between them. On your own pull request, commits also show their prompts and tokens.
  • By file heats each file where commits changed it, marks review comments, and lists files that usually change with these but were left out.

Merged

Merged covers the last 90 days. Its Lasted after merge? column checks the 7 days after each merge on this clone's base branch for lost lines, follow-up fixes and reverts. Fetch to move it forward.

Merged pull request panel

The panel opens with Merged by, Approved, Merge commit with View in Graph, Released in, Linked issues and Sessions, which is inferred from this computer's record. The Pull request timeline centers on the merge, with time before it on the left and days after it on the right, including a Lines kept row.

Visible at the merge and After the merge list what showed then and what came later, such as reverts and reopened issues. Ask an Agent to Review After Merge turns them into a task for an agent.

Summary

MY TURN NOW gathers what you need to move: Reviews to answer, To fix, Ready to merge, Review requests for you, Reverted or fixed after merge and Unresolved review threads. Click a row to open it. Other cards show where your merged pull requests spent their time and how agent-made ones lasted.

RECURRING IN REVIEWS OF YOURS lists what came up in two or more of your merged pull requests. AGENT GUIDANCE DRAFT turns it into a request for lines for your agent's instructions file, which you edit yourself. THIS REPOSITORY holds THIS WEEK, WARNINGS IN THIS REPOSITORY and LASTED AFTER MERGE · 90 DAYS.

Hand to an Agent

The terminal button at the end of a row, To Agent, and the cards in each panel open a window with text for an agent, written from that evidence. Edit it freely; Restore the Draft brings the original back. Text from the server is quoted as material, not instructions.

Copy to Clipboard (⌘↩) is the default. Its menu's Put Into an Agent Terminal lists the terminals in this repository's tabs. Whaatcher only pastes; you press Enter.

HANDED OFF lists each handoff: when, what and where. On an open pull request, Since: adds what changed afterward, such as a push. A copy doesn't mean an agent received it. This record stays on this computer.

On GitLab

On GitLab, the view becomes Merge Requests, with merge request, MR and !12 in place of pull request, PR and #12. Supported agents and hosts lists what isn't supported there.