awarer

awa gc

awa v0.3.1 · slug command-gc

On this page

garbage-collect unreferenced state.

awa gc [--dry-run] [--committed] [--keep-last <n>] [--older-than <dur>]
awa gc [--runs-only|--checkpoints-only|--blobs-only]

Tokens after --

A token after -- is a usage error: this command takes no operands.

Global options

  • --root <path> — project root override
  • --config <path> — config file override
  • --json — emit schema-versioned JSON

Supports --json (schema-versioned output).

Flags

  • --dry-run — show the plan without deleting anything
  • --committed — also reclaim state made redundant by git commits
  • --keep-last <n> — retain the most recent <n> checkpoints (default: policy default)
  • --older-than <dur> — only reclaim entries older than <dur> (e.g. 720h)
  • --runs-only — restrict collection to the run cache
  • --checkpoints-only — restrict collection to checkpoints
  • --blobs-only — restrict collection to the blob store

Workflow

See awa help gc.