webmux 0.18.0 → 0.20.0

package/README.md

@@ -56,7 +56,7 @@ cd /path/to/your/project
 webmux init                     # creates .webmux.yaml
 
 # 4. Start the dashboard
-webmux                          # opens on http://localhost:5111
+webmux serve                         # opens on http://localhost:5111
 ```
 
 ## Prerequisites
@@ -87,6 +87,9 @@ workspace:
   mainBranch: main
   worktreeRoot: __worktrees
   defaultAgent: claude
+  autoPull:
+    enabled: true
+    intervalSeconds: 300
 
 services:
   - name: BE
@@ -110,6 +113,7 @@ profiles:
       - id: frontend
         kind: command
         split: right
+        workingDir: frontend
         command: FRONTEND_PORT=$FRONTEND_PORT npm run dev
 
   sandbox:
@@ -127,9 +131,12 @@ profiles:
       You are running inside a sandboxed container.
       Backend port: ${PORT}. Frontend port: ${FRONTEND_PORT}.
 
-linkedRepos:
-  - repo: myorg/related-service
-    alias: svc
+integrations:
+  github:
+    autoRemoveOnMerge: true
+    linkedRepos:
+      - repo: myorg/related-service
+        alias: svc
 
 startupEnvs:
   NODE_ENV: development
@@ -156,6 +163,8 @@ lifecycleHooks:
 | `workspace.mainBranch` | string | no | Base branch used for new worktrees |
 | `workspace.worktreeRoot` | string | no | Relative or absolute directory for managed worktrees |
 | `workspace.defaultAgent` | string | no | Default agent for new worktrees |
+| `workspace.autoPull.enabled` | boolean | no | Periodically fetch and fast-forward merge the main branch (default: `false`) |
+| `workspace.autoPull.intervalSeconds` | number | no | Seconds between auto-pull attempts (default: `300`, minimum: `30`) |
 | `services[].name` | string | yes | Display name shown in the dashboard |
 | `services[].portEnv` | string | yes | Env var containing the service port |
 | `services[].portStart` | number | no | Base port for auto-allocation |
@@ -165,6 +174,7 @@ lifecycleHooks:
 | `profiles.<name>.panes[]` | array | yes | Pane layout for that profile |
 | `profiles.<name>.panes[].kind` | string | yes | `agent`, `shell`, or `command` |
 | `profiles.<name>.panes[].command` | string | yes (for `command`) | Startup command run inside the pane |
+| `profiles.<name>.panes[].workingDir` | string | no | Directory to `cd` into before running a command pane startup command |
 | `profiles.default.systemPrompt` | string | no | Agent system prompt; `${VAR}` placeholders expanded at runtime |
 | `profiles.default.envPassthrough` | string[] | no | Env vars passed to the agent process |
 | `profiles.sandbox.image` | string | yes (if used) | Docker image for containers |
@@ -173,6 +183,7 @@ lifecycleHooks:
 | `profiles.sandbox.mounts[].hostPath` | string | yes | Host path to mount (`~` expands to `$HOME`) |
 | `profiles.sandbox.mounts[].guestPath` | string | no | Container mount path (defaults to `hostPath`) |
 | `profiles.sandbox.mounts[].writable` | boolean | no | `true` for read-write; omit or `false` for read-only |
+| `integrations.github.autoRemoveOnMerge` | boolean | no | Automatically remove worktrees when their PR is merged (default: `false`) |
 | `integrations.github.linkedRepos[].repo` | string | yes | GitHub repo slug (e.g. `org/repo`) |
 | `integrations.github.linkedRepos[].alias` | string | no | Short label for the UI |
 | `startupEnvs.<KEY>` | string or boolean | no | Extra env vars materialized into worktree runtime env |