@cestoliv/wt 0.3.0-pr13.g878c337 → 0.3.0-pr14.g2b25fef

package/README.md

@@ -34,30 +34,42 @@ infer from this project. Write the result to the config file (find its path with
 ## Quick start
 
 ```bash
-wt                                   # Browse worktrees (interactive TUI)
-wt create my-feat                    # New worktree, opens your IDE
-wt agent my-feat "Plan the feature"  # New worktree + AI agent in Zed (macOS)
-wt config                            # Edit config in $EDITOR
-wt skill                             # Print the skill file (for AI agents)
+wt                                        # Browse worktrees (interactive TUI)
+wt create my-feat                         # New worktree, opens your IDE
+wt agent my-feat "Plan the feature"       # New worktree + AI agent in Zed (macOS)
+wt agent fix-bug "Fix bug" --mode auto    # Use auto mode instead of plan
+wt config                                 # Edit config in $EDITOR
+wt skill                                  # Print the skill file (for AI agents)
 ```
 
-## `wt agent <branch> <plan_prompt>` — the standout
+## `wt agent <branch> <plan_prompt> [--mode <mode>]` — the standout
 
 ```bash
 wt agent feat/login "Read the codebase, then propose a plan for login."
+wt agent fix-bug "Fix the auth bug" --mode auto
+wt agent refactor "Refactor API layer" --mode default
 ```
 
 Creates a worktree exactly like `wt create`, then auto-starts your agent
 (default `claude --permission-mode plan`) in Zed's integrated terminal —
 pre-filled with your prompt and left interactive for you to take over.
 
+**Available modes** (`--mode`, defaults to `plan`):
+
+- `default` — Standard interactive mode with approval for each action
+- `acceptEdits` — Allow file changes but keep command execution controlled
+- `plan` — Architecture-first mode with no surprise mutations (default)
+- `auto` — Claude's safety model makes decisions instead of prompting
+- `dontAsk` — Minimal interruptions in trusted environments
+- `bypassPermissions` — Skip all permission checks (dangerous, CI/sandbox only)
+
 Under the hood it writes a temporary `.zed/tasks.json`, installs a global Zed
 keymap chord, opens Zed and fires the chord via `osascript`, then removes the
 temp task so the repo stays clean.
 
 **Requires** macOS, Zed, and Accessibility permission for the app running `wt`.
-Not granted yet? `wt agent` opens *System Settings → Privacy & Security →
-Accessibility*, waits while you grant it (you may need to quit and reopen the
+Not granted yet? `wt agent` opens _System Settings → Privacy & Security →
+Accessibility_, waits while you grant it (you may need to quit and reopen the
 app), then retries automatically. On other platforms — or when `ide` isn't
 `zed` — the worktree is still created and opened, just without the agent.
 
@@ -104,16 +116,16 @@ erroring (in a non-interactive shell it exits non-zero).
 Edit with `wt config` (`wt config --path` prints the file location —
 `~/Library/Preferences/wt-nodejs/config.json` on macOS).
 
-| Key                   | Default                           | Description                                       |
-| --------------------- | --------------------------------- | ------------------------------------------------- |
-| `ide`                 | `"zed"`                           | Editor to open worktrees with                     |
-| `ide_open_args`       | `["-n"]`                          | Extra args passed to the IDE command              |
-| `base_branch`         | `"origin/main"`                   | Branch new worktrees are created from             |
-| `worktree_path`       | `"../"`                           | Where worktrees are placed (relative to repo)     |
-| `setup_commands`      | `[]`                              | Commands to run in new worktrees                  |
-| `agent_command`       | `"claude --permission-mode plan"` | What `wt agent` runs in Zed (prompt appended)     |
-| `agent_trigger_chord` | `"ctrl-shift-cmd-c"`              | Zed keymap chord `wt agent` installs and presses  |
-| `repo_overrides`      | `{}`                              | Per-repo overrides for any key above              |
+| Key                   | Default                           | Description                                                                         |
+| --------------------- | --------------------------------- | ----------------------------------------------------------------------------------- |
+| `ide`                 | `"zed"`                           | Editor to open worktrees with                                                       |
+| `ide_open_args`       | `["-n"]`                          | Extra args passed to the IDE command                                                |
+| `base_branch`         | `"origin/main"`                   | Branch new worktrees are created from                                               |
+| `worktree_path`       | `"../"`                           | Where worktrees are placed (relative to repo)                                       |
+| `setup_commands`      | `[]`                              | Commands to run in new worktrees                                                    |
+| `agent_command`       | `"claude --permission-mode plan"` | Base command; `--permission-mode` replaced by `--mode` option, then prompt appended |
+| `agent_trigger_chord` | `"ctrl-shift-cmd-c"`              | Zed keymap chord `wt agent` installs and presses                                    |
+| `repo_overrides`      | `{}`                              | Per-repo overrides for any key above                                                |
 
 Override any key per repo:
 

package/SKILL.md

@@ -34,7 +34,7 @@ If the worktree path already exists, `wt create` doesn't error — it prompts yo
 to **open it in the IDE** or **quit**. (In a non-interactive shell it errors
 with a non-zero exit instead of prompting.)
 
-### `wt agent <branch> <plan_prompt>`
+### `wt agent <branch> <plan_prompt> [--mode <mode>]`
 
 Create a worktree (same as `wt create`) **and** auto-start an AI agent in Zed's
 integrated terminal, pre-filled with `<plan_prompt>` and left interactive for
@@ -42,25 +42,31 @@ you to take over.
 
 ```bash
 wt agent feature/login 'Read the codebase, then propose a plan for login.'
+wt agent feature/fix 'Fix the bug in payment processing' --mode auto
+wt agent refactor/api 'Refactor the API layer' --mode default
 ```
 
+The `--mode` flag sets Claude Code's permission mode (defaults to `plan`):
+
+- `default` — Standard interactive mode with approval for each action
+- `acceptEdits` — Allow file changes but keep command execution controlled
+- `plan` — Architecture-first mode with no surprise mutations (default)
+- `auto` — Claude's safety model makes decisions instead of prompting
+- `dontAsk` — Minimal interruptions in trusted environments
+- `bypassPermissions` — Skip all permission checks (dangerous, CI/sandbox only)
+
 It writes a temporary `.zed/tasks.json` running
-`<agent_command> '<plan_prompt>'`, ensures a global Zed keymap chord
+`<agent_command> --permission-mode <mode> '<plan_prompt>'`, ensures a global Zed keymap chord
 (`agent_trigger_chord`) spawns that task, opens Zed, presses the chord via
 `osascript`, then removes the temporary task so the repo is left clean.
 
 **macOS + Zed only.** Requires Accessibility permission for the app that runs
 `wt` (Zed itself, when run from its integrated terminal). If it isn't granted,
-`wt agent` opens the *Privacy & Security → Accessibility* settings pane and waits
+`wt agent` opens the _Privacy & Security → Accessibility_ settings pane and waits
 for you to grant it and confirm, then retries automatically. On other platforms
 (or when `ide` is not `zed`) the worktree is still created and opened, but the
 agent is not auto-started.
 
-Over SSH it still works, provided the same user has an active graphical login on
-the Mac: the keystroke is sent via `launchctl asuser` so it reaches that GUI
-session. With no one logged in graphically there is nothing to drive, so it
-falls back to the manual "press the chord in Zed" message.
-
 If the worktree path already exists, `wt agent` prompts you to **open it in the
 IDE**, **open it and start the agent**, or **quit** — instead of erroring. (In a
 non-interactive shell it errors with a non-zero exit instead of prompting.)
@@ -84,17 +90,17 @@ Config is stored as JSON. Get the path with `wt config --path`.
 
 ### Schema
 
-| Key              | Type       | Default         | Description                                                               |
-| ---------------- | ---------- | --------------- | ------------------------------------------------------------------------- |
-| `worktree_path`  | `string`   | `"../"`         | Where to place new worktrees, relative to the repo root                   |
-| `base_branch`    | `string`   | `"origin/main"` | Branch to base new worktrees on                                           |
-| `setup_commands` | `string[]` | `[]`            | Commands to run in a new worktree after creation (e.g. `["npm install"]`) |
-| `ide`            | `string`   | `"zed"`         | IDE command to open worktrees with                                        |
-| `ide_open_args`  | `string[]` | `["-n"]`        | Arguments passed to the IDE command                                       |
-| `agent_command`  | `string`   | `"claude --permission-mode plan"` | Command `wt agent` runs in Zed; `<plan_prompt>` is appended single-quoted |
-| `agent_trigger_chord` | `string` | `"ctrl-shift-cmd-c"` | Zed keymap chord `wt agent` installs/presses to spawn the agent task    |
-| `repos`          | `string[]` | `[]`            | Registered repo paths (auto-populated on first use)                       |
-| `repo_overrides` | `object`   | `{}`            | Per-repo config overrides (see below)                                     |
+| Key                   | Type       | Default                           | Description                                                                                                                                                               |
+| --------------------- | ---------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `worktree_path`       | `string`   | `"../"`                           | Where to place new worktrees, relative to the repo root                                                                                                                   |
+| `base_branch`         | `string`   | `"origin/main"`                   | Branch to base new worktrees on                                                                                                                                           |
+| `setup_commands`      | `string[]` | `[]`                              | Commands to run in a new worktree after creation (e.g. `["npm install"]`)                                                                                                 |
+| `ide`                 | `string`   | `"zed"`                           | IDE command to open worktrees with                                                                                                                                        |
+| `ide_open_args`       | `string[]` | `["-n"]`                          | Arguments passed to the IDE command                                                                                                                                       |
+| `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 |
+| `agent_trigger_chord` | `string`   | `"ctrl-shift-cmd-c"`              | Zed keymap chord `wt agent` installs/presses to spawn the agent task                                                                                                      |
+| `repos`               | `string[]` | `[]`                              | Registered repo paths (auto-populated on first use)                                                                                                                       |
+| `repo_overrides`      | `object`   | `{}`                              | Per-repo config overrides (see below)                                                                                                                                     |
 
 ### Per-repo overrides
 

package/dist/{agent-52M5VZNS.js → agent-OJLJFW64.js}

@@ -25,11 +25,16 @@ import { homedir } from "os";
 import { dirname, join } from "path";
 import { applyEdits, modify, parse } from "jsonc-parser";
 var AGENT_TASK_LABEL = "wt: agent";
-function buildAgentTask(agentCommand, prompt, label) {
+function buildAgentTask(agentCommand, prompt, label, mode) {
+  let finalCommand = agentCommand;
+  if (mode) {
+    const baseCommand = agentCommand.replace(/--permission-mode\s+\S+/g, "").replace(/\s+/g, " ").trim();
+    finalCommand = `${baseCommand} --permission-mode ${mode}`.trim();
+  }
   const escaped = prompt.replace(/'/g, "'\\''");
   return {
     label,
-    command: `${agentCommand} '${escaped}'`,
+    command: `${finalCommand} '${escaped}'`,
     cwd: "$ZED_WORKTREE_ROOT",
     use_new_terminal: true,
     allow_concurrent_runs: false,
@@ -273,48 +278,17 @@ Note: "${chord}" is already bound in ${keymapPath}; wt's agent binding will take
   return true;
 }
 var ACCESSIBILITY_SETTINGS_URL = "x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility";
-function isHeadlessSession(env = process.env) {
-  return Boolean(env.SSH_CONNECTION || env.SSH_TTY || env.SSH_CLIENT);
-}
-function buildOsascriptCommand(script, opts = {}) {
-  const { env = process.env, uid } = opts;
-  if (isHeadlessSession(env) && typeof uid === "number") {
-    return {
-      command: "launchctl",
-      args: ["asuser", String(uid), "osascript", "-e", script]
-    };
-  }
-  return { command: "osascript", args: ["-e", script] };
-}
-var OSASCRIPT_TIMEOUT_MS = 3e4;
 function defaultRunner(script) {
   return new Promise((resolve) => {
-    const { command, args } = buildOsascriptCommand(script, {
-      uid: process.getuid?.()
-    });
-    const child = spawn(command, args, {
+    const child = spawn("osascript", ["-e", script], {
       stdio: ["ignore", "ignore", "pipe"]
     });
     let stderr = "";
-    let settled = false;
-    const finish = (result) => {
-      if (settled) return;
-      settled = true;
-      clearTimeout(timer);
-      resolve(result);
-    };
-    const timer = setTimeout(() => {
-      child.kill();
-      finish({
-        code: null,
-        stderr: "osascript timed out \u2014 is a user logged into the Mac's graphical session?"
-      });
-    }, OSASCRIPT_TIMEOUT_MS);
     child.stderr?.on("data", (d) => {
       stderr += d.toString();
     });
-    child.on("error", (err) => finish({ code: null, stderr: err.message }));
-    child.on("close", (code) => finish({ code, stderr }));
+    child.on("error", (err) => resolve({ code: null, stderr: err.message }));
+    child.on("close", (code) => resolve({ code, stderr }));
   });
 }
 function isAccessibilityError(stderr) {
@@ -350,9 +324,24 @@ function openAccessibilitySettings(open = defaultOpen) {
 }
 
 // src/commands/agent.ts
+var VALID_MODES = [
+  "default",
+  "acceptEdits",
+  "plan",
+  "auto",
+  "dontAsk",
+  "bypassPermissions"
+];
 var CLEANUP_DELAY_MS = 2e4;
 var delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 async function createAgentWorktree(branch, planPrompt, options = {}) {
+  const mode = options.mode ?? "plan";
+  if (!VALID_MODES.includes(mode)) {
+    console.error(
+      pc.red(`Invalid mode "${mode}". Valid modes: ${VALID_MODES.join(", ")}`)
+    );
+    process.exit(1);
+  }
   const prepared = await prepareWorktree(branch, options);
   if (!prepared) return;
   const { status, config, worktreePath } = prepared;
@@ -365,9 +354,9 @@ async function createAgentWorktree(branch, planPrompt, options = {}) {
       return;
     }
   }
-  await startAgentInWorktree(config, worktreePath, planPrompt);
+  await startAgentInWorktree(config, worktreePath, planPrompt, mode);
 }
-async function startAgentInWorktree(config, worktreePath, planPrompt) {
+async function startAgentInWorktree(config, worktreePath, planPrompt, mode) {
   if (config.ide !== "zed") {
     console.warn(
       pc.yellow(
@@ -387,7 +376,8 @@ async function startAgentInWorktree(config, worktreePath, planPrompt) {
   const task = buildAgentTask(
     config.agent_command,
     planPrompt,
-    AGENT_TASK_LABEL
+    AGENT_TASK_LABEL,
+    mode
   );
   const created = writeAgentTask(worktreePath, task);
   const keymapOk = ensureKeymap(config.agent_trigger_chord, AGENT_TASK_LABEL);
@@ -450,7 +440,7 @@ function reportTriggerFailure(result, chord) {
   }
   console.warn(
     pc.yellow(
-      `\u26A0 Could not auto-start the agent${result.message ? `: ${result.message}` : ""}. In Zed, press ${chord} to start it manually. (Over SSH, this needs the same user logged into the Mac's graphical session.)`
+      `\u26A0 Could not auto-start the agent${result.message ? `: ${result.message}` : ""}. In Zed, press ${chord} to start it manually.`
     )
   );
 }

