Agent-Skills.md

Agent Skills: wt-switch-create

Create a new worktrunk worktree (optionally in another repo) and switch this session's working directory into it. Use when launching a session that should work in its own worktree (e.g. `/wt-switch-create my-branch -- <task>`, or `/wt-switch-create my-branch ~/workspace/other-repo -- <task>`), or mid-session to move work into a fresh branch.

UncategorizedID: zenobi-us/dotfiles/wt-switch-create

Repository

zenobi-us/dotfiles
zenobi-usLicense: MIT
676

Install this agent skill to your local

pnpm dlx add-skill https://github.com/zenobi-us/dotfiles/tree/HEAD/devtools/files/pi/agent/bundles/developer/skills/wt-switch-create

Skill Files

Browse the full folder contents for wt-switch-create.

Download Skill

Loading file tree…

devtools/files/pi/agent/bundles/developer/skills/wt-switch-create/SKILL.md

Skill Metadata

Name
wt-switch-create
Description
Create a new worktrunk worktree (optionally in another repo) and switch this session's working directory into it. Use when launching a session that should work in its own worktree (e.g. `/wt-switch-create my-branch -- <task>`, or `/wt-switch-create my-branch ~/workspace/other-repo -- <task>`), or mid-session to move work into a fresh branch.

Arguments: $ARGUMENTS. Grammar: <branch> [<repo>] [-- <task>].

  • branch — required first token; the branch name for the new worktree.
  • repo — optional path; create the worktree in this repo instead of the session's current one.
  • task — optional; what to do inside the new worktree. No task means enter the worktree and wait.

Without a --: a path-shaped second token (absolute, ~-relative, ./- or ../-relative, or an existing directory) is the repo, and the task starts after it. Otherwise the task starts at the second token.

/wt-switch-create my-feature -- fix the parser bug
/wt-switch-create my-feature ~/workspace/other-repo -- fix the parser bug
/wt-switch-create my-feature

What to do

  1. First action — before reading any files or running any commands:

    • If a repo was given, cd into it first with a Bash call (the working directory persists for the rest of the session). EnterWorktree has no repo parameter — it creates the worktree wherever the session is rooted.
    • Then call EnterWorktree({name: "<branch-name>"}). This re-roots the session into the new worktree. If a repo was given, confirm the new worktree landed under it; if not, the cd didn't take — report it and stop.
    • It works because this plugin maps WorktreeCreate → wt switch --create <name> --no-cd --format=json, so the new worktree lands in worktrunk's normal sibling layout (<repo>.<branch>/), not under .claude/worktrees/.
    • wt switch --create is idempotent: if the branch already exists, this just re-enters its worktree.
    • If you are already inside an EnterWorktree-created worktree (e.g. the background harness isolated this session), skip EnterWorktree — it refuses to nest. Reuse the existing worktree and continue. But if a repo was given and that worktree belongs to a different repo, you can't honor it — say so and stop rather than running the task in the wrong repo.
    • If EnterWorktree fails (not a git repo, invalid branch name, etc.), report the error and stop — do not fall back to working in the original directory, since that defeats the purpose.

  2. After the cwd switch succeeds, do the task in the new worktree. If there was no task text, confirm the worktree is ready and wait for the next instruction.

Cleanup

Don't remove the worktree yourself. ExitWorktree({action: "remove"}) (if the user asks to leave) or the session-exit prompt routes through this plugin's WorktreeRemove hook → wt remove -D --foreground. A worktree with uncommitted changes won't be auto-removed without confirmation — that's intended.

Scope

This command authorizes creating/entering ONE worktree — in the named repo, if one was given — and doing the requested task. Commits, pushes, and merges still each require explicit user permission.