Steer a run as a team
One run, many hands
A teammate starts a run; everyone in the org can read it as it works, and its starter or an org admin steers it with follow-ups or by taking control of its browser.
Best for
- Reviewing a teammate's run while it works, without a screen share
- Teams where one person starts work and an admin can step in
Uses
- A Project
- Teammates in your org
From the console
POST /o/{org}/sessions{
"harness": "codex",
"input": "Reproduce the checkout bug from ENG-51 in the browser and fix it.",
"resources": [
{
"url": "https://github.com/acme/web"
}
]
}Watch it work, then read what comes back
GET /o/{org}/sessions/{session}/eventsevent: tool_usebrowser · open localhost:3000/checkoutevent: thinkingThe coupon field clears on blur.event: messageFound it in CouponInput.tsx.GET /o/{org}/sessions/{session}- status
running- turns_count
3, two of them follow-ups
Steps
- 01
Bring the team in
Teammates join your org with its invite code. Everyone in the org sees its Projects and their runs, with who started each.
- 02
Read it as it works
Any org member opens the run and reads its transcript as the agent works.
- 03
Steer it
The run's starter or an org admin sends follow-ups (the console queues one sent mid-turn) and can take control of its browser on a five-minute lease that one person holds at a time.
In the API and the docs
Related
All use casesHand off from your terminal
A run you pick up later
Start a run from the rush CLI, close your laptop, and pick it up from the console or the CLI where it left off.
Open the recipeInvestigate an incident
A report with evidence
Hand the agent an incident and read access to its sources; it comes back with a report that cites what it found, and no code change.
Open the recipe