package/dist/cli.js

@@ -3,7 +3,7 @@
 // src/cli.ts
 import { Command } from "commander";
 var program = new Command();
-program.name("wt").description("Git worktree manager").version("0.3.0-pr13.g878c337").action(async () => {
+program.name("wt").description("Git worktree manager").version("0.3.0-pr14.g2b25fef").action(async () => {
   const { runList } = await import("./list-VPPPO26E.js");
   await runList();
 });
@@ -11,10 +11,16 @@ program.command("create [branch]").description("Create a new worktree").action(a
   const { createWorktree } = await import("./create-RWGSJRM5.js");
   await createWorktree(branch);
 });
-program.command("agent <branch> <plan_prompt>").description("Create a worktree and auto-start an AI agent in Zed (macOS)").action(async (branch, planPrompt) => {
-  const { createAgentWorktree } = await import("./agent-52M5VZNS.js");
-  await createAgentWorktree(branch, planPrompt);
-});
+program.command("agent <branch> <plan_prompt>").description("Create a worktree and auto-start an AI agent in Zed (macOS)").option(
+  "--mode <mode>",
+  "Claude Code permission mode (default, plan, auto, etc.)",
+  "plan"
+).action(
+  async (branch, planPrompt, options) => {
+    const { createAgentWorktree } = await import("./agent-OJLJFW64.js");
+    await createAgentWorktree(branch, planPrompt, { mode: options.mode });
+  }
+);
 program.command("config").description("Open the config file in $EDITOR").option("--path", "Print the config file path and exit").action(async (options) => {
   if (options.path) {
     const { printConfigPath } = await import("./config-7QMKGWCX.js");
@@ -25,7 +31,7 @@ program.command("config").description("Open the config file in $EDITOR").option(
   }
 });
 program.command("skill").description("Print the wt skill file to stdout").action(async () => {
-  const { printSkill } = await import("./skill-XCOCBZB3.js");
+  const { printSkill } = await import("./skill-CODYQJWN.js");
   printSkill();
 });
 await program.parseAsync(process.argv);

package/dist/skill-CODYQJWN.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+// src/commands/skill.ts
+function printSkill() {
+  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\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| `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`, `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');
+}
+export {
+  printSkill
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cestoliv/wt",
-  "version": "0.3.0-pr13.g878c337",
+  "version": "0.3.0-pr14.g2b25fef",
   "description": "Fast, interactive TUI to browse, create, open, and delete git worktrees across repos.",
   "repository": {
     "type": "git",

package/dist/skill-XCOCBZB3.js

@@ -1,9 +0,0 @@
-#!/usr/bin/env node
-
-// src/commands/skill.ts
-function printSkill() {
-  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>`\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.\'\n```\n\nIt writes a temporary `.zed/tasks.json` running\n`<agent_command> \'<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 sent via `launchctl asuser` so it reaches that GUI\nsession. With no one logged in graphically there is nothing to drive, so it\nfalls back to the manual "press the chord in Zed" message.\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| `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"` | Command `wt agent` runs in Zed; `<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`, `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');
-}
-export {
-  printSkill
-};