@towles/tool 0.0.110 → 0.0.112

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@towles/tool",
-  "version": "0.0.110",
+  "version": "0.0.112",
   "description": "One off quality of life scripts that I use on a daily basis.",
   "homepage": "https://github.com/ChrisTowles/towles-tool#readme",
   "bugs": {

package/packages/agentboard/apps/tui/src/index.tsx

@@ -110,6 +110,16 @@ function App() {
   const [modal, setModal] = createSignal<"none" | "confirm-kill" | "help">("none");
   const [killTarget, setKillTarget] = createSignal<string | null>(null);
 
+  // --- Transient toast (footer) ---
+  type ToastTone = "error" | "info" | "success";
+  const [toast, setToast] = createSignal<{ message: string; tone: ToastTone } | null>(null);
+  let toastTimer: ReturnType<typeof setTimeout> | null = null;
+  function showToast(message: string, tone: ToastTone = "info") {
+    setToast({ message, tone });
+    if (toastTimer) clearTimeout(toastTimer);
+    toastTimer = setTimeout(() => setToast(null), 4000);
+  }
+
   const [clientTty, setClientTty] = createSignal(getClientTty(muxCtx));
   let ws: WebSocket | null = null;
   let startupFocusSynced = false;
@@ -119,8 +129,14 @@ function App() {
 
   const focusedData = createMemo(() => sessions.find((s) => s.name === focusedSession()) ?? null);
 
-  function send(cmd: ClientCommand) {
-    if (connected() && ws) ws.send(JSON.stringify(cmd));
+  function send(cmd: ClientCommand, successMsg?: string): boolean {
+    if (connected() && ws) {
+      ws.send(JSON.stringify(cmd));
+      if (successMsg) showToast(successMsg, "success");
+      return true;
+    }
+    showToast("not connected to agentboard server", "error");
+    return false;
   }
 
   function switchToSession(name: string) {
@@ -180,13 +196,16 @@ function App() {
         "/tmp/agentboard-tui-agent-click.log",
         `[${new Date().toISOString()}] keyboard focus-agent-pane session=${data.name} agent=${agent.agent} threadId=${agent.threadId} threadName=${agent.threadName}\n`,
       );
-    send({
-      type: "focus-agent-pane",
-      session: data.name,
-      agent: agent.agent,
-      threadId: agent.threadId,
-      threadName: agent.threadName,
-    });
+    send(
+      {
+        type: "focus-agent-pane",
+        session: data.name,
+        agent: agent.agent,
+        threadId: agent.threadId,
+        threadName: agent.threadName,
+      },
+      `focusing ${agent.agent}`,
+    );
   }
 
   function dismissFocusedAgent() {
@@ -194,17 +213,13 @@ function App() {
     const agents = data?.agents ?? [];
     const agent = agents[focusedAgentIdx()];
     if (!agent || !data) return;
-    send({
-      type: "dismiss-agent",
-      session: data.name,
-      agent: agent.agent,
-      threadId: agent.threadId,
-    });
-    // Adjust index if we dismissed the last item
+    send(
+      { type: "dismiss-agent", session: data.name, agent: agent.agent, threadId: agent.threadId },
+      `dismissed ${agent.agent}`,
+    );
     if (focusedAgentIdx() >= agents.length - 1 && agents.length > 1) {
       setFocusedAgentIdx(agents.length - 2);
     }
-    // If no agents left, go back to sessions
     if (agents.length <= 1) setPanelFocus("sessions");
   }
 
@@ -213,13 +228,16 @@ function App() {
     const agents = data?.agents ?? [];
     const agent = agents[focusedAgentIdx()];
     if (!agent || !data) return;
-    send({
-      type: "kill-agent-pane",
-      session: data.name,
-      agent: agent.agent,
-      threadId: agent.threadId,
-      threadName: agent.threadName,
-    });
+    send(
+      {
+        type: "kill-agent-pane",
+        session: data.name,
+        agent: agent.agent,
+        threadId: agent.threadId,
+        threadName: agent.threadName,
+      },
+      `killed ${agent.agent} pane`,
+    );
   }
 
   function beginDetailResize(event: MouseEvent) {
@@ -311,11 +329,27 @@ function App() {
     const data = focusedData();
     if (!data?.dir) return;
     const editor = preferredEditor();
-    Bun.spawn([editor, data.dir], {
-      stdout: "ignore",
-      stderr: "ignore",
-      stdin: "ignore",
-    });
+    try {
+      const proc = Bun.spawn([editor, data.dir], {
+        stdout: "ignore",
+        stderr: "ignore",
+        stdin: "ignore",
+      });
+      showToast(`opening ${data.dir} in ${editor}`, "success");
+      void proc.exited.then((code) => {
+        if (code !== 0) {
+          logResizeDebug("openInEditor failed", { editor, dir: data.dir, code });
+          showToast(`failed to open editor "${editor}" (exit ${code})`, "error");
+        }
+      });
+    } catch (err) {
+      logResizeDebug("openInEditor spawn threw", {
+        editor,
+        dir: data.dir,
+        error: String(err),
+      });
+      showToast(`failed to spawn editor "${editor}": ${String(err)}`, "error");
+    }
   }
 
   onMount(() => {
@@ -340,6 +374,7 @@ function App() {
     const refocusTimeout = setTimeout(doStartupRefocus, 2000);
 
     onCleanup(() => {
+      if (toastTimer) clearTimeout(toastTimer);
       clearTimeout(refocusTimeout);
       renderer.removeListener("capabilities", doStartupRefocus);
     });
@@ -388,8 +423,9 @@ function App() {
 
             if (!startupFocusSynced && sessions.some((session) => session.name === msg.name)) {
               startupFocusSynced = true;
+              const oldFocus = focusedSession();
               setFocusedSession(msg.name);
-              if (focusedSession() !== msg.name) {
+              if (oldFocus !== msg.name) {
                 startupFocusToPublish = msg.name;
               }
             }
@@ -459,7 +495,7 @@ function App() {
     if (currentModal === "confirm-kill") {
       if (key.name === "y") {
         const target = killTarget();
-        if (target) send({ type: "kill-session", name: target });
+        if (target) send({ type: "kill-session", name: target }, `killed ${target}`);
         setKillTarget(null);
         setModal("none");
       } else {
@@ -540,20 +576,11 @@ function App() {
         break;
       }
       case "r":
-        send({ type: "refresh" });
+        send({ type: "refresh" }, "refreshing sessions");
         break;
-      case "u":
-        send({ type: "show-all-sessions" });
+      case "d":
+        if (panelFocus() === "agents") dismissFocusedAgent();
         break;
-      case "d": {
-        if (panelFocus() === "agents") {
-          dismissFocusedAgent();
-        } else {
-          const focused = focusedSession();
-          if (focused) send({ type: "hide-session", name: focused });
-        }
-        break;
-      }
       case "x": {
         if (panelFocus() === "agents") {
           killFocusedAgentPane();
@@ -681,6 +708,20 @@ function App() {
         <box height={1}>
           <text style={{ fg: P().surface2 }}>{DIVIDER}</text>
         </box>
+        <Show when={toast()}>
+          {(t) => (
+            <box height={1}>
+              <text
+                style={{
+                  fg:
+                    t().tone === "error" ? P().red : t().tone === "success" ? P().green : P().blue,
+                }}
+              >
+                {t().message}
+              </text>
+            </box>
+          )}
+        </Show>
         <Show
           when={panelFocus() === "sessions"}
           fallback={
@@ -699,11 +740,10 @@ function App() {
             palette={P}
             hints={[
               ["⇥", "cycle"],
-              ["⏎", "go"],
-              ["→", "select"],
+              ["⏎", "switch"],
+              ["→", "agents"],
               ["n", "new"],
               ["e", "edit"],
-              ["d", "hide"],
               ["x", "kill"],
               ["r", "refresh"],
               ["q", "quit"],
@@ -767,11 +807,9 @@ const HELP_KEYS: [string, string][] = [
   ["Tab", "Cycle sessions"],
   ["n", "New session"],
   ["e", "Open in editor"],
-  ["d", "Hide session"],
   ["x", "Kill session"],
   ["r", "Refresh"],
-  ["u", "Show all sessions"],
-  ["→/l", "Select panel"],
+  ["→/l", "Agents panel"],
   ["←/h/Esc", "Back to sessions"],
   ["Alt+↑↓", "Reorder sessions"],
   ["q", "Quit"],

package/packages/agentboard/packages/runtime/src/server/index.ts

@@ -248,13 +248,8 @@ export function startServer(
       return a.name.localeCompare(b.name);
     });
 
-    const currentSession = getCurrentSession();
-
     // Sync custom ordering with current session list
     sessionOrder.sync(allMuxSessions.map((s) => s.name));
-    if (currentSession) {
-      sessionOrder.show(currentSession);
-    }
 
     // Apply custom ordering
     const orderedNames = sessionOrder.apply(allMuxSessions.map((s) => s.name));
@@ -1366,14 +1361,6 @@ export function startServer(
         mux.createSession();
         broadcastState();
         break;
-      case "hide-session":
-        sessionOrder.hide(cmd.name);
-        broadcastState();
-        break;
-      case "show-all-sessions":
-        sessionOrder.showAll();
-        broadcastState();
-        break;
       case "kill-session": {
         const p = sessionProviders.get(cmd.name) ?? mux;
         p.killSession(cmd.name);

package/packages/agentboard/packages/runtime/src/server/session-order.ts

@@ -3,7 +3,6 @@ import { dirname } from "node:path";
 
 interface PersistedSessionOrder {
   order?: unknown;
-  hidden?: unknown;
 }
 
 /**
@@ -16,7 +15,6 @@ interface PersistedSessionOrder {
  */
 export class SessionOrder {
   private order: string[] = [];
-  private hidden = new Set<string>();
   private readonly persistPath: string | null;
 
   constructor(persistPath?: string) {
@@ -33,11 +31,6 @@ export class SessionOrder {
             if (Array.isArray(persisted.order)) {
               this.order = persisted.order.filter((n): n is string => typeof n === "string");
             }
-            if (Array.isArray(persisted.hidden)) {
-              this.hidden = new Set(
-                persisted.hidden.filter((n): n is string => typeof n === "string"),
-              );
-            }
           }
         }
       } catch {
@@ -51,7 +44,6 @@ export class SessionOrder {
     const nameSet = new Set(names);
     // Remove sessions that no longer exist
     this.order = this.order.filter((n) => nameSet.has(n));
-    this.hidden = new Set([...this.hidden].filter((n) => nameSet.has(n)));
     // Add new sessions in sorted position
     const newNames = names
       .filter((n) => !this.order.includes(n))
@@ -78,48 +70,21 @@ export class SessionOrder {
     this.save();
   }
 
-  /** Hide a session from the panel without touching the underlying mux session. */
-  hide(name: string): void {
-    if (!this.order.includes(name) || this.hidden.has(name)) return;
-    this.hidden.add(name);
-    this.save();
-  }
-
-  /** Make a previously hidden session visible again. */
-  show(name: string): void {
-    if (!this.hidden.delete(name)) return;
-    if (!this.order.includes(name)) {
-      this.order.push(name);
-    }
-    this.save();
-  }
-
-  /** Restore all hidden sessions back into the panel. */
-  showAll(): void {
-    if (this.hidden.size === 0) return;
-    this.hidden.clear();
-    this.save();
-  }
-
   /** Apply the custom order to a list of session names. Returns sorted names. */
   apply(names: string[]): string[] {
     const posMap = new Map(this.order.map((n, i) => [n, i]));
-    return names
-      .filter((n) => !this.hidden.has(n))
-      .sort((a, b) => {
-        const pa = posMap.get(a) ?? Infinity;
-        const pb = posMap.get(b) ?? Infinity;
-        return pa - pb;
-      });
+    return [...names].sort((a, b) => {
+      const pa = posMap.get(a) ?? Infinity;
+      const pb = posMap.get(b) ?? Infinity;
+      return pa - pb;
+    });
   }
 
   private save(): void {
     if (!this.persistPath) return;
     try {
       mkdirSync(dirname(this.persistPath), { recursive: true });
-      const serialized =
-        this.hidden.size === 0 ? this.order : { order: this.order, hidden: [...this.hidden] };
-      writeFileSync(this.persistPath, JSON.stringify(serialized) + "\n");
+      writeFileSync(this.persistPath, JSON.stringify(this.order) + "\n");
     } catch {
       // Best-effort — don't crash if write fails
     }

package/packages/agentboard/packages/runtime/src/shared.ts

@@ -1,7 +1,10 @@
 import type { AgentStatus, AgentEvent } from "./contracts/agent";
 
-export const SERVER_PORT = 4201;
-export const SERVER_HOST = "127.0.0.1";
+export const DEFAULT_SERVER_PORT = 4201;
+export const DEFAULT_SERVER_HOST = "127.0.0.1";
+
+export const SERVER_PORT: number = Number(process.env.TT_AGENTBOARD_PORT) || DEFAULT_SERVER_PORT;
+export const SERVER_HOST: string = process.env.TT_AGENTBOARD_HOST || DEFAULT_SERVER_HOST;
 export const PID_FILE = "/tmp/agentboard.pid";
 export const SERVER_IDLE_TIMEOUT_MS = 30_000;
 export const STUCK_RUNNING_TIMEOUT_MS = 3 * 60 * 1000;
@@ -108,8 +111,6 @@ export type ClientCommand =
   | { type: "switch-session"; name: string; clientTty?: string }
   | { type: "switch-index"; index: number }
   | { type: "new-session" }
-  | { type: "hide-session"; name: string }
-  | { type: "show-all-sessions" }
   | { type: "kill-session"; name: string }
   | { type: "reorder-session"; name: string; delta: -1 | 1 }
   | { type: "refresh" }

package/src/commands/agentboard.ts

@@ -6,8 +6,8 @@ import consola from "consola";
 import { colors } from "consola/utils";
 import { debugArg } from "./shared.js";
 
-const SERVER_HOST = "127.0.0.1";
-const SERVER_PORT = 4201;
+const SERVER_HOST = process.env.TT_AGENTBOARD_HOST || "127.0.0.1";
+const SERVER_PORT = Number(process.env.TT_AGENTBOARD_PORT) || 4201;
 
 // Keybinding defaults
 const DEFAULT_KEY = "a";
@@ -146,14 +146,14 @@ function uninstall(): void {
   }
 
   const content = readFileSync(editPath, "utf8");
-  if (!content.includes("agentboard")) {
+  if (!content.includes(MARKER) && !content.includes(RUN_SHELL_LINE)) {
     consola.info("agentboard not found in tmux.conf");
     return;
   }
 
   const newContent = content
     .split("\n")
-    .filter((line) => !line.includes("agentboard"))
+    .filter((line) => !line.includes(MARKER) && !line.includes(RUN_SHELL_LINE))
     .join("\n")
     .replace(/\n{3,}/g, "\n\n");
 
@@ -333,12 +333,13 @@ async function runFocus(): Promise<void> {
     return;
   }
 
-  // Otherwise, ensure server + toggle sidebar on
+  // Otherwise, ensure server + open sidebar
   if (!(await ensureServerUp())) process.exit(0);
   const ctx = tmuxContext();
-  await fetch(`http://${SERVER_HOST}:${SERVER_PORT}/toggle`, { method: "POST", body: ctx }).catch(
-    () => {},
-  );
+  await fetch(`http://${SERVER_HOST}:${SERVER_PORT}/ensure-sidebar`, {
+    method: "POST",
+    body: ctx,
+  }).catch(() => {});
 
   // Wait for sidebar pane to appear
   for (let i = 0; i < 20; i++) {