Skip to content

Get started

The first run

The first time you open SBT it asks three things.

  1. Set up this Mac. SBT checks for the sbt command, Apple's command line tools and Pi, the agent it runs. Set it up adds what is missing. If everything is there, this step is skipped.
  2. Open your first workspace. Choose a folder, usually a project's Git repository. SBT suggests a task prefix (three letters or digits, so WEB makes tasks WEB-1, WEB-2) and the stages a task moves through. New tasks start in the first stage. Change either now or later.
  3. Connect the AI you already use. Pick a provider and sign in, or paste an API key. Test checks a key works.

SBT writes nothing into your repository during setup. A short tour then points out each part of the window. Skip it if you like; Settings › General plays it again.

Your first task

  1. Go to Tasks and press New task, or press t then n.
  2. Type a title, such as "Fix the login timeout", and press Enter.
  3. Open the task and say what done looks like. Add each check to its Definition of Done.

Hand it to an agent

Select the task and press a. An agent starts on it beside the list. It reads the task, claims it so you can see who is on it, and writes its progress back to the task as it goes.

Or type what you want in the composer at the bottom of any page, such as "the export button does nothing on Safari", and press ⌘↵. SBT files a task from your words and starts an agent on it.

When it needs you

An agent with a question or a result to review puts it in the Inbox. Answer there, read what it did, and move the task to Done when you are satisfied.

Next