@sandropadin/tend 0.1.0 → 0.2.0

package/README.md

@@ -28,9 +28,9 @@ without color: **`●` red = blocked**, **`⠧` yellow (animated spinner) = work
 `tend` needs **tmux** and **Node ≥ 20**. Install it from npm:
 
 ```sh
-npm install -g @spadin/tend    # global — puts `tend` on your PATH
+npm install -g @sandropadin/tend    # global — puts `tend` on your PATH
 # or run it without installing:
-npx @spadin/tend
+npx @sandropadin/tend
 ```
 
 **From source** (to hack on it) — Node ≥ 22.18 runs the TypeScript directly, no
@@ -131,10 +131,11 @@ Enter sends the selected agent to B.
 set -g status-right "#(cd #{pane_current_path} && tend --json | jq -r '...')"
 ```
 
-Or bind a key to a quick popup:
+Or bind a key to a quick popup dashboard — `--popup` makes it exit after you
+pick an agent, so the popup closes and drops you onto that pane:
 
 ```tmux
-bind-key g display-popup -E "tend; read"
+bind-key g display-popup -E "tend --popup"
 ```
 
 ## How it works

package/dist/index.js

@@ -29,6 +29,7 @@ function parseArgs(argv) {
         interval: 800,
         onceDelay: 350,
         other: false,
+        popup: false,
     };
     const args = [...argv];
     while (args.length) {
@@ -55,6 +56,9 @@ function parseArgs(argv) {
             case "--other":
                 opts.other = true;
                 break;
+            case "--popup":
+                opts.popup = true;
+                break;
             case "jump":
                 opts.mode = "jump";
                 opts.target = args.shift();
@@ -113,6 +117,7 @@ function printHelp() {
         "  --other            open jumps in the one other attached client",
         "",
         "Options:",
+        "  --popup            exit the dashboard after a jump — for tmux display-popup",
         "  --interval <ms>    dashboard refresh interval (default 800)",
         "  --once-delay <ms>  activity sampling window for --once (default 350)",
         "",
@@ -273,7 +278,7 @@ async function main() {
             if (interactiveTty && !opts.readonly) {
                 // Optional preset target window from --to/--other; `o` cycles it live.
                 const initialTarget = opts.targetClient ?? (opts.other ? await resolveTargetClient(opts) : null);
-                await runPicker(scanOpts(opts), opts.interval, initialTarget ?? undefined);
+                await runPicker(scanOpts(opts), opts.interval, initialTarget ?? undefined, opts.popup);
             }
             else if (opts.readonly) {
                 await runWatch(opts); // display-only repaint (explicit)

package/dist/pick.js

@@ -21,7 +21,7 @@ const CLEAR_EOL = "\x1b[K"; // erase from cursor to end of *line*
 const CLEAR_BELOW = "\x1b[J"; // erase from cursor to end of screen
 const ANIM_MS = 90; // spinner tick — faster than the scan interval
 const shortTty = (tty) => tty.replace(/^\/dev\//, "");
-export async function runPicker(opts, intervalMs, initialTarget) {
+export async function runPicker(opts, intervalMs, initialTarget, exitOnJump = false) {
     let statuses = [];
     let memory = new Map();
     let cursorPaneId = null; // track selection by id across rescans
@@ -133,6 +133,13 @@ export async function runPicker(opts, intervalMs, initialTarget) {
         input.removeListener("data", onKey);
         out.write(SHOW_CURSOR + ALT_OFF);
     };
+    // Tear down and exit after a jump that has already completed (the switch-client
+    // paths). Used in --popup mode so `display-popup -E` closes onto the agent.
+    const finishAfterJump = () => {
+        done = true;
+        cleanup();
+        process.exit(0);
+    };
     const jump = async () => {
         const target = selectable()[currentIndex()];
         if (!target)
@@ -141,6 +148,8 @@ export async function runPicker(opts, intervalMs, initialTarget) {
         if (targetTty) {
             try {
                 await jumpToPane(target.pane, { client: targetTty });
+                if (exitOnJump)
+                    finishAfterJump();
                 statusMsg = `→ sent ${target.agent} (${target.pane.id}) to ${shortTty(targetTty)}`;
             }
             catch {
@@ -149,9 +158,13 @@ export async function runPicker(opts, intervalMs, initialTarget) {
             render();
             return;
         }
-        // Targeting this window, inside tmux: switch our client but keep running.
+        // Targeting this window, inside tmux: switch our client. Normally we keep the
+        // dashboard alive in its own pane; in --popup mode we exit so the popup closes
+        // onto the agent instead of lingering on top of it.
         if (insideTmux()) {
             await jumpToPane(target.pane);
+            if (exitOnJump)
+                finishAfterJump();
             statusMsg = `→ jumped to ${target.agent} in ${target.pane.sessionName} (${target.pane.id})`;
             render();
             return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sandropadin/tend",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Lightweight status detector for AI coding agents running inside tmux. Reports blocked / working / idle per pane by scraping the terminal, plus git branch state.",
   "type": "module",
   "bin": {

package/src/index.ts

@@ -41,6 +41,7 @@ interface Options {
   target?: string; // pane id for jump/debug
   targetClient?: string; // --to <tty>: open jumps in this client (window)
   other: boolean; // --other: open jumps in the one other attached client
+  popup: boolean; // --popup: dashboard exits after a jump (for tmux display-popup)
 }
 
 function parseArgs(argv: string[]): Options {
@@ -53,6 +54,7 @@ function parseArgs(argv: string[]): Options {
     interval: 800,
     onceDelay: 350,
     other: false,
+    popup: false,
   };
   const args = [...argv];
   while (args.length) {
@@ -79,6 +81,9 @@ function parseArgs(argv: string[]): Options {
       case "--other":
         opts.other = true;
         break;
+      case "--popup":
+        opts.popup = true;
+        break;
       case "jump":
         opts.mode = "jump";
         opts.target = args.shift();
@@ -139,6 +144,7 @@ function printHelp(): void {
       "  --other            open jumps in the one other attached client",
       "",
       "Options:",
+      "  --popup            exit the dashboard after a jump — for tmux display-popup",
       "  --interval <ms>    dashboard refresh interval (default 800)",
       "  --once-delay <ms>  activity sampling window for --once (default 350)",
       "",
@@ -313,7 +319,7 @@ async function main(): Promise<void> {
         // Optional preset target window from --to/--other; `o` cycles it live.
         const initialTarget =
           opts.targetClient ?? (opts.other ? await resolveTargetClient(opts) : null);
-        await runPicker(scanOpts(opts), opts.interval, initialTarget ?? undefined);
+        await runPicker(scanOpts(opts), opts.interval, initialTarget ?? undefined, opts.popup);
       } else if (opts.readonly) {
         await runWatch(opts); // display-only repaint (explicit)
       } else if (opts.mode === "watch") {

package/src/pick.ts

@@ -31,6 +31,7 @@ export async function runPicker(
   opts: ScanOptions,
   intervalMs: number,
   initialTarget?: string,
+  exitOnJump = false, // --popup: end the session after a jump so the popup closes
 ): Promise<void> {
   let statuses: AgentStatus[] = [];
   let memory = new Map<string, PaneMemory>();
@@ -145,6 +146,14 @@ export async function runPicker(
     out.write(SHOW_CURSOR + ALT_OFF);
   };
 
+  // Tear down and exit after a jump that has already completed (the switch-client
+  // paths). Used in --popup mode so `display-popup -E` closes onto the agent.
+  const finishAfterJump = () => {
+    done = true;
+    cleanup();
+    process.exit(0);
+  };
+
   const jump = async () => {
     const target = selectable()[currentIndex()];
     if (!target) return;
@@ -153,6 +162,7 @@ export async function runPicker(
     if (targetTty) {
       try {
         await jumpToPane(target.pane, { client: targetTty });
+        if (exitOnJump) finishAfterJump();
         statusMsg = `→ sent ${target.agent} (${target.pane.id}) to ${shortTty(targetTty)}`;
       } catch {
         statusMsg = `⚠ ${shortTty(targetTty)} unavailable`;
@@ -161,9 +171,12 @@ export async function runPicker(
       return;
     }
 
-    // Targeting this window, inside tmux: switch our client but keep running.
+    // Targeting this window, inside tmux: switch our client. Normally we keep the
+    // dashboard alive in its own pane; in --popup mode we exit so the popup closes
+    // onto the agent instead of lingering on top of it.
     if (insideTmux()) {
       await jumpToPane(target.pane);
+      if (exitOnJump) finishAfterJump();
       statusMsg = `→ jumped to ${target.agent} in ${target.pane.sessionName} (${target.pane.id})`;
       render();
       return;