Skip to content
Workloom
Menu

The wl CLI

CLI commands

The `wl` CLI binds a directory to a workspace, pulls and syncs rendered files, checks drift, publishes packages, applies home profiles and manages your organization’s API keys and webhooks. One page per command.

Generated from the CLI’s own command definitions and checked against them in CI. Every command also takes the global --registry-url <url> option, which overrides registry_url in ~/.config/workloom/config.toml. Run `wl <command> --help` for the same information in your terminal.

Account

Workspace binding

  • wl init

    Initialize workspace binding interactively.

  • wl bind

    Bind to a workspace (non-interactive)

  • wl unbind

    Remove workspace binding.

  • wl status

    Show workspace binding status.

  • wl migrate

    Migrate from .loom/ to workloom.workspace.json + .workloom/state/.

Rendering and sync

  • wl pull

    Pull workspace manifest, render provider files, and sync to disk.

  • wl validate

    Validate workspace render plans without writing files.

  • wl sync

    Render and apply workspace files using the sync engine.

Drift

  • wl diff

    Show drift between local files and expected render plan state.

  • wl restore

    Restore managed files to their expected content.

  • wl doctor

    Check workspace health: binding, state, connectivity, file integrity.

  • wl keep-local <path>

    Mark a file as user-overridden (excluded from sync and drift reporting)

Publishing

  • wl push <path>

    Push a local asset directory as a new package version.

  • wl review <package>

    Run an advisory AI review of a package version (findings never block publishing)

Home profiles

Workspace overrides

Organization

Telemetry