Skip to main content
A session is one conversation and the workspace it runs in. You start it from the dashboard, an agent, or a mention of @tembo. The agent works in an isolated sandbox.

Start a session

Open the dashboard and click New Session. Pick one or more repositories, choose an agent harness, and describe the work. To start from a prepared environment, choose a project 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: 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, 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 or mention @tembo on the pull request to request changes. See Pull requests.