---
title: "Start a live session"
description: "Open a collaborative session, steer an agent turn by turn, preview the result, and open a pull request."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.trevize.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Start a live session

A [session](/concepts/sessions) is the fastest way to build something with an
agent while staying hands-on. This guide walks through starting one and working
in it.

> **Before you start**
>
> You'll need a connected GitHub repository and Claude Code set up. If you haven't
> done that yet, follow the [Quickstart](/get-started/quickstart).

1. **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.

2. **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 **`@agent`** to 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.

3. **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).

4. **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.

5. **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](/concepts/tasks) or schedule an
  [automation](/concepts/automations).
- A session can span multiple repositories and pull requests.

Source: https://docs.trevize.dev/guides/live-session/index.mdx