feat: add post-create hooks and config editor (v0.3.0)

- Add post-create hooks to run commands after creating worktrees (e.g., npm install)
- Add config editor (press 'c') to edit hooks from the TUI
- Add first-time setup prompt when no config exists
- Stream hook output to TUI in real-time
- Handle hook failures with option to continue or cancel
- Add .opencode-worktree.json config file support
- Update keybindings and documentation

Author: arturosdg

.gitignore

@@ -2,3 +2,4 @@ node_modules
 dist
 .DS_Store
 *.log
+.opencode-worktree.json

README.md

@@ -7,7 +7,8 @@ Terminal UI for managing git worktrees and launching `opencode` in the selected
 - Lists all worktrees with branch, path, and metadata
 - Worktree metadata display: last edited time, dirty status, remote tracking
 - Status indicators: `[main]` for main worktree, `[*]` for uncommitted changes, `[local]` for local-only branches
-- Create new worktrees directly from the TUI (returns to list with new worktree preselected)
+- Create new worktrees directly from the TUI
+- Post-create hooks: automatically run commands (e.g., `npm install`) after creating a worktree
 - Open worktree folder in file manager
 - Unlink worktrees (remove directory, keep branch)
 - Delete worktrees and local branches (never remote)
@@ -45,6 +46,7 @@ opencode-worktree /path/to/your/repo
 - `o`: open worktree folder in file manager (Finder/Explorer)
 - `d`: enter multi-select delete mode (press again to confirm deletion)
 - `n`: create new worktree
+- `c`: edit configuration (post-create hooks)
 - `r`: refresh list
 - `q` or `Esc`: quit (or cancel dialogs/modes)
 
@@ -55,6 +57,44 @@ opencode-worktree /path/to/your/repo
 3. Press `d` again to confirm and choose unlink/delete action
 4. Press `Esc` to cancel and return to normal mode
 
+## Configuration
+
+You can configure per-repository settings by creating a `.opencode-worktree.json` file in your repository root.
+
+### First-time setup
+
+When you first run `opencode-worktree` in a repository without a configuration file, you'll be prompted to configure a post-create hook. You can also skip this step and configure it later by pressing `c`.
+
+### Editing configuration
+
+Press `c` at any time to edit your configuration. Currently, this allows you to set or modify the post-create hook command.
+
+### Post-create hooks
+
+Run a command automatically after creating a new worktree. Useful for installing dependencies.
+
+```json
+{
+  "postCreateHook": "npm install"
+}
+```
+
+The hook output is streamed to the TUI in real-time. If the hook fails, you can choose to open opencode anyway or cancel.
+
+**Examples:**
+
+```json
+{
+  "postCreateHook": "bun install"
+}
+```
+
+```json
+{
+  "postCreateHook": "npm install && npm run setup"
+}
+```
+
 ## Update notifications
 
 When a new version is published to npm, the CLI will show a non-intrusive update message on the next run.

ROADMAP.md

@@ -21,13 +21,10 @@
 
 ## v0.3 - Enhanced Navigation & Configuration
 
-### Navigation
-
-- [ ] **Switch between worktrees** - Open a new terminal pane in the selected worktree instead of launching opencode
-
 ### Configuration
 
-- [ ] **Post-create hooks** - Run custom commands after creating a worktree (e.g., `npm install`)
+- [x] **Post-create hooks** - Run custom commands after creating a worktree (e.g., `npm install`) with streaming output and failure handling
+- [x] **Config editor** - Press `c` to edit configuration, with first-time setup prompt
 
 ---
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-worktree",
-  "version": "0.2.9",
+  "version": "0.3.0",
   "private": false,
   "type": "module",
   "description": "TUI for managing git worktrees with opencode integration.",

src/config.ts

@@ -0,0 +1,69 @@
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+
+export type Config = {
+  postCreateHook?: string;
+};
+
+const CONFIG_FILENAME = ".opencode-worktree.json";
+
+/**
+ * Get the path to the config file for a repo
+ */
+export const getConfigPath = (repoRoot: string): string => {
+  return join(repoRoot, CONFIG_FILENAME);
+};
+
+/**
+ * Check if a config file exists for the repo
+ */
+export const configExists = (repoRoot: string): boolean => {
+  return existsSync(getConfigPath(repoRoot));
+};
+
+/**
+ * Load per-repo configuration from .opencode-worktree.json in the repo root
+ */
+export const loadRepoConfig = (repoRoot: string): Config => {
+  const configPath = getConfigPath(repoRoot);
+
+  if (!existsSync(configPath)) {
+    return {};
+  }
+
+  try {
+    const content = readFileSync(configPath, "utf8");
+    const parsed = JSON.parse(content);
+
+    // Validate the config structure
+    if (typeof parsed !== "object" || parsed === null) {
+      return {};
+    }
+
+    const config: Config = {};
+
+    if (typeof parsed.postCreateHook === "string") {
+      config.postCreateHook = parsed.postCreateHook;
+    }
+
+    return config;
+  } catch {
+    // If we can't read or parse the config, return empty
+    return {};
+  }
+};
+
+/**
+ * Save configuration to .opencode-worktree.json in the repo root
+ */
+export const saveRepoConfig = (repoRoot: string, config: Config): boolean => {
+  const configPath = getConfigPath(repoRoot);
+
+  try {
+    const content = JSON.stringify(config, null, 2) + "\n";
+    writeFileSync(configPath, content, "utf8");
+    return true;
+  } catch {
+    return false;
+  }
+};

src/hooks.ts

@@ -0,0 +1,62 @@
+import { spawn } from "node:child_process";
+
+export type HookResult = {
+  success: boolean;
+  exitCode: number | null;
+};
+
+export type HookCallbacks = {
+  onOutput: (data: string) => void;
+  onComplete: (result: HookResult) => void;
+};
+
+/**
+ * Run a post-create hook command with streaming output
+ * Returns a function to abort the hook if needed
+ */
+export const runPostCreateHook = (
+  worktreePath: string,
+  command: string,
+  callbacks: HookCallbacks
+): (() => void) => {
+  const shell = process.platform === "win32" ? "cmd" : "/bin/sh";
+  const shellFlag = process.platform === "win32" ? "/c" : "-c";
+
+  const child = spawn(shell, [shellFlag, command], {
+    cwd: worktreePath,
+    stdio: ["ignore", "pipe", "pipe"],
+    env: { ...process.env },
+  });
+
+  // Stream stdout
+  child.stdout?.on("data", (data: Buffer) => {
+    callbacks.onOutput(data.toString());
+  });
+
+  // Stream stderr
+  child.stderr?.on("data", (data: Buffer) => {
+    callbacks.onOutput(data.toString());
+  });
+
+  // Handle completion
+  child.on("close", (code: number | null) => {
+    callbacks.onComplete({
+      success: code === 0,
+      exitCode: code,
+    });
+  });
+
+  // Handle errors
+  child.on("error", (err: Error) => {
+    callbacks.onOutput(`Error: ${err.message}\n`);
+    callbacks.onComplete({
+      success: false,
+      exitCode: null,
+    });
+  });
+
+  // Return abort function
+  return () => {
+    child.kill("SIGTERM");
+  };
+};