diff --git a/.chezmoidata/packages.yaml b/.chezmoidata/packages.yaml
index 51d583c..0db438a 100644
--- a/.chezmoidata/packages.yaml
+++ b/.chezmoidata/packages.yaml
@@ -152,3 +152,5 @@ packages:
       - crush
       # omp: prebuilt release binaries; not in the mise registry
       - github:can1357/oh-my-pi
+      # workmux: worktree + tmux session per agent (~/.config/workmux, prefix w)
+      - workmux
diff --git a/docs/shell/scripts.md b/docs/shell/scripts.md
index e530f3f..df375f0 100644
--- a/docs/shell/scripts.md
+++ b/docs/shell/scripts.md
@@ -54,6 +54,7 @@ Several scripts below also exist as fish functions of the same name (`ai`, `c2p`
 | [`projects-sync`](#projects-sync) | bash | Symlink every `~/Code` repo into `~/Projects` |
 | [`pj-palette`](#pj-palette) | bash | pj's tasks plus quick actions as a tmux-palette source |
 | [`tmux-sessions`](#tmux-sessions) | bash | Session/window/zoxide switcher as a tmux-palette source |
+| [`workmux-palette`](#workmux-palette) | bash | workmux agents and worktrees as a tmux-palette source |
 | [`yazi-nvim-open`](#yazi-nvim-open) | sh | yazi opener that targets the host Neovim |
 
 ## ai
@@ -475,6 +476,35 @@ pj-palette's background task sessions (`@pj_task`) are left out. Sessions are ta
 
 **Needs:** tmux, `jq`, `zoxide`.
 
+## workmux-palette
+
+```sh
+workmux-palette
+workmux-palette --add BRANCH
+workmux-palette --popup DIR CMD…
+workmux-palette --do DIR CMD…
+```
+
+The source of the **Workmux** [tmux command palette](../terminal/tmux.md#command-palette) (`palettes/workmux.json`) for [workmux](../tools/workmux.md). Open it with tmux `prefix w` or the "Workmux" item in the main palette.
+
+With no arguments it prints palette items as JSON, grouped by category:
+
+| Group | Items | Action |
+| --- | --- | --- |
+| Agents | Every agent `workmux status --all --json` tracks in this tmux server: waiting (yellow), done (green), working (blue), then idle, most recent first. Title `<repo>/<handle>`, description status, time since the change, and the pane title | `switch-client` to the agent's pane |
+| Worktrees: `<repo>` | The active pane's repo's worktrees (`workmux list --json`, main checkout left out): branch, open/closed, dirty, path. Open ones are green | `workmux open` (starts the session if closed) |
+| New | **New worktree from a prompt**, when the pane is in a repo | `workmux add -A -e` in a popup: `$EDITOR` for the prompt, omp names the branch |
+| Workmux | **Dashboard** (90% popup), **Sidebar** (toggle), **Last done** (`workmux last-done`) | |
+| Close | One per open worktree | `workmux close`: ends the session, keeps worktree and branch |
+| Merge | One per worktree | `workmux merge` in a popup |
+| Remove | One per worktree | `workmux remove` in a popup (asks before deleting unmerged commits) |
+
+**`--add BRANCH`** is the palette's `query` item: the typed text, listed after the matches, becomes `workmux add BRANCH` in the active pane's directory, so a branch name that matches nothing creates its worktree and session and switches to it.
+
+**`--popup DIR CMD…`** runs CMD in DIR in an 80% × 60% popup (argv form, so nothing is re-parsed by a shell or by tmux formats). The popup closes when CMD succeeds; on failure it shows `[exit N]` and waits for a key. **`--do DIR CMD…`** runs CMD in place and shows the last output line as a tmux message when it fails.
+
+**Needs:** tmux, `jq`, `git`, `workmux`.
+
 ## yazi-nvim-open
 
 ```sh
diff --git a/docs/terminal/tmux.md b/docs/terminal/tmux.md
index 33f73e8..1a6598f 100644
--- a/docs/terminal/tmux.md
+++ b/docs/terminal/tmux.md
@@ -43,6 +43,7 @@ These settings are what [yazi](../tools/yazi.md) needs inside tmux. `allow-passt
 | `prefix /` | Copy mode, then search upward |
 | `prefix o` | Sessions palette ([`tmux-sessions`](../shell/scripts.md#tmux-sessions)): fuzzy-find the other sessions, every window of every session, zoxide's and `~/.config`'s directories, and Rename/Kill items per session. Typed text that is not a session starts one by that name in its zoxide match |
 | `prefix t` | Project Tasks palette ([`pj-palette`](../shell/scripts.md#pj-palette)): install/dev/sync/make/compose quick actions plus every `pj` task. One-off tasks run in a full-width bottom split (25% of the window); dev servers and `docker compose up` run in a background `<session>:<tool-and-command>` session shown in a popup (`q` hides, `ctrl-c` asks `y/n` then stops), listed under Running to reopen |
+| `prefix w` | Workmux palette ([`workmux-palette`](../shell/scripts.md#workmux-palette)): tracked agents by status, the repo's worktrees with Close/Merge/Remove, new worktree from the typed branch or a prompt, dashboard, sidebar, last-done. Replaces tmux's `choose-tree`, which the Sessions palette covers. See [workmux](../tools/workmux.md) |
 | `prefix y` / `prefix e` | Yazi / Neovim in a new window in the pane cwd (Ghostty `ctrl+shift+f` / `ctrl+shift+e`) |
 | `prefix g` | Lazygit in a 90% popup in the pane cwd (Ghostty `ctrl+shift+g`) |
 | `prefix a` | omp in a background session `<session>:omp` (pane cwd), shown in a popup docked bottom-right (35% × 60%) and listed in the [omp palette](../shell/scripts.md#pj-palette) and under Running in the tasks palette. In the popup, `ctrl-c` hides it and `ctrl-q` quits omp. Inside any background-task popup, `prefix a` hides it too, so Ghostty `ctrl+shift+a` toggles omp |
@@ -82,6 +83,8 @@ Each window reads `<index> <icon> <label>`, updating as you work, the same rule
 
 Labels longer than 27 characters end in `…`. The icon comes from tmux-nerd-font-window-name.
 
+A window whose agent workmux tracks shows its status icon after the label (`#{@workmux_status}`: working, waiting, done; waiting and done clear when the window gets focus). workmux's own `status_format` is off so it does not rewrite these formats. See [workmux](../tools/workmux.md#agent-status).
+
 ## Plugins
 
 | Plugin | Settings |
@@ -99,9 +102,10 @@ Labels longer than 27 characters end in `…`. The icon comes from tmux-nerd-fon
 
 | File | Contents |
 | --- | --- |
-| `commands.json` | The kitty launchers ported as palette items: **Lazygit** (90% popup in the pane's cwd; kitty `ctrl+shift+g`), **Yazi** (new window; kitty `ctrl+shift+f`), **Neovim Split** (nvim in a split to the left, 60% of the pane; alias `nv`; kitty `ctrl+shift+e`), **Shell History (atuin)** (`atuin-pick` in a 25% split below; kitty `ctrl+shift+p`). Also **btop** (80% popup; aliases `top`, `htop`), **Lazydocker** (90% popup in the pane's cwd; alias `dd`), **mandible** (80% popup running [`mandible-pick`](../shell/scripts.md#mandible-pick); alias `man`), **television** (`tv channels`, the [channel picker](../tools/television.md), in a new window in the pane's cwd; alias `tv`), **gitframe** (git diff viewer in a new window in the pane's cwd; alias `gf`), **omp** (opens the omp palette; aliases `agent`, `ai`), **Project Tasks** (opens the tasks palette), **Sessions** (opens the sessions palette; aliases `sx`, `ss`), **Save Sessions**, and **Restore Sessions** (resurrect). Programs are started with `exec`, so the tab icon is the program's, not the shell's |
+| `commands.json` | The kitty launchers ported as palette items: **Lazygit** (90% popup in the pane's cwd; kitty `ctrl+shift+g`), **Yazi** (new window; kitty `ctrl+shift+f`), **Neovim Split** (nvim in a split to the left, 60% of the pane; alias `nv`; kitty `ctrl+shift+e`), **Shell History (atuin)** (`atuin-pick` in a 25% split below; kitty `ctrl+shift+p`). Also **btop** (80% popup; aliases `top`, `htop`), **Lazydocker** (90% popup in the pane's cwd; alias `dd`), **mandible** (80% popup running [`mandible-pick`](../shell/scripts.md#mandible-pick); alias `man`), **television** (`tv channels`, the [channel picker](../tools/television.md), in a new window in the pane's cwd; alias `tv`), **gitframe** (git diff viewer in a new window in the pane's cwd; alias `gf`), **omp** (opens the omp palette; aliases `agent`, `ai`), **Workmux** (opens the workmux palette; aliases `wm`, `worktree`), **Project Tasks** (opens the tasks palette), **Sessions** (opens the sessions palette; aliases `sx`, `ss`), **Save Sessions**, and **Restore Sessions** (resurrect). Programs are started with `exec`, so the tab icon is the program's, not the shell's |
 | `palettes/tasks.json` | The **Project Tasks** palette (`prefix t`, Ghostty `ctrl+shift+p` / `ctrl+shift+space`), fed by [`pj-palette`](../shell/scripts.md#pj-palette): running background tasks under Running, then `bun install`, `bun run dev`, `uv sync`, `uv run python`, `make`, `go run .`, `cargo run`, `docker compose up` as Quick items when the project has them, then every task `pj` finds, grouped by tool. One-off tasks run in a full-width split along the bottom (25% of the window) in their directory; `ctrl-c` stops a running task, and once it has exited, `enter` or `ctrl-c` closes the pane. Dev servers (`dev`/`start`/`serve`/`watch`/`preview` tasks) and `docker compose up` run in a background session `<session>:<tool-and-command>` shown in a popup: `q` hides it with the task still running, `ctrl-c` asks `Stop <session>? (y/n)` and on `y` stops the task and closes it |
 | `palettes/omp.json` | The **omp** palette, fed by [`pj-palette --omp`](../shell/scripts.md#pj-palette): this tmux session's `<session>:omp` (open it, or start it when not running), every other tmux session's running omp, and a Quit item per session. Running agents have a green icon and show `open` or `hidden` |
+| `palettes/workmux.json` | The **Workmux** palette (`prefix w`), fed by [`workmux-palette`](../shell/scripts.md#workmux-palette): Agents (by status), Worktrees of the pane's repo, New, Workmux tools, Close, Merge, Remove. Its `query` item lists the typed text last; `enter` on it runs `workmux-palette --add <text>` (new worktree and session for that branch) |
 | `palettes/sessions.json` | The **Sessions** palette (`prefix o`, Ghostty `ctrl+shift+o`), fed by [`tmux-sessions`](../shell/scripts.md#tmux-sessions): Sessions (the last one first, attached ones green), Windows, Zoxide, Config, Rename, Kill. Its `query` item lists the typed text last; `enter` on it runs `tmux-sessions --new <text>` |
 | `hidden.json` | Hides the built-in **Switch Theme...** item, and with it the Appearance section: the palette stays on the fixed cyberdream `theme.json` |
 | `shortcuts.json` | Ghostty `ctrl+shift` chords shown next to the built-in items they trigger (New Window → `Ctrl+Shift+T`, …) |
diff --git a/docs/tools/README.md b/docs/tools/README.md
index ae3f07b..47f9c93 100644
--- a/docs/tools/README.md
+++ b/docs/tools/README.md
@@ -21,6 +21,7 @@ Packages come from `.chezmoidata/packages.yaml` and are installed by `run_onchan
 | [Hunk](hunk.md) | hunk diff viewer | `dot_config/hunk/config.toml` | `auto` |
 | [drydock](drydock.md) | drydock repo fleet view | `dot_config/drydock/config.toml` | n/a |
 | [television](television.md) | tv fuzzy picker, custom cables | external repo via `.chezmoiexternals/television.toml` | `cyberdream-transparent` |
+| [workmux](workmux.md) | worktree + tmux session per agent | `dot_config/workmux/config.yaml` | n/a (palette: cyberdream) |
 | [LeetCode](leetcode.md) | leetcode CLI, `lc-elir` | `dot_leetcode/` | n/a |
 | [SSH and mosh](ssh.md) | ssh, mosh | `private_dot_ssh/config` | n/a |
 
diff --git a/docs/tools/workmux.md b/docs/tools/workmux.md
new file mode 100644
index 0000000..611913c
--- /dev/null
+++ b/docs/tools/workmux.md
@@ -0,0 +1,31 @@
+# workmux
+
+workmux global config: one git worktree and one tmux session per agent, driven from the Workmux palette.
+
+[workmux](https://workmux.dev) pairs each git worktree with a tmux target and starts an agent in it. Here every worktree gets its own tmux session (an omp window and an nvim window), and the [Workmux palette](../shell/scripts.md#workmux-palette) (tmux `prefix w`, or `ctrl+space` → Workmux) covers the lifecycle: open, new, close, merge, remove, and jumping to agents by status.
+
+| | |
+| --- | --- |
+| Source | `dot_config/workmux/config.yaml` |
+| Target | `~/.config/workmux/config.yaml` (symlink) |
+| Packages | `workmux` under `packages.shared.mise` |
+| Status tracking | omp extension `~/.omp/agent/extensions/workmux-status.ts` (in the [omp external](../chezmoi/externals-and-ignore.md)) |
+
+## config.yaml
+
+| Key | Value | Effect |
+| --- | --- | --- |
+| `nerdfont` | `true` | Nerd Font icons in workmux's own UI. |
+| `mode` | `session` | Each worktree is a tmux session, so the session pill, Ghostty's window title, and the [Sessions palette](../shell/scripts.md#tmux-sessions) list it like any other session. |
+| `window_prefix` | `"{project}/"` | Session names read `<repo>/<handle>`. |
+| `worktree_dir` | `~/Work/{project}` | Worktrees land in `~/Work/<repo>/<handle>`, next to worktrunk's `~/Work/<repo>-<branch>`. |
+| `base_branch` | `auto` | New branches start from the repo's main branch, not the branch the pane is on. |
+| `agent` | `omp` | `<agent>` runs omp; it receives `-p`/`-P`/`-e` prompts and names branches for `add -A`. |
+| `windows` | omp (focused), nvim | Two unnamed windows, so `automatic-rename-format` labels them like every other tab. |
+| `status_format` | `false` | workmux leaves `window-status-format` alone; `tmux.conf` renders `#{@workmux_status}` itself (see [Window tabs](../terminal/tmux.md#window-tabs)). |
+
+A `.workmux.yaml` in a repo overrides any of these.
+
+## Agent status
+
+The omp extension reports `working`, `waiting`, and `done`. workmux stores the icon in the window option `@workmux_status`, which the tab formats print after the label. The palette's Agents group reads `workmux status --all --json`.
diff --git a/dot_config/workmux/config.yaml b/dot_config/workmux/config.yaml
new file mode 100644
index 0000000..5df7830
--- /dev/null
+++ b/dot_config/workmux/config.yaml
@@ -0,0 +1,34 @@
+# workmux global config (https://workmux.dev). One tmux session per worktree:
+# an omp window (focused, gets the prompt) and an nvim window. Start work from
+# the Workmux palette (prefix w, or ctrl+space → Workmux; ~/.local/bin/
+# workmux-palette) or `workmux add <branch>` in a repo. A .workmux.yaml in a
+# repo overrides any of this.
+
+nerdfont: true
+
+# Session mode: the session pill and Ghostty's window title read
+# <repo>/<handle>; the tmux-sessions palette lists them like any session.
+mode: session
+window_prefix: "{project}/"
+
+# Next to worktrunk's ~/Work/<repo>-<branch>: ~/Work/<repo>/<handle>.
+worktree_dir: ~/Work/{project}
+
+# New work branches off the main branch, not whatever branch the pane is on.
+base_branch: auto
+
+# omp gets the prompt (-p/-P/-e) and names branches for `add -A`.
+agent: omp
+
+# Windows stay unnamed so tmux.conf's automatic-rename-format labels them
+# (omp icon + repo, nvim icon + file) like every other tab.
+windows:
+  - panes:
+      - command: <agent>
+        focus: true
+  - panes:
+      - command: nvim
+
+# tmux.conf's window-status formats render #{@workmux_status} themselves;
+# workmux's own format would replace the powerline tabs.
+status_format: false
diff --git a/dot_local/bin/executable_workmux-palette b/dot_local/bin/executable_workmux-palette
new file mode 100755
index 0000000..55aa391
--- /dev/null
+++ b/dot_local/bin/executable_workmux-palette
@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+# workmux-palette — workmux as a tmux-palette source (the "workmux" palette,
+# ~/.config/tmux-palette/palettes/workmux.json).
+#
+#   workmux-palette              print palette items (JSON): every agent
+#                                workmux tracks in this tmux server (waiting,
+#                                then done, then working), the worktrees of the
+#                                active pane's repo with Close/Merge/Remove
+#                                items, New from a prompt, and the dashboard,
+#                                sidebar and last-done tools
+#   workmux-palette --add BRANCH the palette's query item (what was typed):
+#                                `workmux add BRANCH` in the active pane's repo
+#   workmux-palette --popup DIR CMD…
+#                                run CMD… in DIR in a popup that closes when it
+#                                succeeds and waits for a key when it fails
+#   workmux-palette --do DIR CMD…
+#                                run CMD… in DIR; a failure shows its last
+#                                output line as a tmux message
+#
+# Lifecycle commands (add, merge, remove) run in a popup: they print hook
+# output and may ask y/n (remove with unmerged commits). Open and close are
+# quick, so they run in place.
+
+set -uo pipefail
+self=$(readlink -f "$0")
+
+case ${1-} in
+--exec) # the popup's command (see --popup)
+    shift
+    "$@"
+    status=$?
+    [ "$status" -eq 0 ] && exit 0
+    printf '\n\033[2m[exit %s] any key to close\033[0m' "$status"
+    read -rsn1
+    exit 0
+    ;;
+--popup)
+    dir=$2
+    shift 2
+    # argv form: tmux runs it without a shell and expands no formats in it.
+    exec tmux display-popup -E -w 80% -h 60% -d "$dir" -T " ${*//#/##} " "$self" --exec "$@"
+    ;;
+--do)
+    cd "$2" || exit 1
+    shift 2
+    if ! out=$("$@" 2>&1); then
+        msg=$(tail -n1 <<<"$out")
+        tmux display-message -d 5000 "workmux: ${msg//#/##}"
+    fi
+    exit 0
+    ;;
+--add)
+    cwd=$(tmux display -p '#{pane_current_path}')
+    exec "$self" --popup "$cwd" workmux add "$2"
+    ;;
+esac
+
+cwd=$(tmux display -p '#{pane_current_path}' 2>/dev/null) || cwd=$PWD
+root=$(git -C "$cwd" rev-parse --show-toplevel 2>/dev/null) || root=
+worktrees='[]'
+[ -n "$root" ] && worktrees=$(cd "$root" && workmux list --json 2>/dev/null) || worktrees='[]'
+
+workmux status --all --json 2>/dev/null | jq --arg self "$self" --arg home "$HOME" --arg root "$root" \
+    --argjson worktrees "${worktrees:-[]}" '
+    def tilde: if startswith($home) then "~" + .[($home | length):] else . end;
+    def ago: if . < 60 then "\(.)s" elif . < 3600 then "\(. / 60 | floor)m"
+             else "\(. / 3600 | floor)h\(. % 3600 / 60 | floor)m" end;
+    def run($mode; $argv): {shell: ([$self, $mode, $root] + $argv | map(@sh) | join(" "))};
+    # An agent that registered but reported nothing yet has status "-".
+    {working: {icon: "\uf110", color: "#5ea1ff", rank: 2, label: "working"},
+     waiting: {icon: "\uf075", color: "#f1ff5e", rank: 0, label: "waiting"},
+     done:    {icon: "\uf00c", color: "#5eff6c", rank: 1, label: "done"}} as $look
+    | {icon: "\uf544", color: "#7b8496", rank: 3, label: "idle"} as $idle
+    | ($worktrees | map(select(.is_main | not))) as $trees
+    | (if $root == "" then "" else $root | split("/") | last end) as $repo
+    | [
+      ((.agents // []) | map(. + {look: ($look[.status // ""] // $idle)})
+       | sort_by([.look.rank, (.elapsed_secs // 0)])[]
+       | {category: "Agents", icon: .look.icon, iconColor: .look.color,
+          title: (if .worktree == .project then .project else "\(.project)/\(.worktree)" end),
+          description: ([.look.label + (if .elapsed_secs == null then "" else " \(.elapsed_secs | ago)" end),
+                         (if (.title // "") == "" then .session else .title end)] | join(" · ")),
+          action: {tmux: "switch-client -t \(.pane_id | @sh)"}}),
+      ($trees[]
+       | {category: "Worktrees: \($repo)", icon: "\uf126",
+          title: .handle,
+          description: ([.branch, (if .is_open then "open" else "closed" end)]
+                        + (if .has_uncommitted_changes then ["dirty"] else [] end)
+                        + [.path | tilde] | join(" · ")),
+          action: run("--do"; ["workmux", "open", .handle])}
+         + (if .is_open then {iconColor: "#5eff6c"} else {} end)),
+      (if $root == "" then empty else
+        {category: "New", icon: "\uf067", title: "New worktree from a prompt",
+         description: "write the prompt in $EDITOR; omp names the branch · \($repo)",
+         aliases: ["add", "prompt"], action: run("--popup"; ["workmux", "add", "-A", "-e"])}
+       end),
+      {category: "Workmux", icon: "\uf0e4", title: "Dashboard", description: "agents and worktrees TUI in a popup",
+       aliases: ["dash"], action: {tmux: "display-popup -E -w 90% -h 90% workmux dashboard"}},
+      {category: "Workmux", icon: "\uf0db", title: "Sidebar", description: "toggle the agent status sidebar",
+       aliases: ["side"], action: {tmux: "run-shell -b \("workmux sidebar" | @sh)"}},
+      {category: "Workmux", icon: "\uf0e2", title: "Last done", description: "jump to the agent that last finished or is waiting",
+       aliases: ["ld"], action: {tmux: "run-shell -b \("workmux last-done" | @sh)"}},
+      ($trees[] | select(.is_open)
+       | {category: "Close", icon: "\uf00d", title: "Close \(.handle)", description: "close the session, keep the worktree and branch",
+          action: run("--do"; ["workmux", "close", .handle])}),
+      ($trees[]
+       | {category: "Merge", icon: "\uf419", title: "Merge \(.handle)", description: "merge \(.branch) into the main branch, then remove it",
+          action: run("--popup"; ["workmux", "merge", .handle])}),
+      ($trees[]
+       | {category: "Remove", icon: "\uf1f8", title: "Remove \(.handle)", description: "remove the worktree, session and branch without merging",
+          action: run("--popup"; ["workmux", "remove", .handle])})
+    ]'