Skip to content

CLI reference

Reference for the outfitting-manager command-line interface.

Updated View as Markdown

outfitting-manager prepares machine state, validates configuration, reconciles declared packages, manages platform packages, and synchronizes machine state. Commands available depend on the platform build.

Global options

Option Description
--config <path> Select a configuration file instead of the default. Equivalent to OUTFITTING_CONFIG; may appear before or after the command and may be specified once.
--help, -h Display help for the command.
--version, -v Display the manager version.
--wizard Start wizard mode for the selected command.
--completions <shell> Print completions for bash, zsh, fish, or sh.
--log-level <level> Set the minimum log level: all, trace, debug, info, warn, warning, error, fatal, or none.

Commands

Command Availability Description
init All platforms Prepare local state and validate the configured source.
apply All platforms Reconcile declared platform packages.
validate All platforms Validate configuration and selected source declarations.
config All platforms Set up, generate, or migrate machine configuration.
source All platforms Inspect the resolved source path.
status All platforms Inspect effective local configuration and source state.
diff All platforms Compare live package state with declarations.
update All platforms Upgrade installed native packages through one package manager.
nix macOS, Linux Build, test, dry-run, or activate the configured Nix profile.
sync All platforms Push, pull, and inspect remote lock snapshots.
fonts All platforms Manage the private font archive and its inventory.
provision All platforms Deploy the Outfitting infrastructure stack.
self-update All platforms Replace the manager binary with the latest release.
snapshot macOS Capture observed Homebrew inventory.
recover macOS Resume an interrupted Nix operation.
winget Windows Install or remove tracked WinGet packages.
scoop Windows Install or remove tracked Scoop packages.
Navigation

Type to search…

↑↓ navigate↵ selectEsc close