windmill-labs
diff --git a/‎README.md‎
Lines changed: 18 additions & 1 deletion b/‎README.md‎
Lines changed: 18 additions & 1 deletion
diff --git a/‎backend/src/__tests__/domain-policies.test.ts‎
Lines changed: 17 additions & 39 deletions b/‎backend/src/__tests__/domain-policies.test.ts‎
Lines changed: 17 additions & 39 deletions
diff --git a/‎backend/src/__tests__/instance-registry.test.ts‎
Lines changed: 9 additions & 15 deletions b/‎backend/src/__tests__/instance-registry.test.ts‎
Lines changed: 9 additions & 15 deletions
diff --git a/‎backend/src/__tests__/peer-routing-integration.test.ts‎
Lines changed: 0 additions & 90 deletions b/‎backend/src/__tests__/peer-routing-integration.test.ts‎
Lines changed: 0 additions & 90 deletions
diff --git a/‎backend/src/__tests__/peer-routing.test.ts‎
Lines changed: 0 additions & 69 deletions b/‎backend/src/__tests__/peer-routing.test.ts‎
Lines changed: 0 additions & 69 deletions
@@ -65,14 +65,31 @@ bun install -g webmux
 
 # 3. Set up your project
 cd /path/to/your/project
-webmux init                     # creates .webmux.yaml
+webmux init                     # creates .webmux.yaml (the only per-project step)
 
 # 4. Start the dashboard
 webmux serve                         # dashboard on http://localhost:5111
 ```
 
 The primary dashboard remains the best desktop experience. On mobile, the same dashboard swaps the embedded terminal for a chat view on open Codex and Claude worktrees.
 
+### One dashboard, many projects
+
+You don't run a separate webmux per project. A single `webmux serve` serves **every project you've added, on one dashboard and one port** — each scoped under its own `/<prefix>` URL. The only per-project requirement is a `.webmux.yaml` in the repo (created by `webmux init`); webmux auto-loads it.
+
+- The repo you launch `webmux serve` in is served automatically — but only for that session. It isn't written to `~/.webmux/projects.json`, so it isn't remembered across restarts unless you `webmux project add` it.
+- Switch projects, or add/remove them, from the project switcher in the dashboard.
+- Or manage them from the CLI:
+
+```bash
+webmux project ls                 # list projects the dashboard is serving
+webmux project add ~/code/other   # add another project (persists; must have a .webmux.yaml)
+webmux project rm other           # remove by prefix
+webmux project migrate            # fold other running webmux servers into this one
+```
+
+Projects added with `webmux project add` are remembered in `~/.webmux/projects.json` and reloaded on the next start. Run webmux as a single service per machine with `webmux service install`. If you're upgrading from an older setup that ran one service per project, `webmux project migrate` consolidates those leftover servers into this one (the dashboard shows a banner when it detects them).
+
 ## Prerequisites
 
 | Tool | Purpose |
 
@@ -1,9 +1,8 @@
 import { describe, expect, it } from "bun:test";
 import {
   allocateServicePorts,
-  deriveInstancePrefix,
-  isValidInstancePrefix,
-  sanitizeInstancePrefix,
+  deriveProjectPrefix,
+  sanitizeProjectPrefix,
 } from "../domain/policies";
 
 describe("allocateServicePorts", () => {
@@ -46,64 +45,43 @@ describe("allocateServicePorts", () => {
   });
 });
 
-describe("sanitizeInstancePrefix", () => {
+describe("sanitizeProjectPrefix", () => {
   it("lowercases and replaces non-alphanumerics with hyphens", () => {
-    expect(sanitizeInstancePrefix("My Project")).toBe("my-project");
-    expect(sanitizeInstancePrefix("Some_Repo.v2")).toBe("some-repo-v2");
+    expect(sanitizeProjectPrefix("My Project")).toBe("my-project");
+    expect(sanitizeProjectPrefix("Some_Repo.v2")).toBe("some-repo-v2");
   });
 
   it("collapses runs of hyphens and trims edges", () => {
-    expect(sanitizeInstancePrefix("--__foo bar__--")).toBe("foo-bar");
+    expect(sanitizeProjectPrefix("--__foo bar__--")).toBe("foo-bar");
   });
 
   it("returns an empty string when nothing usable remains", () => {
-    expect(sanitizeInstancePrefix("***")).toBe("");
+    expect(sanitizeProjectPrefix("***")).toBe("");
   });
 });
 
-describe("isValidInstancePrefix", () => {
-  it("accepts alphanumeric (any case) and hyphens", () => {
-    expect(isValidInstancePrefix("webmux")).toBe(true);
-    expect(isValidInstancePrefix("webmux-2")).toBe(true);
-    expect(isValidInstancePrefix("ab12-cd")).toBe(true);
-    expect(isValidInstancePrefix("Webmux")).toBe(true);
-  });
-
-  it("rejects leading hyphen, spaces, or empty", () => {
-    expect(isValidInstancePrefix("-bad")).toBe(false);
-    expect(isValidInstancePrefix("has space")).toBe(false);
-    expect(isValidInstancePrefix("")).toBe(false);
-  });
-
-  it("rejects reserved path segments owned by the route map", () => {
-    expect(isValidInstancePrefix("api")).toBe(false);
-    expect(isValidInstancePrefix("ws")).toBe(false);
-    expect(isValidInstancePrefix("assets")).toBe(false);
-  });
-});
-
-describe("deriveInstancePrefix", () => {
+describe("deriveProjectPrefix", () => {
   it("returns the basename when no collision", () => {
-    expect(deriveInstancePrefix("/home/me/projects/webmux", [])).toBe("webmux");
-    expect(deriveInstancePrefix("/srv/widgets/", [])).toBe("widgets");
+    expect(deriveProjectPrefix("/home/me/projects/webmux", [])).toBe("webmux");
+    expect(deriveProjectPrefix("/srv/widgets/", [])).toBe("widgets");
   });
 
   it("falls back to a default when the basename has no alphanumerics", () => {
-    expect(deriveInstancePrefix("/repo/...", [])).toBe("webmux");
+    expect(deriveProjectPrefix("/repo/...", [])).toBe("webmux");
   });
 
   it("appends -2, -3, ... to avoid collisions", () => {
-    expect(deriveInstancePrefix("/a/webmux", ["webmux"])).toBe("webmux-2");
-    expect(deriveInstancePrefix("/a/webmux", ["webmux", "webmux-2"])).toBe("webmux-3");
+    expect(deriveProjectPrefix("/a/webmux", ["webmux"])).toBe("webmux-2");
+    expect(deriveProjectPrefix("/a/webmux", ["webmux", "webmux-2"])).toBe("webmux-3");
   });
 
   it("sanitizes weird basenames", () => {
-    expect(deriveInstancePrefix("/projects/My Cool App!", [])).toBe("my-cool-app");
+    expect(deriveProjectPrefix("/projects/My Cool App!", [])).toBe("my-cool-app");
   });
 
   it("never returns a reserved prefix even when the basename matches one", () => {
-    expect(deriveInstancePrefix("/srv/api", [])).toBe("api-2");
-    expect(deriveInstancePrefix("/srv/ws", [])).toBe("ws-2");
-    expect(deriveInstancePrefix("/srv/assets", [])).toBe("assets-2");
+    expect(deriveProjectPrefix("/srv/api", [])).toBe("api-2");
+    expect(deriveProjectPrefix("/srv/ws", [])).toBe("ws-2");
+    expect(deriveProjectPrefix("/srv/assets", [])).toBe("assets-2");
   });
 });
@@ -20,11 +20,9 @@ describe("instance-registry", () => {
 
   function makeEntry(overrides: Partial<InstanceEntry> = {}): InstanceEntry {
     return {
-      prefix: "demo",
       port: 5111,
       projectDir: "/repo/demo",
       pid: process.pid,
-      startedAt: Date.now(),
       ...overrides,
     };
   }
@@ -67,28 +65,24 @@ describe("instance-registry", () => {
     const { dir, registry } = await freshRegistry();
     registry.register(makeEntry({ port: 5111 }));
     writeFileSync(join(dir, "5112.json"), "not json");
-    writeFileSync(join(dir, "5113.json"), JSON.stringify({ prefix: 1 }));
+    writeFileSync(join(dir, "5113.json"), JSON.stringify({ port: 1 }));
 
     expect(registry.listLive().map((e) => e.port)).toEqual([5111]);
   });
 
-  it("rejects entries whose prefix is not a valid instance prefix", async () => {
+  it("rejects entries missing required fields", async () => {
     const { dir, registry } = await freshRegistry();
-    registry.register(makeEntry({ port: 5111, prefix: "good" }));
-    // Forge an entry with a bad prefix (leading hyphen, reserved, etc.)
+    registry.register(makeEntry({ port: 5111 }));
+    // Missing projectDir.
     writeFileSync(join(dir, "5112.json"), JSON.stringify({
-      prefix: "-bad",
       port: 5112,
-      projectDir: "/x",
       pid: process.pid,
-      startedAt: 1,
     }));
+    // Wrong type for port.
     writeFileSync(join(dir, "5113.json"), JSON.stringify({
-      prefix: "api",
-      port: 5113,
+      port: "nope",
       projectDir: "/x",
       pid: process.pid,
-      startedAt: 1,
     }));
 
     expect(registry.listLive().map((e) => e.port)).toEqual([5111]);
@@ -110,11 +104,11 @@ describe("instance-registry", () => {
 
   it("overwrites an existing entry when registering the same port twice", async () => {
     const { registry } = await freshRegistry();
-    registry.register(makeEntry({ port: 5111, prefix: "alpha" }));
-    registry.register(makeEntry({ port: 5111, prefix: "beta" }));
+    registry.register(makeEntry({ port: 5111, projectDir: "/repo/alpha" }));
+    registry.register(makeEntry({ port: 5111, projectDir: "/repo/beta" }));
 
     const entries = registry.listLive();
     expect(entries).toHaveLength(1);
-    expect(entries[0]?.prefix).toBe("beta");
+    expect(entries[0]?.projectDir).toBe("/repo/beta");
   });
 });