t1k:worktree
| Field | Value |
|---|---|
| Module | t1k-maintainer |
| Version | 2.18.3 |
| Effort | low |
| Tools | — |
Keywords: branch, isolation, monorepo, parallel, rebase, workspace, worktree
How to invoke
Section titled “How to invoke”/t1k:worktree<subcommand> [args] — subcommands: create, session, sync, envsync, diff, status, list, remove, info, mergeGit Worktree Manager
Section titled “Git Worktree Manager”Manage git worktrees across the full lifecycle: create, session, sync, envsync, diff, status, remove, merge.
All commands: node $HOME/.claude/skills/t1k-worktree/scripts/worktree.cjs <command> [args] [--json] [--dry-run]
Commands
Section titled “Commands”| Command | Usage | Description |
|---|---|---|
create | create [project] <feature> --prefix <type> | Create worktree with branch |
remove | remove <name-or-path> | Remove worktree and branch |
session | session <name-or-path> | Get session command for worktree |
sync | sync [--worktree <name>] | Rebase worktrees from base branch |
envsync | envsync [--source <path>] [--exclude <name>] [--dry-run] | Sync .env files across worktrees |
diff | diff [--worktree <name>] | Diff status per worktree vs base |
status | status | Combined overview of all worktrees |
info | info | Repo info, worktree location |
list | list | List all worktrees |
merge | merge [--target <branch>] [--delete] [--no-reset] | Merge worktree branch to base via PR |
Decision tree — which reference do I load?
Section titled “Decision tree — which reference do I load?”Load only the reference you need (each is self-contained):
| Intent | Load |
|---|---|
| Create a new worktree (or check if one exists first) | references/workflow-create.md |
| Open or switch to an existing worktree session | references/workflow-session.md |
| Rebase worktrees onto latest base branch | references/workflow-sync.md |
| Sync .env files across worktrees / check compose drift | references/workflow-envsync.md |
| Inspect changes, ahead/behind, status | references/workflow-diff-status.md |
| Merge worktree branch back to base via PR | references/workflow-merge.md |
| Before/after reporting format for any command | references/reporting-protocol.md |
Operational notes
Section titled “Operational notes”Intent routing (MANDATORY): Always run list --json before asking the user anything — a matching worktree name means jump straight to the session workflow.
Safety: Rebase auto-aborts on conflict to prevent data loss.
Reporting: Every command MUST show before/after state. End with a summary line. Full format: references/reporting-protocol.md.