sase doctor¶
Run read-only SASE diagnostics for support
Reference for sase doctor. Run sase doctor --help for the exact output on this checkout.
usage: sase doctor [-h] [-C ID_OR_GROUP] [-D] [-F] [-R] [-j] [-L] [-p PROJECT]
[-s] [-v] [-y]
Run fast, read-only diagnostics for the active SASE runtime, configuration, and project checkout. Default mode is bounded and safe to run before asking for help.
Options:
| Option | Description | Default |
|---|---|---|
-C ID_OR_GROUP, --check ID_OR_GROUP |
Run only a check id or group; repeatable | — |
-D, --deep |
Include slower read-only deep checks | false |
-F, --fix-duplicate-blocks |
Preview and, after confirmation, keep one block per Patch name in every ProjectSpec | false |
-R, --fix-primary-sidecar-links |
Preview and, after confirmation, restore stranded link-index deletions in primary-nested sidecar clones | false |
-h, --help |
show this help message and exit | — |
-j, --json |
Emit a machine-readable JSON support report | false |
-L, --list-checks |
List registered diagnostic checks without running them | false |
-p PROJECT, --project PROJECT |
Project name to inspect when it cannot be inferred | — |
-s, --strict |
Exit non-zero when warnings are present | false |
-v, --verbose |
Show every check and bounded detail | false |
-y, --yes |
Apply requested repairs without an interactive confirmation | false |
Related: CLI command groups.
_[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.