Skip to content
Workloom
Menu

CLI command · Workspace loop

wl sync

Apply workspace projections to disk, or check for drift with --check.

Sync writes the projections the trust gate allows, atomically, changes only files Workloom owns and records each written file in the drift baseline.

Committed projections need a local approval: --approve-local records one in the approval ledger, keyed to the file’s content. With --check the command writes nothing, prints the drift summary and exits non-zero on drift, which is what CI runs.

Usage

wl sync [options]

Arguments and options

-w, --workspace <file>
Required. Path to the workspace JSON file.
--check
CI-safe read-only drift check (never writes files).
--approve-local
Locally approve committed projections for writing.
--fixtures <dir>
Local package directory to resolve packages from. Default: fixtures.