# Pull requests

**Categories:** Productivity

---

A packet lists the pull requests that ship it, so you can see whether the code is in review, merged or abandoned. Retain collects them from the build, finds them by branch or commit, and lets you add the rest. The list is on the packet's Build tab, under Pull requests, on the Mac and on iPhone. See [The Build tab](https://retainapp.ai/help/article/the-build-tab).



### How a pull request gets linked



Each row says how it was found.



* **Reported by a build.** The coding agent building the packet reported a pull request with its branch. Retain lists it as a suggestion, because a build can be on a branch that belongs to something else.
* **Found by its branch** or **found by its commit.** The Mac matched a branch the build reported, or the commit the build ended on, to a pull request on GitHub. These are exact matches, so Retain keeps them without asking.
* **Suggested by Codex.** Codex judged that a recent pull request fits the packet and gave a reason. It is a suggestion until you confirm it.
* **Added by you.** You pasted its address.

A suggestion has a dashed border and shows its reason.



### Confirm, remove or add



Choose **Confirm** on a suggestion to keep it. Choose **Remove** to take any pull request off the list. A removed pull request stays off, even if a build reports it again, until you add it yourself.



To add one, choose **Add**, paste a GitHub pull request address and choose **Link**. You can edit the list on iPhone as well as on the Mac, and on an archived packet, since a pull request often merges after the build ends.



### Find them from the Mac



On the Mac, **Find pull requests** looks for pull requests whose branch is one of the packet's builds, or that contain the commit the build ended on. Branches like main are ignored. It says how many it linked, or that it found none.



If it finds none, **Look harder with Codex** appears. Codex reads the repository's recent pull requests and the packet's proposal, and suggests up to five with a reason each. It runs read-only and cannot see your repository or the network. Confirm the right ones.



### What the states mean



* **Draft.** Open, and marked as not ready for review.
* **Open.** Open and ready for review.
* **Merged.** Merged, shown with how long ago.
* **Closed.** Closed without merging.
* **Not read yet.** No Mac has read its status. A pull request you add on iPhone starts here.

### When the status is read again



Only a Mac reads GitHub. Opening a packet's Build tab on the Mac reads the status of every pull request that is not merged yet, at most once every five minutes for each packet. A merged pull request is not read again. The status shown on iPhone is the one a Mac last read.



### What you need



Reading and finding pull requests uses the GitHub CLI, which must be installed on your Mac and signed in. If it is not, Retain says so and asks you to sign in. Only repositories on GitHub work, and finding by Codex needs Codex on your Mac. Confirming, removing and adding by address need none of this.



For packets that build on each other, see [Dependencies and stacked pull requests](https://retainapp.ai/help/article/packet-dependencies).
