Workflows

The Quick Start owns the beginner create/clone path. Use Repository Member Lifecycle for member creation, publish-later setup, clone/add distinctions, detach/attach verification, and replacement. The recipes below start with an existing workspace.

Make A Multi-Repository Change

gwz status
gwz snapshot before-change
gwz forall -- cargo test
gwz add -A
gwz commit -m "Update shared API"
gwz status

If the change must be backed out to the snapshot:

gwz materialize --snapshot before-change

Prepare A Release Tag

gwz status
gwz forall -- cargo test
gwz snapshot release-candidate
gwz tag v0.9.0 -m "GWZ v0.9.0"
gwz tag --push v0.9.0

Verify the tag checkout:

gwz materialize --tag v0.9.0
gwz status

Pull A Workspace Forward

Preview first:

gwz --dry-run pull --head

Then update:

gwz pull --head
gwz status

If a remote host is slow or overloaded:

gwz --jobs 20 --max-per-host 4 --ssh-timeout 10 pull --head

Run Maintenance In Members

Run a direct command:

gwz forall -- git status --short

Run a shell command that uses GWZ environment variables:

gwz forall -c 'echo "$GWZ_MEMBER_PATH"; git rev-parse --short HEAD'

Continue through failures and report the failed members at the end:

gwz --partial forall -- cargo test

Script Member Paths

Human gwz ls output is one path per line:

gwz ls --local

For structured member metadata:

gwz --json ls

For stable status path output:

gwz status --porcelain