Skip to content

once cache blob exists

Check whether a blob exists. Exits 0 on hit, 1 on miss; with --format json|toon, always exits 0 and reports present in the structured output

Synopsis

text
once cache blob exists [OPTIONS] <DIGEST>

Arguments

ArgumentRequiredDescription
<DIGEST>yesBlob digest to probe

Options

FlagValueDefaultDescription
-C, --directory<DIR>Project root. Defaults to the current directory; the cache lives under <project>/.once/. Mirrors make -C
--format<FORMAT>humanOutput format for Once's structured data (cache stats, run/exec trailers). Defaults to a human-readable rendering; pass json or toon to get machine-parseable output for scripting and for agent consumers
-v, --verbose(flag)0Increase log verbosity. Repeat for more (-v: info, -vv: debug, -vvv: trace). Overridden by RUST_LOG
-q, --quiet(flag)falseSuppress human-mode success and progress trailers. Errors and the structured envelope of --format json/toon still print. Mirrors the -q flag of common build tools
--list(flag)falsePrint the command surface at the current command depth

Released under an open-source license.