Skip to content

once auth

Authenticate with a configured provider

Synopsis

text
once auth [OPTIONS] <SUBCOMMAND>

Description

Stores or revokes the credentials Once uses when talking to remote cache providers (e.g. Tuist). auth login walks through a provider's OAuth or token flow and saves the result in the OS keychain; auth logout drops the stored token. The cache provider configuration itself lives in workspace once.toml.

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

Subcommands

Released under an open-source license.