awa restore

restore selected paths from an immutable state.

awa restore <state-ref> -- <path...>
awa restore [--dry-run|--apply] <state-ref> -- <path...>
awa restore [--dry-run|--apply] --all <state-ref>

Tokens after --

Tokens after -- are path filters. They are resolved relative to your current directory and normalized to the project root, and they narrow the output only — they never create a partial state.

Global options

• --root <path> — project root override
• --config <path> — config file override
• --json — emit schema-versioned JSON
• --trust-mode <mode> / --strict — cache trust level (normal|strict|fast)

Supports --json (schema-versioned output).

Flags

• --apply — perform the restore (the only mutating mode)
• --dry-run — preview explicitly; identical to the default
• --all — select all proven restorable scope instead of paths

Workflow

See awa help restore.