Command Reference

Auth commands

wl login

Initiates device authorization flow. Prints a user code and verification URL, then polls until the user approves.

wl login

In dev mode, approval is automatic.

wl logout

Clears stored credentials.

wl logout

wl whoami

Prints the current authenticated identity.

wl whoami
# user-dev-001 (dev mode)

Workspace commands

wl init

Interactive workspace initialization. Creates .loom/binding.toml.

wl init
# ? Workspace ID: acme/platform-api
# ? Registry URL: http://localhost:3001
# Created .loom/binding.toml

wl bind

Non-interactive workspace binding.

wl bind --workspace acme/platform-api

wl unbind

Removes the workspace binding after confirmation.

wl unbind
# ? Remove binding for workspace acme/platform-api? (y/N)

wl status

Shows workspace state, installed packages, and drift information.

wl status

Output:

Workspace: Platform API (acme/platform-api)
Revision: local 42, remote 42

Packages:
  @acme/security-review@1.4.2  (stable)
  @acme/base-guidance@2.1.0    (stable)

Rendered files:
  .claude/skills/security-review/SKILL.md
  .claude/settings.json
  AGENTS.md
  .codex/config.toml

Status: clean

Sync commands

wl pull

Fetches the workspace manifest, resolves packages, downloads objects, and renders provider-specific files.

wl pull
wl pull --dry-run          # Preview without writing
wl pull --provider claude  # Render only Claude files
wl pull --target apps/web  # Render only one monorepo target
wl pull --force            # Overwrite local modifications

wl push

Uploads local assets as a new package version.

wl push .claude/skills/security-review \
  --package @acme/security-review \
  --bump minor \
  --draft

Flags:

Flag	Description
--package	Target package name (required)
--bump	Version increment: patch, minor, major
--draft	Create as draft without auto-publishing

Planned commands

These commands are designed but not yet implemented:

Command	Purpose
wl sync	Apply render plan locally
wl sync --check	CI drift check (no writes, exit code)
wl diff	Show content differences
wl restore	Restore Workloom-owned files
wl render --dry-run	Preview render plan
wl validate	Validate workspace config
wl doctor	Diagnose setup issues