diff --git a/docs/keymaps.md b/docs/keymaps.md
index 308e8af..339f25e 100644
--- a/docs/keymaps.md
+++ b/docs/keymaps.md
@@ -47,6 +47,8 @@ This table favors the shortcuts used by these dotfiles and Herdr defaults. It is
 | Herdr | `Ctrl+A r` | Resize mode. |
 | Herdr | `Ctrl+A b` | Toggle sidebar. |
 | Herdr remote | `Ctrl+V` | Remote image paste. |
+| Herdr Desktop | `Ctrl+A` + Herdr TUI key | Same prefix keys as Herdr TUI (`herdr/desktop/keys.json`): `v`, `-`, `x`, `z`, `h/j/k/l`, `c`, `n/p`, `1..9`, `Shift+X/T/N/W/D`, `b`, `s`, `?`, `Option+K/J`. |
+| Herdr Desktop | not mapped | No equivalent for TUI detach, workspace picker, pane cycling, pane rename, resize mode, or focus agent 1–9 (`agent.focus` needs a terminal id). |
 
 ## AI CLIs
 
diff --git a/herdr/desktop/keys.json b/herdr/desktop/keys.json
new file mode 100644
index 0000000..c3c3cd4
--- /dev/null
+++ b/herdr/desktop/keys.json
@@ -0,0 +1,102 @@
+{
+  "global": {
+    "ctrl-a v": "pane.split:right",
+    "ctrl-a -": "pane.split:down",
+    "ctrl-a x": "pane.close",
+    "ctrl-a z": "pane.zoom",
+    "ctrl-a h": "pane.go:left",
+    "ctrl-a j": "pane.go:down",
+    "ctrl-a k": "pane.go:up",
+    "ctrl-a l": "pane.go:right",
+    "ctrl-a c": "tab.new",
+    "ctrl-a n": "tab.next",
+    "ctrl-a p": "tab.prev",
+    "ctrl-a shift-x": "tab.close",
+    "ctrl-a shift-t": "tab.rename",
+    "ctrl-a shift-n": "space.new",
+    "ctrl-a shift-w": "space.rename",
+    "ctrl-a shift-d": "space.close",
+    "ctrl-a b": "layout.toggle:sidebar",
+    "ctrl-a s": "app.settings",
+    "ctrl-a shift-/": "app.help",
+    "ctrl-a alt-k": "agent.prev",
+    "ctrl-a alt-j": "agent.next",
+    "ctrl-a 1": "tab.select:1",
+    "ctrl-a 2": "tab.select:2",
+    "ctrl-a 3": "tab.select:3",
+    "ctrl-a 4": "tab.select:4",
+    "ctrl-a 5": "tab.select:5",
+    "ctrl-a 6": "tab.select:6",
+    "ctrl-a 7": "tab.select:7",
+    "ctrl-a 8": "tab.select:8",
+    "ctrl-a 9": "tab.select:9",
+    "cmd-q": "app.quit",
+    "cmd-h": "app.hide",
+    "cmd-alt-h": "app.hide_others",
+    "cmd-t": "tab.new",
+    "cmd-w": "tab.close",
+    "ctrl-tab": "tab.next",
+    "ctrl-shift-tab": "tab.prev",
+    "cmd-shift-]": "tab.next",
+    "cmd-shift-[": "tab.prev",
+    "cmd-alt-]": "space.next",
+    "cmd-alt-[": "space.prev",
+    "cmd-]": "agent.next",
+    "cmd-[": "agent.prev",
+    "cmd-shift-l": "layout.switch",
+    "cmd-n": "space.new",
+    "cmd-p": "mod.open:picker",
+    "cmd-shift-p": "app.palette",
+    "cmd-,": "app.settings",
+    "cmd-d": "pane.split:right",
+    "cmd-shift-d": "pane.split:down",
+    "cmd-shift-w": "pane.close",
+    "cmd-shift-enter": "pane.zoom",
+    "cmd-alt-left": "pane.go:left",
+    "cmd-alt-right": "pane.go:right",
+    "cmd-alt-up": "pane.go:up",
+    "cmd-alt-down": "pane.go:down",
+    "cmd-alt-shift-left": "pane.swap:left",
+    "cmd-alt-shift-right": "pane.swap:right",
+    "cmd-alt-shift-up": "pane.swap:up",
+    "cmd-alt-shift-down": "pane.swap:down",
+    "f2": "tab.rename",
+    "shift-f2": "space.rename",
+    "cmd-/": "app.help",
+    "cmd-shift-/": "app.help",
+    "cmd-b": "layout.toggle:sidebar",
+    "cmd-=": "app.zoom_in",
+    "cmd-+": "app.zoom_in",
+    "cmd--": "app.zoom_out",
+    "cmd-0": "app.zoom_reset",
+    "cmd-1": "tab.select:1",
+    "cmd-2": "tab.select:2",
+    "cmd-3": "tab.select:3",
+    "cmd-4": "tab.select:4",
+    "cmd-5": "tab.select:5",
+    "cmd-6": "tab.select:6",
+    "cmd-7": "tab.select:7",
+    "cmd-8": "tab.select:8",
+    "cmd-9": "tab.select:9",
+    "ctrl-1": "space.select:1",
+    "ctrl-2": "space.select:2",
+    "ctrl-3": "space.select:3",
+    "ctrl-4": "space.select:4",
+    "ctrl-5": "space.select:5",
+    "ctrl-6": "space.select:6",
+    "ctrl-7": "space.select:7",
+    "ctrl-8": "space.select:8",
+    "ctrl-9": "space.select:9"
+  },
+  "terminal": {
+    "cmd-c": "terminal.copy",
+    "cmd-v": "terminal.paste",
+    "ctrl-v": "terminal.paste_image",
+    "alt-left": "send:\u001bb",
+    "alt-right": "send:\u001bf",
+    "alt-backspace": "send:\u0017",
+    "cmd-left": "send:\u0001",
+    "cmd-right": "send:\u0005",
+    "cmd-backspace": "send:\u0015"
+  }
+}
diff --git a/install.sh b/install.sh
index 78a65be..f875768 100755
--- a/install.sh
+++ b/install.sh
@@ -29,6 +29,7 @@ MANAGED_LINKS=(
   "ghostty/config|$HOME/.config/ghostty/config|all"
   "herdr/desktop/themes/refactoria.json|$HOME/.config/herdr-app/themes/refactoria.json|darwin"
   "herdr/desktop/layouts/refactoria.json|$HOME/.config/herdr-app/layouts/refactoria.json|darwin"
+  "herdr/desktop/keys.json|$HOME/.config/herdr-app/keys.json|darwin"
   "herdr/desktop/mods/refactoria-spaces/main.js|$HOME/.config/herdr-app/mods/refactoria-spaces/main.js|darwin"
   "herdr/desktop/mods/refactoria-spaces/mod.json|$HOME/.config/herdr-app/mods/refactoria-spaces/mod.json|darwin"
   "herdr/desktop/mods/refactoria-agents/main.js|$HOME/.config/herdr-app/mods/refactoria-agents/main.js|darwin"