The wl CLI
CLI commands
The `wl` CLI validates, renders and syncs workspaces, checks them for drift, talks to the registry and manages your home directory. One page per command.
Commands, arguments and options come from the CLI’s own definitions (apps/cli/src/index.ts); this site checks its list against that file. Options marked required must be given.
Workspace loop
- wl init
Create a workloom.workspace.json template in the current directory.
- wl validate <file>
Validate a workspace or package JSON file against the schemas and check trust gates.
- wl render
Render workspace projections and print the render plan.
- wl sync
Apply workspace projections to disk, or check for drift with --check.
Drift
- wl status
Show the workspace’s revision, projection policy, targets and drift summary.
- wl diff
Show the file-level drift comparison.
- wl restore
Rewrite Workloom-owned files that drifted from the last sync.
Registry
- wl bind
Bind the current directory to a workspace from the registry.
- wl pull
Fetch a workspace’s desired state and package objects from the registry.
- wl push <package-file>
Push a package to the registry as a draft.
Home and profiles
- wl home install <source>
Install a profile or package into your home directory.
- wl home list
List managed home files and the profile or package that owns each.
- wl home diff
Show drift between the home manifest and the real files.
- wl home adopt <path>
Bring an existing, unmanaged home file under Workloom ownership.
- wl home uninstall <source>
Remove the home files a profile or package owns, with reference counting.
- wl profile create <name>
Create a local draft profile.json from exact-pinned package refs.
- wl profile list
List known profiles and their versions.
- wl profile show <name>
Show a profile and its pinned packages.
- wl profile publish <profile-file>
Publish a draft profile to the registry.
Sign-in and support
- wl login
Sign in with a personal access token.
- wl logout
Clear stored authentication tokens.
- wl debug-bundle
Generate a redacted debug bundle for troubleshooting.