# Command-line Reference

Every subcommand the `once` binary exposes, with its synopsis, options, and arguments. Use the sidebar to jump to a specific command.

## Commands

- [`once auth`](/reference/cli/auth): Authenticate with a configured provider.
- [`once bazel`](/reference/cli/bazel): Accept a Bazel build or test invocation and use the Once graph when its semantics are supported. Other invocations pass through to the system Bazel executable unchanged. Configure this as a mise command wrapper to make ordinary `bazel` commands use this compatibility surface.
- [`once build`](/reference/cli/build): Build a declared target.
- [`once cache`](/reference/cli/cache): Cache management.
- [`once cargo`](/reference/cli/cargo): Accept a Cargo build or test invocation and use the Once graph when its semantics are supported. Other invocations pass through to the system Cargo executable unchanged. Configure this as a mise command wrapper to make ordinary `cargo` commands use this compatibility surface.
- [`once edit`](/reference/cli/edit): Mutate workspace manifests.
- [`once exec`](/reference/cli/exec): Execute a literal action through the cache.
- [`once lint`](/reference/cli/lint): Run static analysis for a declared target.
- [`once mcp`](/reference/cli/mcp): Expose Once's graph and memory queries to a coding agent.
- [`once query`](/reference/cli/query): Query the typed build graph
- [`once run`](/reference/cli/run): Run a declared target.
- [`once runtime`](/reference/cli/runtime): Runtime session inspection and control.
- [`once swift`](/reference/cli/swift): Accept a Swift Package Manager build or test invocation and use the Once graph when its semantics are supported. Other invocations pass through to the system Swift executable unchanged. Configure this as a mise command wrapper to make ordinary `swift` commands use this compatibility surface.
- [`once test`](/reference/cli/test): Test a declared target.
- [`once toolchain`](/reference/cli/toolchain): Inspect the project toolchain contract.
- [`once xcodebuild`](/reference/cli/xcodebuild): Accept an Xcode build invocation and use the Once graph when its semantics are supported. Other invocations pass through to the system Xcode build tool unchanged. Configure this as a mise command wrapper to make ordinary `xcodebuild` commands use this compatibility surface.
