webmux 0.38.0 → 0.39.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -65,7 +65,7 @@ bun install -g webmux
65
65
 
66
66
  # 3. Set up your project
67
67
  cd /path/to/your/project
68
- webmux init # creates .webmux.yaml
68
+ webmux init # creates .webmux.yaml (the only per-project step)
69
69
 
70
70
  # 4. Start the dashboard
71
71
  webmux serve # dashboard on http://localhost:5111
@@ -73,6 +73,23 @@ webmux serve # dashboard on http://localhost:5111
73
73
 
74
74
  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.
75
75
 
76
+ ### One dashboard, many projects
77
+
78
+ 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.
79
+
80
+ - 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.
81
+ - Switch projects, or add/remove them, from the project switcher in the dashboard.
82
+ - Or manage them from the CLI:
83
+
84
+ ```bash
85
+ webmux project ls # list projects the dashboard is serving
86
+ webmux project add ~/code/other # add another project (persists; must have a .webmux.yaml)
87
+ webmux project rm other # remove by prefix
88
+ webmux project migrate # fold other running webmux servers into this one
89
+ ```
90
+
91
+ 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).
92
+
76
93
  ## Prerequisites
77
94
 
78
95
  | Tool | Purpose |