chore: add workmux config for worktree-based development (#8015)

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

.gitignore

@@ -14,6 +14,9 @@ backend/.minio-data
 !.aiderignore
 rust-client/Cargo.toml
 
+# Worktree-generated port isolation
+.env.local
+
 # Symlinked cache directories (for git worktrees)
 backend/target
 frontend/node_modules

.workmux.yaml

@@ -0,0 +1,47 @@
+main_branch: main
+
+merge_strategy: rebase
+# worktree_dir: .worktrees
+
+worktree_naming: basename
+
+worktree_prefix: ""
+
+# Default: "wm-"
+window_prefix: "wm-"
+
+auto_name:
+  model: "claude-sonnet-4.6"
+  system_prompt: "Generate a kebab-case git branch name."
+  background: true  # Always run in background when using --auto-name
+
+
+# Commands to run in new worktree before tmux window opens.
+# These block window creation - use for short tasks only.
+# Use "<global>" to inherit from global config.
+# Set to empty list to disable: `post_create: []`
+# post_create:
+#   - "<global>"
+#   - mise use
+post_create:
+  - ./scripts/worktree-env
+
+panes:
+  - command: <agent>
+    focus: true
+  - command: "[ -f .env.local ] && source .env.local; cd backend && PORT=${BACKEND_PORT:-8000} cargo run"
+    split: horizontal
+  - command: "[ -f .env.local ] && source .env.local; cd frontend && REMOTE=${REMOTE:-http://localhost:${BACKEND_PORT:-8000}} npm run dev -- --port ${FRONTEND_PORT:-3000}"
+    split: vertical
+
+files:
+  copy:
+    - backend/.env
+    - scripts/
+  symlink:
+    - frontend/node_modules
+    - frontend/.svelte-kit
+
+sandbox:
+  enabled: false
+  toolchain: off

backend/.workmux.yaml

@@ -0,0 +1,8 @@
+panes:
+  # Pane 1: Install dependencies, then start dev server
+  - command: cargo run
+
+  # Pane 2: AI agent
+  - command: <agent>
+    split: horizontal
+    focus: true

frontend/.workmux.yaml

@@ -0,0 +1,15 @@
+panes:
+  # Pane 1: Install dependencies, then start dev server
+  - command: npm install && npm run generate-backend-client && npm run dev
+
+  # Pane 2: AI agent
+  - command: <agent>
+    split: horizontal
+    focus: true
+
+files:
+  copy:
+    - .env
+
+  symlink:
+    - node_modules

scripts/worktree-env

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+port_in_use() {
+  lsof -nP -iTCP:"$1" -sTCP:LISTEN &>/dev/null
+}
+
+find_port() {
+  local port=$1
+  while port_in_use "$port"; do
+    ((port++))
+  done
+  echo "$port"
+}
+
+# Hash the handle to get a deterministic port offset (0-99)
+hash=$(echo -n "$WM_HANDLE" | md5sum | cut -c1-4)
+offset=$((16#$hash % 100))
+
+# Find available ports starting from the hash-based offset
+backend_port=$(find_port $((8000 + offset * 10)))
+frontend_port=$(find_port $((3000 + offset * 10)))
+
+# Generate .env.local with port overrides
+cat > .env.local <<EOF
+BACKEND_PORT=$backend_port
+FRONTEND_PORT=$frontend_port
+REMOTE=http://localhost:$backend_port
+EOF
+
+echo "Created .env.local with ports: backend=$backend_port, frontend=$frontend_port"