The wl CLI
CLI commands
The `wl` CLI binds a directory to a workspace, renders it, checks it for drift, publishes packages and manages home stacks. One page per command.
Generated from the CLI’s own command definitions and checked against them in CI. Run `wl <command> --help` for the same information in your terminal. Exit codes: 0 success, 1 validation or manifest error, 2 not authenticated, 3 runtime error, 4 conflict or locally modified state, 5 policy or trust violation.
Project setup
- wl init
Initialize a Workloom project in the current directory.
- wl bind [workspace-path]
Bind this directory to a workspace, from a local manifest or the registry.
- wl validate <path>
Validate a workspace or package manifest.
Rendering
- wl pull
Render the bound workspace’s packages into provider files.
- wl status
Show workspace info and each file’s ownership state.
- wl diff
Show diffs between current files and their installed versions.
- wl restore
Return Workloom-owned files to their installed version.
Drift and CI
- wl sync
Reconcile or check the workspace against its desired state.
- wl rollback
Roll the workspace back to an earlier revision.
Authoring
- wl push
Upload a package version to the registry as a draft.
- wl publish <ref>
Move a draft package version to pending_review.
- wl review [ref]
Advisory AI analysis of a package version or a local package directory.
Home workspaces
- wl home bind <workspaceId>
Bind a home workspace on this machine.
- wl home pull <workspaceId>
Render a home workspace into its provider home roots.
- wl home status <workspaceId>
Show owned, untracked and stale files for a home workspace.
- wl home sync <workspaceId>
Reconcile a home workspace by pulling its owned regions again.
- wl home install <slug>
Install a home stack by its slug: resolve, bind and pull in one step.
- wl home list
List available and installed home stacks.
- wl home remove <slug>
Remove an installed home stack.
- wl home verify [slug]
Check installed home stacks for drift; non-zero exit gates CI.
Authentication
- wl auth login
Authenticate with the OIDC device authorization flow.
- wl auth logout
Clear the stored authentication token.
- wl auth status
Show the current authentication state.
Telemetry and diagnostics
- wl telemetry status
Show whether telemetry is on and where it is sent.
- wl telemetry test
Send a test telemetry event.
- wl telemetry opt-out
Turn telemetry off for this project.
- wl debug-bundle
Generate a redacted debug bundle for troubleshooting.