CLI Reference

Every Nimbus subcommand and its flags.

nimbus init

Creates nimbus.config.json, .nimbusignore, and data/ in the current directory.

FlagDescription
--targetSet the target URI during init.
--forceOverwrite an existing config.

nimbus sync

Runs a single sync and exits.

FlagDescription
--dry-runLog actions without transferring files.
--workspacePath to the workspace (default: cwd).

nimbus watch

Runs in the foreground and syncs automatically on file changes. Accepts the same flags as sync, plus --verbose for per-file logging.

nimbus config <get|set|validate>

Reads, writes, or validates keys in nimbus.config.json.

nimbus config get concurrency
nimbus config set concurrency 8
nimbus config validate

nimbus auth create-token

Generates a scoped, short-lived credential for CI. See Authentication.

FlagDescription
--targetBucket/prefix the token is scoped to.
--ttlToken lifetime, e.g. 1h, 30m.

nimbus resolve

Lists and resolves conflicts when conflictStrategy is manual. See Sync Strategies.