Worktrunk

Worktrunk

Use wt for the worktree lifecycle when it is available. Run it inside the repository.

Core workflow

wt list
wt switch --create <branch>
wt switch <branch>
wt remove

• Use --create for a new branch. Without it, wt switch enters an existing worktree or creates one for an existing branch.
• wt switch opens the picker, wt switch - returns to the previous worktree, and wt switch ^ enters the default branch worktree.
• Continue work in the directory reported by wt. When shell state does not persist between commands, set the next command's working directory explicitly.
• Use wt <command> --help for version-specific flags. Use raw git worktree commands only when the user requests them or wt is unavailable.

References

Read only the reference that matches the task:

• Creating or editing .config/wt.toml, choosing hooks, or handling hook approvals: references/project-config.md
• Editing personal paths or defaults in ~/.config/worktrunk/config.toml: references/user-config.md
• Using bases, shortcuts, remote branches, pull requests, or non-persistent shells with wt switch: references/switch.md
• Filtering worktrees or consuming structured wt list output: references/list.md
• Removing worktrees or branches, especially with force flags: references/remove.md
• Fixing setup, directory switching, hooks, or slow status collection: references/troubleshooting.md