gage scan

The gage scan command runs scanners on sessions. For background, see Scans and Scanners.

gage scan [OPTIONS] [SESSION]...
gage scan <COMMAND>

With no session selection options, the command scans sessions from the last 30 days, up to 20. Session arguments accept unique ID prefixes.

OptionDescription
-A, --agentOperate on agent sessions instead of Claude Code sessions
-p, --project <PROJECT>Limit sessions to a project, given as a directory path or a project slug as shown by gage session list
-s, --scanner <NAME>Scanner to run (repeatable)
-g, --group <NAME>Run the scanners in a group (repeatable)
-f, --file <PATH>Scanner file to run (repeatable)
-n, --limit <N>Scan the latest N sessions
-r, --sample <N>Scan N sessions selected at random
-d, --days <N>Scan sessions from past N days
-t, --todayScan sessions modified since midnight local time
-a, --allScan all sessions
--rerun <SCAN>Re-run a scan’s scanners on its sessions
--scan <SCAN>Scan a scan’s agent sessions
-i, --invalidateInvalidate the selected sessions before scanning
-y, --yesSkip confirmation prompt
-j, --jobs <N>Maximum concurrent tasks (defaults to number of CPUs)
--agent-jobs <N>Maximum concurrent agents (default 8)
--no-progressDon’t show progress
--list-scannersShow available scanners and exit

--limit combines with --days or --today to cap the sessions selected from the window. --sample draws from sessions modified in the past 30 days, or the window given with --days or --today.

--scan expands to the agent sessions the given scan’s tasks spawned and selects the eval scanner group. --limit and --sample cap the expanded list.

--invalidate clears the selected sessions’ validation state so tasks re-run for them.

scan list

List scan runs.

gage scan list [OPTIONS]
OptionDescription
-m, --moreShow more items. Repeat to show more per use.
-a, --allShow all items
-n, --limit <LIMIT>Limit the number of items shown (default: 20)

scan view

View a scan run in the scan TUI.

gage scan view [SCAN_ID]

If you omit the ID, Gage lets you pick from a list.

scan delete

Delete scan runs and their associated notes.

gage scan delete [OPTIONS] [IDS]...
OptionDescription
-y, --yesSkip confirmation prompt

scan invalidate

Invalidate task validation state. Invalidated tasks re-run on the next applicable scan.

gage scan invalidate [OPTIONS] <--session <ID>|--note <ID>|--task <NAME>>
OptionDescription
-s, --session <ID>Invalidate tasks for a session (ID or prefix, repeatable)
-n, --note <ID>Invalidate tasks for a note (ID or prefix, repeatable)
-t, --task <NAME>Invalidate tasks by name (or prefix, repeatable)
-y, --yesSkip confirmation prompt