Install and set up SASE

This tutorial installs SASE and prepares one authenticated provider for your first run.

Before you start

You need Linux or macOS, Python 3.12 or newer, uv, and Git.

1. Install SASE

Install the SASE command-line tool:

uv tool install "sase>=0.18"

The version floor makes the install fail if the required release is not available.

2. Confirm the installation

Print the installed SASE and core versions:

sase version

The command prints version information for SASE and its core extension.

3. Check your provider

Install and authenticate one supported agent CLI, then check that SASE can use it:

sase doctor

If the doctor reports a missing provider or authentication problem, follow the setup steps in Installing and authenticating agent providers, then run the check again.

4. Add shell completion (optional)

If you want tab completion in your shell, run:

sase completion install

You have SASE ready for a first run

You have installed SASE and checked that it can find an authenticated provider.

Next

• Run your first agent
• Shell completion

_[project]: A sase project is a named unit of work registered with SASE. _[workspace]: A sase workspace is a numbered clone of a project's primary repo, managed by the workspace store and tracked in that project's registry.json. _[agent]: A sase agent is an agent session or a single agent that does not belong to a session. _[prompt]: A prompt is the text SASE hands to a provider to start an agent turn. _[macro]: A macro is a reusable prompt triggered with #name in agent prompts. _[Patch]: A Patch is SASE's local unit of change. _[bead]: A bead is one tracked work item in SASE's git-native issue tracker. _[plan]: A plan is a persisted, approved artifact recording the intent behind agent work. _[TUI]: The TUI is SASE's terminal interface for running agents and reviewing results. _[epic]: An epic is an executable multi-phase plan run with sase bead work. _[gate]: A sase gate is a durable, command-backed request for one user decision, created when work must pause for the user. _[monitor]: A sase monitor is a monitor turn that runs one long command under a detached supervisor, so the command outlives the agent that started it. *[stitch]: A stitch is the lightweight ordered change record inside a Patch's STITCHES: section.