awarer

Documentation / Command reference

awa restore

awa v0.3.1 · slug command-restore

On this page

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.