@cestoliv/wt 0.4.0 → 0.4.1-pr19.g60c9f69
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -3
- package/SKILL.md +16 -6
- package/dist/{agent-WO3XIT4H.js → agent-QRYZPDLK.js} +3 -2
- package/dist/{chunk-E2IOE23G.js → chunk-7Z34YVWV.js} +75 -26
- package/dist/{chunk-ASVHQXDJ.js → chunk-OAGIMKQC.js} +1 -1
- package/dist/cli.js +5 -5
- package/dist/{create-YBHDJOP5.js → create-FHDNRQ6G.js} +2 -2
- package/dist/{list-HIKXMDHJ.js → list-XOOTJQCJ.js} +26 -5
- package/dist/skill-HCHE7OGV.js +9 -0
- package/package.json +1 -1
- package/dist/skill-FEUVQMK6.js +0 -9
package/README.md
CHANGED
|
@@ -90,12 +90,19 @@ MY-PROJECT
|
|
|
90
90
|
feat/dashboard ~/dev/my-project-feat-dashboard
|
|
91
91
|
wip: add chart component (1d ago)
|
|
92
92
|
|
|
93
|
-
↕ navigate · Enter open · D delete · C create · Q quit
|
|
93
|
+
↕ navigate · Enter open · D delete · C create · A agent · Q quit
|
|
94
94
|
```
|
|
95
95
|
|
|
96
96
|
Type to fuzzy-filter branches instantly. Inside a repo it shows that repo's
|
|
97
|
-
worktrees
|
|
98
|
-
|
|
97
|
+
worktrees; run it outside any repo ("home") to browse worktrees across all
|
|
98
|
+
registered repos.
|
|
99
|
+
|
|
100
|
+
`C` creates a worktree and `A` creates one and starts an AI agent in it — both
|
|
101
|
+
work from anywhere. Run from home and they first prompt for the repo and branch
|
|
102
|
+
(`A` also prompts for a plan prompt and permission mode). After creating, the
|
|
103
|
+
list **refreshes and stays open** (preserving your search and cursor) instead of
|
|
104
|
+
exiting — only `Enter` and `Q`/`Esc` leave the TUI. Note that `a`/`c`/`d` are
|
|
105
|
+
command keys, so they can't be typed into the search box.
|
|
99
106
|
|
|
100
107
|
## Create — `wt create [branch]`
|
|
101
108
|
|
package/SKILL.md
CHANGED
|
@@ -15,12 +15,22 @@ Launch the interactive TUI. Shows worktrees for the current repo (repo mode) or
|
|
|
15
15
|
|
|
16
16
|
**Keybindings in the TUI:**
|
|
17
17
|
|
|
18
|
-
- Arrow keys
|
|
19
|
-
- `Enter` — open worktree in IDE
|
|
20
|
-
- `
|
|
21
|
-
- `
|
|
22
|
-
-
|
|
23
|
-
-
|
|
18
|
+
- Arrow keys — navigate
|
|
19
|
+
- `Enter` — open worktree in IDE (exits the TUI)
|
|
20
|
+
- `D` — delete worktree
|
|
21
|
+
- `C` — create a new worktree (works in both repo and global mode)
|
|
22
|
+
- `A` — create a worktree and start an AI agent in it (prompts for a plan prompt and permission mode)
|
|
23
|
+
- type to search · `Backspace` — edit search
|
|
24
|
+
- `Q` / `Esc` — quit
|
|
25
|
+
|
|
26
|
+
`C` and `A` run the full interactive flow: in global mode (run from outside a
|
|
27
|
+
repo / "home") they first prompt for the repo (picker) and branch. After a
|
|
28
|
+
create or agent action the TUI **refreshes and stays open** on the list (your
|
|
29
|
+
search and cursor are preserved) rather than exiting — only `Enter` (open) and
|
|
30
|
+
`Q`/`Esc` exit.
|
|
31
|
+
|
|
32
|
+
Because `a`/`A`, `c`/`C`, and `d`/`D` are reserved as command keys, those
|
|
33
|
+
letters can't be typed into the search box.
|
|
24
34
|
|
|
25
35
|
### `wt create [branch]`
|
|
26
36
|
|
|
@@ -3,8 +3,8 @@ import {
|
|
|
3
3
|
openConfiguredIde,
|
|
4
4
|
prepareWorktree,
|
|
5
5
|
promptExistingWorktree
|
|
6
|
-
} from "./chunk-
|
|
7
|
-
import "./chunk-
|
|
6
|
+
} from "./chunk-OAGIMKQC.js";
|
|
7
|
+
import "./chunk-7Z34YVWV.js";
|
|
8
8
|
import "./chunk-FNAMNRUH.js";
|
|
9
9
|
|
|
10
10
|
// src/commands/agent.ts
|
|
@@ -538,5 +538,6 @@ function reportTriggerFailure(result, chord) {
|
|
|
538
538
|
);
|
|
539
539
|
}
|
|
540
540
|
export {
|
|
541
|
+
VALID_MODES,
|
|
541
542
|
createAgentWorktree
|
|
542
543
|
};
|
|
@@ -253,37 +253,56 @@ function shortenPath(p) {
|
|
|
253
253
|
const home = process.env.HOME ?? "";
|
|
254
254
|
return home && p.startsWith(home) ? `~${p.slice(home.length)}` : p;
|
|
255
255
|
}
|
|
256
|
-
function
|
|
257
|
-
const
|
|
256
|
+
function buildListLayout(items, selectedIndex, query, mode) {
|
|
257
|
+
const header = [];
|
|
258
258
|
if (mode === "global") {
|
|
259
|
-
|
|
259
|
+
header.push(
|
|
260
260
|
pc.dim("\u2139 Not in a git repository \u2014 showing all registered worktrees")
|
|
261
261
|
);
|
|
262
|
-
|
|
262
|
+
header.push("");
|
|
263
263
|
}
|
|
264
|
-
|
|
265
|
-
|
|
264
|
+
header.push(pc.cyan(`> ${query}_`));
|
|
265
|
+
const body = [];
|
|
266
|
+
const itemSpans = [];
|
|
266
267
|
const groups = groupByRepo(items);
|
|
267
268
|
let i = 0;
|
|
268
269
|
for (const [repoPath, groupItems] of groups) {
|
|
269
|
-
|
|
270
|
+
body.push(pc.bold(path2.basename(repoPath).toUpperCase()));
|
|
270
271
|
for (const item of groupItems) {
|
|
272
|
+
const start = body.length;
|
|
271
273
|
const cursor = i === selectedIndex ? pc.cyan("\u25B6") : " ";
|
|
272
274
|
const branchLabel = item.isCurrent ? pc.dim(`${item.branch} (current)`) : pc.white(item.branch);
|
|
273
275
|
const pathLabel = pc.dim(shortenPath(item.path));
|
|
274
|
-
|
|
276
|
+
body.push(` ${cursor} ${branchLabel} ${pathLabel}`);
|
|
275
277
|
if (item.lastCommit) {
|
|
276
|
-
|
|
278
|
+
body.push(` ${pc.dim(item.lastCommit)}`);
|
|
277
279
|
}
|
|
280
|
+
itemSpans[i] = { start, end: body.length - 1 };
|
|
278
281
|
i++;
|
|
279
282
|
}
|
|
280
283
|
}
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
284
|
+
const footer = [
|
|
285
|
+
pc.dim("\u2195 navigate \xB7 Enter open \xB7 D delete \xB7 C create \xB7 A agent \xB7 Q quit")
|
|
286
|
+
];
|
|
287
|
+
return { header, body, footer, itemSpans };
|
|
288
|
+
}
|
|
289
|
+
function clampScroll(offset, span, viewportHeight, bodyLength) {
|
|
290
|
+
const maxOffset = Math.max(0, bodyLength - viewportHeight);
|
|
291
|
+
let next = offset;
|
|
292
|
+
if (span.start < next) next = span.start;
|
|
293
|
+
if (span.end >= next + viewportHeight) next = span.end - viewportHeight + 1;
|
|
294
|
+
return Math.max(0, Math.min(next, maxOffset));
|
|
295
|
+
}
|
|
296
|
+
function composeView(layout, offset, viewportHeight) {
|
|
297
|
+
const { header, body, footer } = layout;
|
|
298
|
+
const visible = body.slice(offset, offset + viewportHeight);
|
|
299
|
+
while (visible.length < viewportHeight) visible.push("");
|
|
300
|
+
const topSlot = offset > 0 ? pc.dim(" \u2191 more") : "";
|
|
301
|
+
const bottomSlot = offset + viewportHeight < body.length ? pc.dim(" \u2193 more") : "";
|
|
302
|
+
return [...header, topSlot, ...visible, bottomSlot, ...footer].join("\n");
|
|
303
|
+
}
|
|
304
|
+
function fixedHeight(layout) {
|
|
305
|
+
return layout.header.length + layout.footer.length + 2;
|
|
287
306
|
}
|
|
288
307
|
function setupRawMode() {
|
|
289
308
|
process.stdin.setRawMode(true);
|
|
@@ -435,10 +454,21 @@ async function runBranchInput(repoRoot) {
|
|
|
435
454
|
async function runInteractiveList(allItems, mode, handlers) {
|
|
436
455
|
let query = "";
|
|
437
456
|
let selectedIndex = 0;
|
|
457
|
+
let scrollOffset = 0;
|
|
438
458
|
let filtered = allItems;
|
|
439
459
|
const render = () => {
|
|
460
|
+
const rows = process.stdout.rows ?? 24;
|
|
461
|
+
const layout = buildListLayout(filtered, selectedIndex, query, mode);
|
|
462
|
+
const viewport = Math.max(1, rows - fixedHeight(layout));
|
|
463
|
+
const span = layout.itemSpans[selectedIndex] ?? { start: 0, end: 0 };
|
|
464
|
+
scrollOffset = clampScroll(
|
|
465
|
+
scrollOffset,
|
|
466
|
+
span,
|
|
467
|
+
viewport,
|
|
468
|
+
layout.body.length
|
|
469
|
+
);
|
|
440
470
|
process.stdout.write("\x1B[2J\x1B[H");
|
|
441
|
-
process.stdout.write(
|
|
471
|
+
process.stdout.write(composeView(layout, scrollOffset, viewport));
|
|
442
472
|
};
|
|
443
473
|
setupRawMode();
|
|
444
474
|
render();
|
|
@@ -447,11 +477,13 @@ async function runInteractiveList(allItems, mode, handlers) {
|
|
|
447
477
|
const attachListener = () => {
|
|
448
478
|
if (!listenerActive) {
|
|
449
479
|
process.stdin.on("data", onData);
|
|
480
|
+
process.stdout.on("resize", render);
|
|
450
481
|
listenerActive = true;
|
|
451
482
|
}
|
|
452
483
|
};
|
|
453
484
|
const detachListener = () => {
|
|
454
485
|
process.stdin.removeListener("data", onData);
|
|
486
|
+
process.stdout.removeListener("resize", render);
|
|
455
487
|
listenerActive = false;
|
|
456
488
|
};
|
|
457
489
|
const onData = async (key) => {
|
|
@@ -499,25 +531,42 @@ async function runInteractiveList(allItems, mode, handlers) {
|
|
|
499
531
|
render();
|
|
500
532
|
}
|
|
501
533
|
} else if (key === "c" || key === "C") {
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
534
|
+
detachListener();
|
|
535
|
+
cleanupRawMode();
|
|
536
|
+
await handlers.onCreate();
|
|
537
|
+
allItems = await handlers.refreshItems();
|
|
538
|
+
filtered = filterItems(allItems, query);
|
|
539
|
+
selectedIndex = Math.min(
|
|
540
|
+
selectedIndex,
|
|
541
|
+
Math.max(0, filtered.length - 1)
|
|
542
|
+
);
|
|
543
|
+
setupRawMode();
|
|
544
|
+
attachListener();
|
|
545
|
+
render();
|
|
546
|
+
} else if (key === "a" || key === "A") {
|
|
547
|
+
detachListener();
|
|
548
|
+
cleanupRawMode();
|
|
549
|
+
await handlers.onAgent();
|
|
550
|
+
allItems = await handlers.refreshItems();
|
|
551
|
+
filtered = filterItems(allItems, query);
|
|
552
|
+
selectedIndex = Math.min(
|
|
553
|
+
selectedIndex,
|
|
554
|
+
Math.max(0, filtered.length - 1)
|
|
555
|
+
);
|
|
556
|
+
setupRawMode();
|
|
557
|
+
attachListener();
|
|
558
|
+
render();
|
|
512
559
|
} else if (key === "\x7F") {
|
|
513
560
|
query = query.slice(0, -1);
|
|
514
561
|
filtered = filterItems(allItems, query);
|
|
515
562
|
selectedIndex = 0;
|
|
563
|
+
scrollOffset = 0;
|
|
516
564
|
render();
|
|
517
565
|
} else if (key.length === 1 && key >= " ") {
|
|
518
566
|
query += key;
|
|
519
567
|
filtered = filterItems(allItems, query);
|
|
520
568
|
selectedIndex = 0;
|
|
569
|
+
scrollOffset = 0;
|
|
521
570
|
render();
|
|
522
571
|
}
|
|
523
572
|
} catch (err) {
|
package/dist/cli.js
CHANGED
|
@@ -3,12 +3,12 @@
|
|
|
3
3
|
// src/cli.ts
|
|
4
4
|
import { Command } from "commander";
|
|
5
5
|
var program = new Command();
|
|
6
|
-
program.name("wt").description("Git worktree manager").version("0.4.
|
|
7
|
-
const { runList } = await import("./list-
|
|
6
|
+
program.name("wt").description("Git worktree manager").version("0.4.1-pr19.g60c9f69").action(async () => {
|
|
7
|
+
const { runList } = await import("./list-XOOTJQCJ.js");
|
|
8
8
|
await runList();
|
|
9
9
|
});
|
|
10
10
|
program.command("create [branch]").description("Create a new worktree").action(async (branch) => {
|
|
11
|
-
const { createWorktree } = await import("./create-
|
|
11
|
+
const { createWorktree } = await import("./create-FHDNRQ6G.js");
|
|
12
12
|
await createWorktree(branch);
|
|
13
13
|
});
|
|
14
14
|
program.command("agent <branch> <plan_prompt>").description("Create a worktree and auto-start an AI agent in Zed (macOS)").option(
|
|
@@ -17,7 +17,7 @@ program.command("agent <branch> <plan_prompt>").description("Create a worktree a
|
|
|
17
17
|
"plan"
|
|
18
18
|
).action(
|
|
19
19
|
async (branch, planPrompt, options) => {
|
|
20
|
-
const { createAgentWorktree } = await import("./agent-
|
|
20
|
+
const { createAgentWorktree } = await import("./agent-QRYZPDLK.js");
|
|
21
21
|
await createAgentWorktree(branch, planPrompt, { mode: options.mode });
|
|
22
22
|
}
|
|
23
23
|
);
|
|
@@ -31,7 +31,7 @@ program.command("config").description("Open the config file in $EDITOR").option(
|
|
|
31
31
|
}
|
|
32
32
|
});
|
|
33
33
|
program.command("skill").description("Print the wt skill file to stdout").action(async () => {
|
|
34
|
-
const { printSkill } = await import("./skill-
|
|
34
|
+
const { printSkill } = await import("./skill-HCHE7OGV.js");
|
|
35
35
|
printSkill();
|
|
36
36
|
});
|
|
37
37
|
await program.parseAsync(process.argv);
|
|
@@ -4,8 +4,8 @@ import {
|
|
|
4
4
|
openConfiguredIde,
|
|
5
5
|
prepareWorktree,
|
|
6
6
|
promptExistingWorktree
|
|
7
|
-
} from "./chunk-
|
|
8
|
-
import "./chunk-
|
|
7
|
+
} from "./chunk-OAGIMKQC.js";
|
|
8
|
+
import "./chunk-7Z34YVWV.js";
|
|
9
9
|
import "./chunk-FNAMNRUH.js";
|
|
10
10
|
export {
|
|
11
11
|
createWorktree,
|
|
@@ -9,7 +9,7 @@ import {
|
|
|
9
9
|
removeWorktree,
|
|
10
10
|
runCommands,
|
|
11
11
|
runInteractiveList
|
|
12
|
-
} from "./chunk-
|
|
12
|
+
} from "./chunk-7Z34YVWV.js";
|
|
13
13
|
import {
|
|
14
14
|
createStore,
|
|
15
15
|
getEffectiveConfig
|
|
@@ -124,10 +124,31 @@ ${dirty.map((f) => ` ${f}`).join("\n")}`
|
|
|
124
124
|
}
|
|
125
125
|
},
|
|
126
126
|
onCreate: async () => {
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
127
|
+
const { createWorktree } = await import("./create-FHDNRQ6G.js");
|
|
128
|
+
await createWorktree(void 0, { cwd: repoRoot ?? cwd, store });
|
|
129
|
+
},
|
|
130
|
+
onAgent: async () => {
|
|
131
|
+
const plan = await clack.text({
|
|
132
|
+
message: "Plan prompt for the agent:",
|
|
133
|
+
validate: (v) => !v || v.length === 0 ? "Required" : void 0
|
|
134
|
+
});
|
|
135
|
+
if (clack.isCancel(plan)) return;
|
|
136
|
+
const { createAgentWorktree, VALID_MODES } = await import("./agent-QRYZPDLK.js");
|
|
137
|
+
const mode2 = await clack.select({
|
|
138
|
+
message: "Permission mode:",
|
|
139
|
+
initialValue: "plan",
|
|
140
|
+
options: VALID_MODES.map((m) => ({ value: m, label: m }))
|
|
141
|
+
});
|
|
142
|
+
if (clack.isCancel(mode2)) return;
|
|
143
|
+
await createAgentWorktree(void 0, plan, {
|
|
144
|
+
cwd: repoRoot ?? cwd,
|
|
145
|
+
store,
|
|
146
|
+
mode: mode2
|
|
147
|
+
});
|
|
148
|
+
},
|
|
149
|
+
refreshItems: async () => {
|
|
150
|
+
const refreshed = await prepareListItems({ cwd, store });
|
|
151
|
+
return refreshed.items;
|
|
131
152
|
}
|
|
132
153
|
});
|
|
133
154
|
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
// src/commands/skill.ts
|
|
4
|
+
function printSkill() {
|
|
5
|
+
console.log('---\nname: wt-worktree-manager\ndescription: Use the wt CLI to create, browse, open, and delete git worktrees across repos. Use when the user asks to manage worktrees, create isolated branches, or configure worktree defaults.\n---\n\n# wt \u2014 Git Worktree Manager\n\n`wt` is a CLI for managing git worktrees. It provides an interactive TUI to browse, create, open in your IDE, and delete worktrees across multiple repos.\n\n## Commands\n\n### `wt` (no subcommand)\n\nLaunch the interactive TUI. Shows worktrees for the current repo (repo mode) or all registered repos (global mode, when run outside a repo).\n\n**Keybindings in the TUI:**\n\n- Arrow keys \u2014 navigate\n- `Enter` \u2014 open worktree in IDE (exits the TUI)\n- `D` \u2014 delete worktree\n- `C` \u2014 create a new worktree (works in both repo and global mode)\n- `A` \u2014 create a worktree and start an AI agent in it (prompts for a plan prompt and permission mode)\n- type to search \xB7 `Backspace` \u2014 edit search\n- `Q` / `Esc` \u2014 quit\n\n`C` and `A` run the full interactive flow: in global mode (run from outside a\nrepo / "home") they first prompt for the repo (picker) and branch. After a\ncreate or agent action the TUI **refreshes and stays open** on the list (your\nsearch and cursor are preserved) rather than exiting \u2014 only `Enter` (open) and\n`Q`/`Esc` exit.\n\nBecause `a`/`A`, `c`/`C`, and `d`/`D` are reserved as command keys, those\nletters can\'t be typed into the search box.\n\n### `wt create [branch]`\n\nCreate a new worktree. If `branch` is omitted, prompts interactively.\n\nThe worktree is created as a sibling directory to the repo: `<parent>/<repo-name>-<branch-name>`.\n\nAfter creation, `wt` runs any configured `setup_commands` and opens the worktree in your IDE.\n\nIf the worktree path already exists, `wt create` doesn\'t error \u2014 it prompts you\nto **open it in the IDE** or **quit**. (In a non-interactive shell it errors\nwith a non-zero exit instead of prompting.)\n\n### `wt agent <branch> <plan_prompt> [--mode <mode>]`\n\nCreate a worktree (same as `wt create`) **and** auto-start an AI agent in Zed\'s\nintegrated terminal, pre-filled with `<plan_prompt>` and left interactive for\nyou to take over.\n\n```bash\nwt agent feature/login \'Read the codebase, then propose a plan for login.\'\nwt agent feature/fix \'Fix the bug in payment processing\' --mode auto\nwt agent refactor/api \'Refactor the API layer\' --mode default\n```\n\nThe `--mode` flag sets Claude Code\'s permission mode (defaults to `plan`):\n\n- `default` \u2014 Standard interactive mode with approval for each action\n- `acceptEdits` \u2014 Allow file changes but keep command execution controlled\n- `plan` \u2014 Architecture-first mode with no surprise mutations (default)\n- `auto` \u2014 Claude\'s safety model makes decisions instead of prompting\n- `dontAsk` \u2014 Minimal interruptions in trusted environments\n- `bypassPermissions` \u2014 Skip all permission checks (dangerous, CI/sandbox only)\n\nIt writes a temporary `.zed/tasks.json` running\n`<agent_command> --permission-mode <mode> \'<plan_prompt>\'`, ensures a global Zed keymap chord\n(`agent_trigger_chord`) spawns that task, opens Zed, presses the chord via\n`osascript`, then removes the temporary task so the repo is left clean.\n\n**macOS + Zed only.** Requires Accessibility permission for the app that runs\n`wt` (Zed itself, when run from its integrated terminal). If it isn\'t granted,\n`wt agent` opens the _Privacy & Security \u2192 Accessibility_ settings pane and waits\nfor you to grant it and confirm, then retries automatically. On other platforms\n(or when `ide` is not `zed`) the worktree is still created and opened, but the\nagent is not auto-started.\n\nOver SSH it still works, provided the same user has an active graphical login on\nthe Mac: the keystroke is run inside the GUI session via Launch Services\n(`open -a Terminal` briefly flashes a Terminal window). Grant Accessibility to\nTerminal (not Zed) the first time. With no one logged in graphically there is\nnothing to drive, so it falls back to the manual "press the chord in Zed"\nmessage.\n\nIf the worktree path already exists, `wt agent` prompts you to **open it in the\nIDE**, **open it and start the agent**, or **quit** \u2014 instead of erroring. (In a\nnon-interactive shell it errors with a non-zero exit instead of prompting.)\n\n### `wt config`\n\nOpen the global config file in `$EDITOR` (defaults to `nano`).\n\n```bash\nwt config # open in editor\nwt config --path # print config file path only\n```\n\n### `wt skill`\n\nPrint this skill file to stdout. Useful for piping to agents or copying to a project.\n\n## Configuration\n\nConfig is stored as JSON. Get the path with `wt config --path`.\n\n### Schema\n\n| Key | Type | Default | Description |\n| --------------------- | ---------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `worktree_path` | `string` | `"../"` | Where to place new worktrees, relative to the repo root |\n| `base_branch` | `string` | `"origin/main"` | Branch to base new worktrees on |\n| `setup_commands` | `string[]` | `[]` | Commands to run in a new worktree after creation (e.g. `["npm install"]`) |\n| `teardown_commands` | `string[]` | `[]` | Commands to run in a worktree just before it is deleted (e.g. `["docker compose down -v"]`); on failure you are prompted whether to delete anyway |\n| `ide` | `string` | `"zed"` | IDE command to open worktrees with |\n| `ide_open_args` | `string[]` | `["-n"]` | Arguments passed to the IDE command |\n| `agent_command` | `string` | `"claude --permission-mode plan"` | Base command `wt agent` runs in Zed; any `--permission-mode` flag is replaced by the `--mode` option (defaults to `plan`), then `<plan_prompt>` is appended single-quoted |\n| `agent_trigger_chord` | `string` | `"ctrl-shift-cmd-c"` | Zed keymap chord `wt agent` installs/presses to spawn the agent task |\n| `repos` | `string[]` | `[]` | Registered repo paths (auto-populated on first use) |\n| `repo_overrides` | `object` | `{}` | Per-repo config overrides (see below) |\n\n### Per-repo overrides\n\nOverride any field (`worktree_path`, `base_branch`, `setup_commands`, `teardown_commands`, `ide`, `ide_open_args`, `agent_command`, `agent_trigger_chord`) for a specific repo:\n\n```json\n{\n "base_branch": "origin/main",\n "ide": "zed",\n "repo_overrides": {\n "/path/to/my-repo": {\n "base_branch": "origin/develop",\n "setup_commands": ["npm install", "npm run build"]\n }\n }\n}\n```\n\n## Common workflows\n\n### Create a worktree for a new feature\n\n```bash\ncd /path/to/repo\nwt create feature/my-branch\n```\n\n### Configure setup commands for a repo\n\n```bash\nwt config\n# Then add to the JSON:\n# "repo_overrides": {\n# "/path/to/repo": {\n# "setup_commands": ["npm install"]\n# }\n# }\n```\n\n### Browse all worktrees across repos\n\nRun `wt` from any directory outside a git repo to see worktrees from all registered repos.\n');
|
|
6
|
+
}
|
|
7
|
+
export {
|
|
8
|
+
printSkill
|
|
9
|
+
};
|
package/package.json
CHANGED
package/dist/skill-FEUVQMK6.js
DELETED
|
@@ -1,9 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
|
|
3
|
-
// src/commands/skill.ts
|
|
4
|
-
function printSkill() {
|
|
5
|
-
console.log('---\nname: wt-worktree-manager\ndescription: Use the wt CLI to create, browse, open, and delete git worktrees across repos. Use when the user asks to manage worktrees, create isolated branches, or configure worktree defaults.\n---\n\n# wt \u2014 Git Worktree Manager\n\n`wt` is a CLI for managing git worktrees. It provides an interactive TUI to browse, create, open in your IDE, and delete worktrees across multiple repos.\n\n## Commands\n\n### `wt` (no subcommand)\n\nLaunch the interactive TUI. Shows worktrees for the current repo (repo mode) or all registered repos (global mode, when run outside a repo).\n\n**Keybindings in the TUI:**\n\n- Arrow keys / `j`/`k` \u2014 navigate\n- `Enter` \u2014 open worktree in IDE\n- `d` \u2014 delete worktree\n- `c` \u2014 create new worktree (repo mode only)\n- `/` \u2014 search\n- `q` / `Esc` \u2014 quit\n\n### `wt create [branch]`\n\nCreate a new worktree. If `branch` is omitted, prompts interactively.\n\nThe worktree is created as a sibling directory to the repo: `<parent>/<repo-name>-<branch-name>`.\n\nAfter creation, `wt` runs any configured `setup_commands` and opens the worktree in your IDE.\n\nIf the worktree path already exists, `wt create` doesn\'t error \u2014 it prompts you\nto **open it in the IDE** or **quit**. (In a non-interactive shell it errors\nwith a non-zero exit instead of prompting.)\n\n### `wt agent <branch> <plan_prompt> [--mode <mode>]`\n\nCreate a worktree (same as `wt create`) **and** auto-start an AI agent in Zed\'s\nintegrated terminal, pre-filled with `<plan_prompt>` and left interactive for\nyou to take over.\n\n```bash\nwt agent feature/login \'Read the codebase, then propose a plan for login.\'\nwt agent feature/fix \'Fix the bug in payment processing\' --mode auto\nwt agent refactor/api \'Refactor the API layer\' --mode default\n```\n\nThe `--mode` flag sets Claude Code\'s permission mode (defaults to `plan`):\n\n- `default` \u2014 Standard interactive mode with approval for each action\n- `acceptEdits` \u2014 Allow file changes but keep command execution controlled\n- `plan` \u2014 Architecture-first mode with no surprise mutations (default)\n- `auto` \u2014 Claude\'s safety model makes decisions instead of prompting\n- `dontAsk` \u2014 Minimal interruptions in trusted environments\n- `bypassPermissions` \u2014 Skip all permission checks (dangerous, CI/sandbox only)\n\nIt writes a temporary `.zed/tasks.json` running\n`<agent_command> --permission-mode <mode> \'<plan_prompt>\'`, ensures a global Zed keymap chord\n(`agent_trigger_chord`) spawns that task, opens Zed, presses the chord via\n`osascript`, then removes the temporary task so the repo is left clean.\n\n**macOS + Zed only.** Requires Accessibility permission for the app that runs\n`wt` (Zed itself, when run from its integrated terminal). If it isn\'t granted,\n`wt agent` opens the _Privacy & Security \u2192 Accessibility_ settings pane and waits\nfor you to grant it and confirm, then retries automatically. On other platforms\n(or when `ide` is not `zed`) the worktree is still created and opened, but the\nagent is not auto-started.\n\nOver SSH it still works, provided the same user has an active graphical login on\nthe Mac: the keystroke is run inside the GUI session via Launch Services\n(`open -a Terminal` briefly flashes a Terminal window). Grant Accessibility to\nTerminal (not Zed) the first time. With no one logged in graphically there is\nnothing to drive, so it falls back to the manual "press the chord in Zed"\nmessage.\n\nIf the worktree path already exists, `wt agent` prompts you to **open it in the\nIDE**, **open it and start the agent**, or **quit** \u2014 instead of erroring. (In a\nnon-interactive shell it errors with a non-zero exit instead of prompting.)\n\n### `wt config`\n\nOpen the global config file in `$EDITOR` (defaults to `nano`).\n\n```bash\nwt config # open in editor\nwt config --path # print config file path only\n```\n\n### `wt skill`\n\nPrint this skill file to stdout. Useful for piping to agents or copying to a project.\n\n## Configuration\n\nConfig is stored as JSON. Get the path with `wt config --path`.\n\n### Schema\n\n| Key | Type | Default | Description |\n| --------------------- | ---------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `worktree_path` | `string` | `"../"` | Where to place new worktrees, relative to the repo root |\n| `base_branch` | `string` | `"origin/main"` | Branch to base new worktrees on |\n| `setup_commands` | `string[]` | `[]` | Commands to run in a new worktree after creation (e.g. `["npm install"]`) |\n| `teardown_commands` | `string[]` | `[]` | Commands to run in a worktree just before it is deleted (e.g. `["docker compose down -v"]`); on failure you are prompted whether to delete anyway |\n| `ide` | `string` | `"zed"` | IDE command to open worktrees with |\n| `ide_open_args` | `string[]` | `["-n"]` | Arguments passed to the IDE command |\n| `agent_command` | `string` | `"claude --permission-mode plan"` | Base command `wt agent` runs in Zed; any `--permission-mode` flag is replaced by the `--mode` option (defaults to `plan`), then `<plan_prompt>` is appended single-quoted |\n| `agent_trigger_chord` | `string` | `"ctrl-shift-cmd-c"` | Zed keymap chord `wt agent` installs/presses to spawn the agent task |\n| `repos` | `string[]` | `[]` | Registered repo paths (auto-populated on first use) |\n| `repo_overrides` | `object` | `{}` | Per-repo config overrides (see below) |\n\n### Per-repo overrides\n\nOverride any field (`worktree_path`, `base_branch`, `setup_commands`, `teardown_commands`, `ide`, `ide_open_args`, `agent_command`, `agent_trigger_chord`) for a specific repo:\n\n```json\n{\n "base_branch": "origin/main",\n "ide": "zed",\n "repo_overrides": {\n "/path/to/my-repo": {\n "base_branch": "origin/develop",\n "setup_commands": ["npm install", "npm run build"]\n }\n }\n}\n```\n\n## Common workflows\n\n### Create a worktree for a new feature\n\n```bash\ncd /path/to/repo\nwt create feature/my-branch\n```\n\n### Configure setup commands for a repo\n\n```bash\nwt config\n# Then add to the JSON:\n# "repo_overrides": {\n# "/path/to/repo": {\n# "setup_commands": ["npm install"]\n# }\n# }\n```\n\n### Browse all worktrees across repos\n\nRun `wt` from any directory outside a git repo to see worktrees from all registered repos.\n');
|
|
6
|
-
}
|
|
7
|
-
export {
|
|
8
|
-
printSkill
|
|
9
|
-
};
|