The wl CLI
CLI commands
The `wl` CLI binds a directory to a workspace, renders it, checks it for drift, publishes and signs packages, and manages telemetry. 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 drift or general failure, 2 authentication, 3 network, 4 conflict or local modification, 5 trust-gate or projection-policy violation.
Project setup
- wl init
Create a workspace binding in the current directory.
- wl bind <manifest>
Bind a directory to a workspace manifest.
- wl validate
Validate manifests against their schemas and report trust-gate diagnostics.
Rendering
- wl pull
Render workspace packages into the local directory.
- wl compose
Add or remove packages in a home workspace and re-plan, without writing files.
- wl restore
Restore Workloom-owned files from installed package content.
Drift and CI
- wl status
Show tracked files, their ownership and the installed packages.
- wl diff
Show file-level diffs between current files and installed package content.
- wl sync
Check workspace drift state. CI-safe: it never writes.
- wl watch
Watch a workspace for file drift as it happens.
- wl ci setup
Generate GitHub Actions workflow files for Workloom CI.
- wl ci status
Check which Workloom CI workflows are installed.
Publishing
- wl push
Push a package version to the registry as a draft.
- wl publish
Promote a draft version to pending review.
- wl rollback
Roll a workspace back to a previous revision.
Signing
- wl signing keygen
Generate an Ed25519 signing key pair.
- wl signing register
Register a public signing key with the registry.
- wl signing verify <package>
Verify a package signature.
Authentication
- wl auth login
Sign in with the OAuth 2.0 Device Authorization Grant.
- wl auth logout
Remove stored credentials.
- wl auth status
Show the current authentication state.
Telemetry and diagnostics
- wl doctor
Check environment health.
- wl telemetry status
Show the current telemetry configuration.
- wl telemetry test
Send a test telemetry event.
- wl telemetry opt-out
Turn telemetry off on this machine.
- wl telemetry opt-in
Turn telemetry back on.
- wl telemetry set-org-salt <salt>
Set an org-scoped salt so anonymous IDs match across team machines.
Administration
- wl admin aggregate
Compute telemetry rollups for a time range.
- wl admin retention-cleanup
Delete telemetry events older than the retention period.