Skip to content

sase footprint

Show the local usage census of sase surfaces.

Reference for sase footprint. Run sase footprint --help for the exact output on this checkout.

usage: sase footprint [-h] {catalog} ...

Footprint keeps an always-on, privacy-by-construction census of which sase surfaces (CLI commands and options, TUI actions and keys, views and modals, macros, skills, config leaves, automation) are used, and joins it with a generated feature catalog. Bare sase footprint shows this help.

Options:

Option Description Default
-h, --help show this help message and exit —

Subcommands:

Subcommand Summary
sase footprint catalog List the generated feature catalog

sase footprint catalog

usage: sase footprint catalog [-h] [-A AREA] [-f {rich,json,markdown}] [-n NS]

List the generated Footprint feature catalog: every allowlisted feature ID sase knows, grouped by area. The file lives at src/sase/footprint/catalog.jsonl and is regenerated by just fix.

Options:

Option Description Default
-A AREA, --area AREA Show only one area (for example cli.bead) —
-f FORMAT, --format FORMAT Output format (default: rich) (choices: json, markdown, rich) rich
-h, --help show this help message and exit —
-n NS, --namespace NS Show only one namespace (for example cli) (choices: auto, cli, config, macro, plugin, skill, tui, view) —

Related: CLI command groups.