--- title: Pull requests and CI description: Follow the Session's pull requests, and have the agent come back on its own when CI finishes or the pull request changes. --- Polaris collects the pull requests a Session works on and shows their live status, checks and reviews. The agent can wait for CI, or you can turn on **Watch PR**, and the agent comes back on its own when checks finish or the pull request changes. The Machine can sleep in the meantime. ![The linked pull request with Watch PR turned on.](/docs/screenshots/artifacts-watch-pr.webp) ## Find your Session's pull requests The Session's [Artifacts](/docs/artifacts) tab lists pull requests it opened, merged, reviewed, commented on, closed, reopened or linked. It includes pull requests its subagents worked on. Reading or mentioning a pull request puts it under **Mentioned**; choose **Add to list** to keep it with the Session's work. Open and draft pull requests appear first, with those needing attention at the top. Expand **Merged & closed** to see completed work. The summary counts each status; **Status unavailable** keeps a pull request visible when Polaris cannot read its current status. The pull request linked to the Session says **Linked** and has the **Watch PR** switch. Each row shows checks, review status and mergeability separately. **Checked** says when Polaris last looked. The list stays available while the Machine sleeps. Choose **Remove from list** to hide a pull request without closing it on GitHub. Removing the linked pull request also unlinks it and stops watching. **Undo** adds it back; watching stays off until you turn it on again. New activity on a removed pull request does not add it back automatically. A link to a GitHub pull request in the transcript shows the pull request's state. Hover over the link, or move focus to it with the keyboard, to preview the pull request's title, author, age and size. The preview shows only pull requests your GitHub account can see. To link a different pull request, choose **Link to this Session** on its row; **Unlink from this Session** removes the link and keeps the pull request in the list. Only the Session's owner can change it. You can also have the agent change the link. If your Machine doesn't support that, use the row's controls. Linking a pull request doesn't start a [CI notification](#wait-for-ci). ## References in the transcript A pull request in the Session's list also appears as a link when the transcript names it as `#2705` or `owner/repo#2705`. If more than one listed pull request has the same number, the shorter reference stays text; the full repository name identifies it. ## Wait for CI The agent can arrange a CI notification after pushing a pull request, then finish its Turn so the Machine can sleep. Polaris sends the result to the same Session, and the agent continues on its own. If the agent is busy, the result waits until it can continue. A subagent can arrange one for itself too; its result also waits while the limit for running subagents is reached. CI follow-ups count toward the [agent step limit](/docs/subagents#if-a-subagent-doesnt-finish); at the limit, results wait until you send a message. Each notification covers the checks observed for one commit. A new push needs a new notification. After an hour, Polaris stops waiting for checks and prepares the result it could observe, even if checks are still running or their result is unknown. That notification doesn't report later results. Delivery can wait until the agent is ready or you send a message to release the step limit. A CI result doesn't authorize a merge. ## Watch your pull request Turn on **Watch PR** on the linked pull request in **Artifacts** to bring the agent back when checks fail or all pass for its current commit, new review comments arrive, base-branch changes cause a merge conflict, or it is merged or closed. Watch PR is off by default. Only the Session's owner can change it. The agent can also turn it on when you ask it to land or babysit the pull request; watching doesn't authorize a merge. When you turn it on, Polaris checks the current state. Checks that already failed or passed, or an existing conflict, bring the agent back once. Pending or unknown checks don't. An already merged or closed PR sends one final follow-up and turns Watch PR off. Earlier review comments are not replayed. Changes waiting together arrive as one follow-up. If the agent is busy, the follow-up waits. PR follow-ups count toward the [agent step limit](/docs/subagents#if-a-subagent-doesnt-finish); at the limit, they wait until you send a message. A subagent's follow-ups also wait while the limit for running subagents is reached. A sleeping Machine can wake for the follow-up. Turn **Watch PR** off to stop future follow-ups. **Stop**, archiving the Session, unlinking its pull request, or linking a different one also turns it off and cancels waiting PR follow-ups. ## Read a CI result or PR update A CI result or a Watch PR follow-up shows in the transcript as one row from Polaris, not as a message from you. Polaris sends it to the agent, and the agent continues on its own. - **A CI result** says how CI ended on the pull request, such as **CI failed on web#3048 · 2 failing checks**, **CI passed on web#3048** or **CI still running on web#3048 · stopped waiting after an hour**. Select the row to see the failing checks with links to each check's details, the commit, **Open on GitHub** for the pull request, and why it came: "The agent asked Polaris to tell it when CI finished on this commit." - **A Watch PR follow-up** says what changed, such as **Watch PR update on web#3048 · Checks failed · 2 new comments**. Select the row to see each change, a **New comment** link for each new comment, and **Open on GitHub**. Past 100 changes, the oldest new comments show only as a count, such as **3 more comments**. ## If it doesn't work If your Session stays unable to receive a PR or CI follow-up for an hour, Polaris ends that watch. **Watch PR** turns off; you can turn it on again. Time waiting for the agent step limit or running-subagent limit does not count. - **stopped waiting after an hour** on a CI result: checks were still running, or Polaris couldn't get a CI result. That CI notification won't report later results. Ask the agent to check CI again. - **Couldn't refresh** on the linked pull request: Polaris can't show its status right now. **Checked** still shows when it last looked.