Skip to content
Workloom
Menu

CLI command · Workspaces and sync

wl sync

Apply the render plan: write approved, Workloom-owned files. Alias: wl apply.

Runs the trust gate and any required local approval, writes the planned projections, applies settings effects and updates the ownership baseline. With --check it writes nothing and reports drift, which is how CI runs it.

Usage

wl sync [options]

Arguments and options

--workspace <path>
Required. Path to the workspace manifest.
--check
Check only (a dry run, like dotfiles managers).
--approve-local
Record an eligible local approval.
--interactive-approval
Prompt for an eligible local approval.
--adopt
Back up and take ownership of pre-existing files Workloom does not own.
--report
Report the drift result to the registry (drift.detected or drift.cleared) (with --check).
--registry-url <url>
Hosted registry API URL (required with --report).
--token <token>
Registry API bearer token. Default: $WORKLOOM_TOKEN, then the stored token.