Skip to content

Get started with SASE

These pages take you from installing SASE to running and reviewing work in its demo workspace.

Is SASE for you?

SASE coordinates coding-agent work through a command-line tool and terminal interface. It is alpha software, so its interfaces and workflows are still evolving. SASE is for people who want to supervise agents working in separate Git workspaces; it does not replace the coding-agent CLI you use.

You need Linux or macOS, Python 3.12 or newer, uv, Git, and one supported agent CLI that is installed and authenticated. The first lesson includes links for provider setup.

Start with these lessons

  • Install and set up SASE — install the command-line tool and check your provider, about 5 minutes plus provider setup if needed.
  • Run your first agent — launch a read-only request in the demo workspace and inspect the result, about 5 minutes plus model time.
  • Make and review a change — ask an agent to make one small edit and inspect the resulting diff, about 5 minutes plus model time.

Next

_[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.