claude-garage 0.3.2 → 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/index.js

@@ -17,6 +17,7 @@ import { attachTermServer } from "./term.js";
 import { rejectForeignOrigins } from "./security.js";
 import { startPoller } from "./poller.js";
 import { healthPayload } from "./health.js";
+import { ensureExtendedKeys } from "./tmux.js";
 
 const HOST = "127.0.0.1";
 const PORT = Number(process.env.GARAGE_PORT ?? 4747);
@@ -63,6 +64,9 @@ if (process.env.GARAGE_SERVE_UI === "1") {
 // Poller feeds StatusStore (busy/idle baseline); hooks.js and notify.js
 // subscribe to the same store — see status.js for the single write path.
 const stopPoller = startPoller(app);
+// p14: Shift+Enter needs the tmux server's extended-keys config — apply it
+// to an already-running server at boot (createSession re-applies later).
+ensureExtendedKeys();
 app.addHook("onClose", async () => {
   stopPoller();
 });

package/daemon/src/tmux.js

@@ -164,6 +164,9 @@ export async function hasSession(id) {
 // must not pre-join them into a single string.
 export async function createSession(id, dir, command, extraArgs = []) {
   await run("tmux", ["new-session", "-d", "-s", id, "-c", dir, command, ...extraArgs]);
+  // The new-session call may have just started the server — (re)apply the
+  // extended-keys server config so Shift+Enter works in this pane (p14).
+  await ensureExtendedKeys();
   // The pit wall renders its own session title bars, so tmux's status line
   // is visual noise in every grid cell. Per-session option — a plain
   // `tmux attach` escape-hatch user can restore it with `set status on`.
@@ -172,6 +175,36 @@ export async function createSession(id, dir, command, extraArgs = []) {
   await run("tmux", ["set-option", "-t", id, "status", "off"]).catch(() => {});
 }
 
+// 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 (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
+// plain `tmux` user). Idempotent: `set -as terminal-features` appends
+// duplicates, so the extkeys feature is only appended when missing.
+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: "" })
+    );
+    if (!/xterm\*?[^\n]*extkeys/.test(stdout)) {
+      await run("tmux", ["set-option", "-as", "terminal-features", "xterm*:extkeys"]);
+    }
+  } catch {
+    // No server running (or ancient tmux) — nothing to configure; the
+    // createSession call path retries once a server exists.
+  }
+}
+
 export async function killSession(id) {
   await run("tmux", ["kill-session", "-t", exact(id)]);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-garage",
-  "version": "0.3.2",
+  "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>",