claude-garage 0.3.3 → 0.3.4

package/README.md

@@ -150,7 +150,7 @@ the features the TUI doesn't have yet:
   notification when no page is open (clickable with
   [`terminal-notifier`](https://github.com/julienXX/terminal-notifier)).
 
-### The pit pet 🐈 (web wall)
+### The pit pet 🐈
 
 An optional ASCII companion on the key strip whose mood *is* the wall:
 asleep when all is quiet, watching while agents run, **sprinting toward the
@@ -177,12 +177,31 @@ state in character:
 | **Papito** (rubber duck) | deadpan: waddles, **never** bounces, and alerts with a single motionless stare; celebration is exactly one flap |
 | **Segan** (pit pup) | maximum enthusiasm: fastest runner, biggest bounce, and celebrates with zoomies across the strip |
 
+**In the TUI** the pet lives at the right end of the bottom strip, beside
+the keys chip, as a one-row sprite (`=o.o=`, `<(o )___`, `(·ᴥ·)`), same
+moods, same manners. It speaks right next to itself:
+`you're doing great!!  (·ᴥ·)  keys → garage`. Press **`P`** to
+cycle Arthur → Papito → Segan → off; the choice is remembered. Click the
+pet while it's alert to jump to the blocked session, click it otherwise to
+pet it. TUI pets also **talk**: every few minutes, in character, the strip
+gets a line like *"water. now. i'm not asking."* (Arthur), *"acceptable."*
+(Papito) or *"you're doing great!!"* (Segan). They notice long days, late
+nights, and a usage window running hot, and they never interrupt a session
+that needs you. Set `GARAGE_PET_ASCII=1` if your font lacks `ᴥ`.
+
 ## Keybindings
 
 The TUI's full keymap (`claude-garage tui`, also shown in-app with `?`).
 Bindings apply at the garage layer; `Enter` hands your keystrokes to the
 focused session byte-exact until `Ctrl+G` takes them back.
 
+**Terminal:** Ghostty, iTerm2, kitty and WezTerm pass every Claude Code
+binding through, Shift+Enter included. macOS Terminal.app speaks neither
+the kitty keyboard protocol nor modifyOtherKeys, so Shift+Enter can't be
+told apart from Enter there; either switch terminals or add a Terminal.app
+key mapping (Settings → Profiles → Keyboard) for Shift+Return that sends
+`\033[13;2u`. Option+Enter and Ctrl+J work everywhere.
+
 | Key | Action |
 |---|---|
 | `1`–`9` | focus workspace |

package/daemon/src/tmux.js

@@ -176,7 +176,8 @@ export async function createSession(id, dir, command, extraArgs = []) {
 }
 
 // p14: Claude Code's Shift+Enter (kitty protocol, ESC[13;2u) only reaches a
-// pane if the tmux server has extended keys on and advertises them —
+// pane if the tmux server has extended keys on and advertises them (and,
+// since 0.3.4, re-encodes in csi-u form so Option+Enter survives too) —
 // exactly the tmux config Claude Code's own terminal docs prescribe. Server
 // options survive until the tmux server exits, so this runs at daemon boot
 // AND on every createSession (the server may have been started later by a
@@ -185,6 +186,13 @@ export async function createSession(id, dir, command, extraArgs = []) {
 export async function ensureExtendedKeys() {
   try {
     await run("tmux", ["set-option", "-s", "extended-keys", "on"]);
+    // csi-u, not the default xterm `CSI 27;m;k~` form: with extended keys
+    // on, tmux re-encodes every modified key for a pane that asked for
+    // them — Option+Enter becomes `ESC[27;3;13~`, which Claude Code does
+    // not parse, so Option+Enter (its own newline binding on macOS) died
+    // inside every garage session. The kitty form (`ESC[13;3u`) is the one
+    // Claude Code already understands for Shift+Enter. tmux ≥ 3.5.
+    await run("tmux", ["set-option", "-s", "extended-keys-format", "csi-u"]).catch(() => {});
     const { stdout } = await run("tmux", ["show-options", "-s", "terminal-features"]).catch(
       () => ({ stdout: "" })
     );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-garage",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Multiple Claude agents driving you crazy? Park them all in one garage: a needs-input queue that follows you across projects, a full-screen terminal TUI, and a browser wall with diff review. tmux owns the sessions; close the app and nothing dies.",
   "license": "MIT",
   "author": "Saiful Islam <saifulislamadar@gmail.com>",