Watch a pull request
Source control and worktrees
A worktree is a separate copy of your project's files so agents can work without clashing.
After the agent calls watch_pull_request, while the thread is active the server checks the pull request every two minutes and wakes the agent when a check fails or waits for a maintainer's approval, the required checks pass, someone else comments or reviews, or the branch starts to conflict.
T3 Code docs: source control
What it’s for
Letting the agent react to CI failures and review feedback on its own pull request.
T3 Code docs: source control
When to use it
After you open a pull request and want the agent to respond to checks and comments.
T3 Code docs: source control
How to use it
Ask the agent to watch, monitor, or babysit the pull request.
T3 Code docs: source control
To start or stop watching yourself, use the row menu in the Linked pull requests panel. In the thread details card, a watched pull request shows an eye; click it to stop watching.
T3 Code docs: source control
Watching ends when the pull request merges or closes, or when you press Stop on the thread. Settling the thread also ends it.
T3 Code docs: source control
Theo’s tips
In his PR skills, Theo tells agents to use T3 Code's built-in watch pull request feature instead of improvising their own polling, and to unwatch the PR first if they stop before merging.
…is again cuz my babysit PR skill was leading to OpenAI models not taking advantage of T3 Code's built-in watchers and doing stupid instead. So, I added another section here. In T3 Code, you should use the watch pull request feature. If you stop before the merge, call unwatch pull request first.
Theo ends prompts by asking the agent to implement the change, file a PR, and babysit it, so the agent handles the pull request through to the end.
What would it look like to cache that similar to how we cache on the sidebar? If it's relatively easy, I would like you to implement it and file a PR and babyset it.
What’s changed
- Agents watching pull requests can resume when checks pass before the first watch update.Updated Nov 16
- Agents can watch build validation check results on Azure DevOps pull requests.Updated Nov 14
- Watched GitHub pull requests now react when a check suite completes.Updated Nov 13
2 earlier changes
- Pull request watches can be seen and stopped in the thread details card.Updated Oct 5
- Agents can watch a PR and are woken when checks, reviews, or conflicts need them.Added Oct 3
Related settings
Unofficial notes. Not affiliated with Theo or t3.gg.