CLI reference: sparkwing cache

CLI reference: sparkwing cache

Every sparkwing cache command, flag, and argument, generated from the CLI's own command registry. All command groups are indexed in cli-reference.md.

sparkwing cacheSection anchor link

Inspect or trim the compiled pipeline binary cache

SubcommandsSection anchor link

  • explain -- Show a pipeline's cache key and the inputs behind it
  • info -- Print cache dir, size, ceilings, and recent entries
  • prune -- Prune oldest cached binaries down to the ceilings
  • warm -- Prepare the local pipeline cache and dependencies

FlagsSection anchor link

FlagDescription
-o, --output FORMATPretty on a terminal; JSON when piped; explicit format wins. Values: pretty, json, plain.
-C, --checkout PATHResolve the project from this local checkout path.
-h, --helpShow command help without executing.
--help-allInclude uncommon flags in command help.

sparkwing cache explainSection anchor link

Show a pipeline's cache key and the inputs behind it

FlagsSection anchor link

FlagDescription
-o, --output FORMATPretty on a terminal; JSON when piped; explicit format wins. Values: pretty, json, plain.
-C, --checkout PATHResolve the project from this local checkout path.
-h, --helpShow command help without executing.
--help-allInclude uncommon flags in command help.

sparkwing cache infoSection anchor link

Print cache dir, size, ceilings, and recent entries

FlagsSection anchor link

FlagDescription
-o, --output FORMATPretty on a terminal; JSON when piped; explicit format wins. Values: pretty, json, plain.
-C, --checkout PATHResolve the project from this local checkout path.
-h, --helpShow command help without executing.
--help-allInclude uncommon flags in command help.
--all-entriesList every managed cache entry instead of the 10 most recently used.
--docsReport on the downloaded web docs cache instead of the pipeline binary cache; other flags are ignored.

sparkwing cache pruneSection anchor link

Prune oldest cached binaries down to the ceilings

FlagsSection anchor link

FlagDescription
-o, --output FORMATPretty on a terminal; JSON when piped; explicit format wins. Values: pretty, json, plain.
-C, --checkout PATHResolve the project from this local checkout path.
-h, --helpShow command help without executing.
--help-allInclude uncommon flags in command help.
--max-bytes SIZERemove least recently used entries until the binary cache is at most this size, overriding the configured ceiling; zero means no size limit.
--max-entries NRemove least recently used entries until the binary cache holds at most this many, overriding the configured ceiling; zero means no entry limit.
--all-entriesRemove every binary cache entry that is not in use, ignoring the size and entry ceilings.
--docsClear the downloaded web docs cache instead of pruning the binary cache; the size and entry flags are ignored.

sparkwing cache warmSection anchor link

Prepare the local pipeline cache and dependencies

Build Go pipelines into the local binary cache or install TypeScript dependencies. Binary cache entries stay on this machine. JSON emits one preparation receipt; plain emits the prepared path.

Go preparation uses the filtered install environment and masks compiler diagnostics. A failed build publishes no binary cache entry. Cached binaries retain the source, workspace dependencies and Go build settings that selected them.

FlagsSection anchor link

FlagDescription
-o, --output FORMATPretty on a terminal; JSON when piped; explicit format wins. Values: pretty, json, plain.
-C, --checkout PATHResolve the project from this local checkout path.
-h, --helpShow command help without executing.
--help-allInclude uncommon flags in command help.
--clear-cacheRemove every unused pipeline binary cache entry on this machine before building, so the build starts cold.