wl pull
Render provider files from canonical packages.
Synopsis
wl pull [--dry-run] [--locked] [--on-conflict <policy>]
Description
Computes the desired state from your workspace manifest and renders provider-specific files (.claude/settings.json, AGENTS.md, etc.). Does not write anything without approval if trust gates are required.
info
This command is coming in Phase 1.
Options
| Option | Description |
|---|---|
--dry-run | Show render plan without writing files |
--locked | Use locked versions only (from lock file) |
--on-conflict | Policy for conflicting files: fail (default), keep-local, restore, promote-to-override |
Exit Codes
| Code | Meaning |
|---|---|
0 | Success |
4 | Conflict detected |
5 | Trust gate blocked |
Examples
Preview Render
wl pull --dry-run
# Shows what would be rendered without writing
Render with Locked Versions
wl pull --locked
# Uses lock file, rejects manifest changes
Handle Conflicts
wl pull --on-conflict restore
# Restore conflicting files to desired state