pendingyou 0.38.0 → 0.39.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.39.0 (2026-10-25)
+
+- In tmux, your agents' sessions now say which pane they run in, as they have in Herdr since 0.18.0: each presence
+  report carries the pane (`TMUX_PANE`, such as `%12`) and which tmux server it is (16 hex characters of a hash of the
+  computer's name and tmux's socket path, never the path itself). In a Herdr pane Herdr's is the one it says, even when
+  Herdr runs inside tmux. That's what lets an app you signed in on this computer bring the agent's tmux pane to the front
+  when you press Show on its card: the Pending You SDK's `show-in-tmux` example is one, to run on your own account.
+  Nothing else of tmux is read, and nothing is ever run in it. A Pending You from before tmux refuses the pane, and the
+  report goes again without it.
+
 ## 0.38.0 (2026-10-25)
 
 - Show in Herdr: press it on a card in Pending You, at your desk or on your phone, and Herdr moves to the pane of the

package/README.md

@@ -365,7 +365,10 @@ has a Presence line for each agent.
 Since 0.18.0, a session in a [Herdr](https://herdr.dev) pane also says which pane (`HERDR_PANE_ID`, such as `w2:p1`)
 and which Herdr server (16 hex characters of a hash of the computer's name and Herdr's socket path, never the path
 itself), so Pending You can list where each of an agent's running sessions is and the Pending You plugin for Herdr can
-take you to it. Anywhere else nothing of the kind is sent.
+take you to it. Since 0.39.0, a session in a tmux pane says which the same way (`TMUX_PANE`, such as `%12`, and 16 hex
+characters of a hash of the computer's name and tmux's socket path), so an app you sign in on this computer can bring
+it to the front when you press Show on its card; in a Herdr pane, even one inside tmux, Herdr's is the one it says.
+Anywhere else nothing of the kind is sent.
 
 ## In Herdr
 
@@ -637,7 +640,7 @@ whether the agent has a `pendingyou` MCP server and where it points. In a Herdr
 Herdr's own command line, on this computer, the badges above: a card's title (redacted, 80 characters at most) and its
 request id, never an answer or a note; `<app>-threads.json` remembers the pane each session runs in, and `herdr.json`
 whether the badges are off. Presence there (0.18.0) also sends Pending You the pane's id and the hash that names its
-Herdr server. With a sign-in that only hears, the hooks and
+Herdr server, and in a tmux pane (0.39.0) the tmux pane's id and the hash that names its tmux server. With a sign-in that only hears, the hooks and
 listeners tell this computer's handed questions from another's by its names: its hostname, the names its sign-ins by
 code were given, a Mac's own name (`scutil --get ComputerName`) and, outside a hook, Tailscale's (`tailscale status`). For a permission prompt's card, the worker reads
 the end of the Claude Code session's transcript only for the name the session gave Pending You, and `git remote

package/dist/presence.js

@@ -6,8 +6,9 @@ import { reportThreads, threadNames } from "./apps/codex-wake.js";
 import { DEFAULT_ORIGIN } from "./args.js";
 import { readCredential } from "./credentials.js";
 import { configDir, readJson, withLock, writeWhole } from "./files.js";
-import { herdrTarget, herdrTerminal, reportCommand } from "./herdr.js";
+import { herdrTarget, reportCommand } from "./herdr.js";
 import { endPrompts, sessionName } from "./permission.js";
+import { terminalOf } from "./terminal.js";
 export const PRESENCE_PATH = '/mcp/cli/presence';
 export const PRESENCE_EVERY_MS = 5 * 60_000;
 export const LIVE_AGAIN_MS = 4 * 60_000;
@@ -67,7 +68,7 @@ export async function sendPresence(io, origin, presence, timeoutMs = SEND_MS, op
             cwd: presence.cwd && presence.cwd.length <= CWD_MAX ? presence.cwd : null,
             state: presence.state,
         };
-        const terminal = herdrTerminal(io.env, io.host);
+        const terminal = terminalOf(io.env, io.host);
         let body = terminal ? { ...plain, terminal } : plain;
         const send = (force) => postJson(io, origin, PRESENCE_PATH, body, timeoutMs, {
             app: presence.app,

package/dist/terminal.js

@@ -0,0 +1,20 @@
+import { createHash } from 'node:crypto';
+import { isAbsolute } from 'node:path';
+import { herdrTerminal } from "./herdr.js";
+export const TMUX_PANE = /^%[0-9]{1,9}$/;
+export function tmuxServer(env, host) {
+    const [socket = ''] = (env.TMUX ?? '').split(',');
+    if (!socket || !isAbsolute(socket) || /[\0\r\n]/.test(socket))
+        return null;
+    return createHash('sha256').update(`${host}${socket}`).digest('hex').slice(0, 16);
+}
+export function tmuxTerminal(env, host) {
+    const pane = env.TMUX_PANE ?? '';
+    if (!env.TMUX || !TMUX_PANE.test(pane))
+        return null;
+    const server = tmuxServer(env, host);
+    return { app: 'tmux', paneId: pane, ...(server ? { server } : {}) };
+}
+export function terminalOf(env, host) {
+    return herdrTerminal(env, host) ?? tmuxTerminal(env, host);
+}

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.38.0';
+export const VERSION = '0.39.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pendingyou",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "Pending You for your coding agents: one command sets up Claude Code, Codex, OpenCode and Pi to ask you through Pending You and hear your answers, even while they sit idle.",
   "keywords": [
     "pendingyou",