Guides

Each guide solves one goal. Pick the goal that matches what you want to do.

Set up

• Add an existing repository — work in a repository you already have.
• Choose providers and models — ready one provider and pick the model agents use.
• Configure the essentials — set the values most setups change.
• Set up shell completion and your editor — complete commands with <TAB> and edit prompts with assistance.

Plan and automate

• Plan a multi-agent change — decompose large work into reviewed phases.
• Schedule recurring work — run a check on a schedule.
• Get automated code review — review each change automatically.

Daily work

• Run agents in parallel — split independent tasks across agents and follow each run.
• Review and land a change — inspect an agent's result and choose how to record it.
• Hand a result to another agent — pass context to a follow-up run.
• Reuse a prompt with macros — save instructions for later runs.
• Find and replay an old prompt — search, inspect, and rerun prompt history.

Fix problems

• Diagnose problems with sase doctor — run the read-only checks first.
• Unstick a queued agent — clear capacity waits and holds.
• Recover an interrupted agent — restart, resume, or revive a broken run.

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