Migrating to 0.29

wtm create --output json answers with an envelope

create can now make several worktrees in one run, so its JSON document is always an envelope, even for a single branch.

Before:

{"branch": "feat/login", "path": "/repo/.worktrees/feat-login", "already_exists": false, ...}

After:

{"results": [{"branch": "feat/login", "path": "/repo/.worktrees/feat-login", "already_exists": false, ...}], "failed": []}

A script reading .path reads .results[0].path. A branch that could not be created is in failed, with its error, its exit_code, and its path when the worktree exists but an on_create hook failed. The process still exits with the first failure's code, so a script that only checks the exit code needs no change.

wtm clean --output json answers with an envelope

clean can now remove several worktrees in one run, so its JSON document is an envelope too, even for a single branch.

Before:

{"branch": "feat/login", "path": "/repo/.worktrees/feat-login", "already_absent": false, "namespaces": []}

After:

{"results": [{"branch": "feat/login", "path": "/repo/.worktrees/feat-login", "already_absent": false}], "failed": [], "skipped": [], "reparented": [], "orphaned_children": [], "namespaces": []}

A script reading .already_absent reads .results[0].already_absent. reparented, orphaned_children and namespaces stay at the top level, each entry naming its branch. A worktree that could not be removed is in failed with its error and exit_code; the process still exits with the first failure's code.

The wizard asks for a list of branches

wtm create without arguments now asks for one or more branches: type a name, press tab to add another, enter to continue. wtm create <branch> with a single argument skips that step as before; with several arguments the list opens pre-filled. The dashboard's create (wtm ui) asks the same list; each worktree appears in the list as soon as it exists, and the cursor lands on the first.

wtm clean takes several worktrees

wtm clean feat/a feat/b removes both; without arguments the picker lets you check several. Under --yes, one unsafe worktree (dirty, unpushed, open PR) refuses the whole run before anything is removed, so pass --force or name only the safe ones. The dashboard (wtm ui) offers the same from its global menu, « Delete worktrees »; the row menu still deletes the one worktree it was opened from.

Two exit codes changed

Code	Now returned by	Before
21	any command run outside a git repository	1
19	every interactive cancellation: Esc, Ctrl-C, "No, cancel", a declined confirmation. Never under --yes	0

wtm create x && wtm go x now stops when the wizard is cancelled. A script that tested 1 for "not a repository", or read 0 after a cancelled prompt, checks for 21 or 19. The full list is in Integrations.