Work on a Change

Use this workflow for day-to-day work in a configured workspace.

Start

aw create feature-auth
aw switch feature-auth
aw status

Use --only, --group, or --interactive when the change needs fewer than all configured repositories. See Integrations to open work in your editor or terminal.

Resume

aw list
aw switch feature-auth
aw status

Validate

Run checks only where they are needed:

aw exec --only frontend -- pnpm test
aw exec --group web -- pnpm test

Each repository keeps its own test and release rules.

Hand off

aw handoff \
  --validation "pnpm test — passed" \
  --todo "review the API migration"

Report validation only after it has run. Put pending work under --todo or --risk.

Publish and clean up

aw status
aw push --set-upstream
aw finish feature-auth --dry-run
aw finish feature-auth

Each repository still owns its commits, CI, and pull request. Check that each change is actually complete before cleanup; finish assesses integration and asks for manual judgment where proof is unavailable. Use remove for branch worktrees when you want direct cleanup, including abandoned work. Use delete only to remove a configured repository dependency.