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

# Sessions

> Start a session, watch the sandbox, and review changes before you open a pull request.

A session is one conversation and the workspace it runs in. You start it from the [dashboard](https://app.tembo.io), an [agent](https://docs.tembo.io/features/agents.md), or a mention of `@tembo`. The agent works in an isolated [sandbox](https://docs.tembo.io/features/sandbox/overview.md).

## Start a session

Open the [dashboard](https://app.tembo.io) and click **New Session**. Pick one or more repositories, choose an [agent harness](https://docs.tembo.io/features/agents.md#agent-harness), and describe the work.

To start from a prepared environment, choose a [project](https://docs.tembo.io/features/projects.md) and one of its session sizes before you send the first message. You can change the project before the session starts, but not while it is running.

## Who can see a session

New sessions are **private** unless you change the default. A private session is visible only to the person who created it. **Visible to workspace** lets other members of the workspace open it.

Set the default in **Settings > Preferences** under **Default session visibility**. The composer also has a visibility control for the session you are about to start. Only the creator can change visibility later, from the session menu.

Private does not hide a pull request the session opens on GitHub, GitLab, or Bitbucket. It only controls who can open the session in Tembo.

## Session workspace

Open a session to watch the work. The sidebar on the right has these tabs:

| Tab | What it shows |
| - | - |
| **Changes** | The diff for this session. Review it here before you open a pull request. |
| **Pull requests** | Pull requests opened from this session. |
| **Artifacts** | Reports, previews, and other files the agent published. See [artifacts](#artifacts). |
| **Computer** | The session desktop. You can watch and control it. |
| **Files** | Files in the sandbox workspace. |
| **Terminal** | A shell in the sandbox. |
| **Logs** | Session logs. |
| **Devices** | Computers you have paired, when the agent can use them. See [Devices](https://docs.tembo.io/features/devices.md). |

If the agent uses one of your computers, Tembo can also open a **Device** tab so you can watch that screen.

## Plan before writing code

In the composer, type `/` and choose **Plan**. The agent plans the work instead of editing files. Choose **Plan** again to switch back to **Build**.

While a run is in progress, a follow-up is queued until the current run can take it.

## Fork or export

Open the session menu to:

* **Fork session**, which starts a new session from this one. If the original session is in one of your [folders](https://docs.tembo.io/features/workspace.md#folders-and-pins), the fork goes in the same folder.
* **Export session**, which downloads the transcript as Markdown or JSON. You can export prompts and replies only, add a readable line per tool call, or include full tool inputs and outputs. The full export redacts common secret formats.

## Artifacts

Artifacts are files the agent creates for you to open outside the diff, such as an HTML report, a diagram, or a CSV export. The built-in `tembo-artifact` skill creates them. Open them from the **Artifacts** tab.

## Open a pull request

Dashboard sessions wait for you. Review the diff in **Changes**, then click **Open PR**, or ask the agent to open one. After it is open, review it in [Review](https://docs.tembo.io/features/reviews.md) or mention `@tembo` on the pull request to request changes. See [Pull requests](https://docs.tembo.io/features/pull-requests.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.