A session is the fastest way to build something with an agent while staying hands-on. This guide walks through starting one and working in it.
Open a new session
Click New session to open the New collaborative session dialog and fill in:
- Title — optional, e.g. “Checkout redesign”.
- Repositories — the repo(s) to work in.
- Base branch — where to start from (defaults to the repo’s default branch).
- Model — the agent model.
Choose Create session to enter the session.
Instruct the agent
Use the composer to talk to the agent. Switch between:
- Agent mode — every message is an instruction to the agent.
- Chat mode — messages are team chat; mention
@agentto instruct.
The agent works one turn at a time. Send more instructions while it’s busy and they queue (you’ll see a queued count); press Stop to interrupt the current turn.
Watch the work
Use the working views to follow along:
- Preview — your app running live.
- Diff — the changed files on the branch.
- Files — browse the sandbox filesystem.
- Resources — any provisioned resources (e.g. a database branch).
Preview your app
Open the Preview view to see the running app. If your app exposes more than one process, use the process switcher; the address bar shows the current path and you can refresh or copy the URL.
Open a pull request
When you’re happy, choose Open PR. The session shows the pull request’s status (open, draft, merged, closed) with a link to GitHub. Keep steering the agent to refine the change, then merge when it’s ready.
Tips
- Prefer to hand off a fully-specified unit of work instead of steering live? Start a task or schedule an automation.
- A session can span multiple repositories and pull requests.