skydive-cli 0.2.0-beta.559 → 0.2.0-beta.577

package/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to the Skydive CLI are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Added
+
+- Chat TUI sets the terminal title (OSC) to the live conversation title, so a terminal multiplexer (cmux, tmux, zellij) or window names its tab after the conversation. Follows renames from autoname, web, and Slack, and resets to a neutral default on exit.
+- Every TUI screen (pickers included), not just chat, now drives the title, and inside cmux the workspace (sidebar entry) is renamed too via the cmux control socket. A workspace title you set by hand is left untouched. The tab and workspace title read title-first (title then agent name), while the in-app status bar stays agent-first.
+
 ## [0.2.0] - 2026-07-29
 
 ### Added

package/dist/js/bin.mjs

@@ -20,7 +20,7 @@ import semver from "semver";
 
 //#region package.json
 var name = "skydive-cli";
-var version = "0.2.0-beta.559";
+var version = "0.2.0-beta.577";
 
 //#endregion
 //#region src/types.ts
@@ -1200,7 +1200,7 @@ const importCommand = {
 				process.exit(1);
 			}
 		}
-		const { runChat } = await import("./boot-CCz28zCI.mjs");
+		const { runChat } = await import("./boot--whEK1H-.mjs");
 		await runChat({
 			appUrl,
 			sessionToken: session.value.sessionToken,
@@ -1511,7 +1511,7 @@ const chatCommand = {
 			printError(`Unknown theme "${themeId}". Valid themes: ${themes.map((t) => t.id).join(", ")}`);
 			process.exit(1);
 		}
-		const { runChat } = await import("./boot-CCz28zCI.mjs");
+		const { runChat } = await import("./boot--whEK1H-.mjs");
 		await runChat({
 			appUrl,
 			sessionToken: session.value.sessionToken,
@@ -1810,7 +1810,7 @@ const switchCommand = {
 				printError("The workspace picker needs the Bun runtime and it could not be set up automatically. Pass a workspace slug instead, or install Bun and retry.");
 				process.exit(1);
 			}
-			const { runWorkspacePicker } = await import("./boot-CCz28zCI.mjs");
+			const { runWorkspacePicker } = await import("./boot--whEK1H-.mjs");
 			await runWorkspacePicker(session);
 			return;
 		}
@@ -2466,7 +2466,7 @@ function setupUpdateCheck(argv) {
 
 //#endregion
 //#region src/changelog.generated.ts
-const CHANGELOG_MD = "# Changelog\n\nAll notable changes to the Skydive CLI are documented here.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## [0.2.0] - 2026-07-29\n\n### Added\n\n**Sandbox & machine access**\n\n- Standalone `skydive sandbox` command for direct access to an agent's sandbox.\n- `/sandbox` in the chat TUI — live PTY session and one-shot command execution.\n- Headless machine sharing via `skydive portal`, with self-registering portal grants.\n- `shareMachineDefault` config key for always-on portal sharing.\n\n**Chat TUI**\n\n- File pane (`ctrl+g`) with Changes and Files tabs: a shared file tree plus source viewer and a workspace browser, mouse-resizable and responsive to terminal size.\n- Agent todo list rendered in the chat TUI, above the composer, mirroring the web chat's todo card.\n- Fuzzy finder in the conversation and agent pickers.\n- Slash-command autocomplete menu.\n- Paste or drag-and-drop any file into the composer; paste clipboard images with Cmd+V.\n- Run local shell commands with `!` in the composer.\n- Conversation recaps, streamed live title updates, and per-agent attribution on assistant turns.\n- Working timer rolls up into minutes and hours.\n- Conversation picker paginates past 50 conversations and shows only your own conversations.\n- Esc leaves a live run; typing `exit` quits the chat.\n- Cursor Dark theme.\n- Picker rows no longer overlap when a conversation title contains a newline, tab, or control character.\n\n**Headless & scripting**\n\n- Resume a conversation by id.\n- `conversations list` and `conversations show` for transcript reads.\n- `messages get`, with run recovery keyed on message id.\n- Connect cards surface in headless `-p` mode so a driving agent never gets stuck.\n\n**Authentication**\n\n- `skydive auth login` via the browser now auto-mints an API key, so one login yields both a chat session and a usable management credential. Management commands announce the key's pinned workspace when it drives them, so a workspace mismatch is visible at use time.\n- Workspace picker on the device authorization page.\n- Account and workspace identity shown in `auth status`.\n\n**Platform**\n\n- Standalone binary builds compiling the CLI into a per-target executable.\n- Interactive workspace switcher; management commands follow the active workspace.\n- Terminal host integrations and agent notifications.\n\n### Fixed\n\n- Transcript errors collapse to one line, click to expand (REST and portal errors keep their full body).\n- Dragged/pasted image file paths attach the file instead of inserting path text, including macOS paths with literal parentheses.\n- Bare URLs in chat markdown are hyperlinked so they survive text wrap.\n- Composer draft is preserved across TUI overlays.\n- Relative connect links resolve before opening the browser.\n- Numbered markdown headings render colored in the TUI.\n- Chat transcript pages by 75% of a screen; picker rows stay on one line.\n- Run starts push to the TUI over the conversation stream.\n- Security: remediated high-severity dependency findings and cleared tar/shell-quote CVEs.\n\n## [0.1.0] - 2026-07-21\n\nInitial public release: `skydive chat` TUI, agent and conversation management,\ndevice authorization, and headless `-p` mode.\n";
+const CHANGELOG_MD = "# Changelog\n\nAll notable changes to the Skydive CLI are documented here.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## [Unreleased]\n\n### Added\n\n- Chat TUI sets the terminal title (OSC) to the live conversation title, so a terminal multiplexer (cmux, tmux, zellij) or window names its tab after the conversation. Follows renames from autoname, web, and Slack, and resets to a neutral default on exit.\n- Every TUI screen (pickers included), not just chat, now drives the title, and inside cmux the workspace (sidebar entry) is renamed too via the cmux control socket. A workspace title you set by hand is left untouched. The tab and workspace title read title-first (title then agent name), while the in-app status bar stays agent-first.\n\n## [0.2.0] - 2026-07-29\n\n### Added\n\n**Sandbox & machine access**\n\n- Standalone `skydive sandbox` command for direct access to an agent's sandbox.\n- `/sandbox` in the chat TUI — live PTY session and one-shot command execution.\n- Headless machine sharing via `skydive portal`, with self-registering portal grants.\n- `shareMachineDefault` config key for always-on portal sharing.\n\n**Chat TUI**\n\n- File pane (`ctrl+g`) with Changes and Files tabs: a shared file tree plus source viewer and a workspace browser, mouse-resizable and responsive to terminal size.\n- Agent todo list rendered in the chat TUI, above the composer, mirroring the web chat's todo card.\n- Fuzzy finder in the conversation and agent pickers.\n- Slash-command autocomplete menu.\n- Paste or drag-and-drop any file into the composer; paste clipboard images with Cmd+V.\n- Run local shell commands with `!` in the composer.\n- Conversation recaps, streamed live title updates, and per-agent attribution on assistant turns.\n- Working timer rolls up into minutes and hours.\n- Conversation picker paginates past 50 conversations and shows only your own conversations.\n- Esc leaves a live run; typing `exit` quits the chat.\n- Cursor Dark theme.\n- Picker rows no longer overlap when a conversation title contains a newline, tab, or control character.\n\n**Headless & scripting**\n\n- Resume a conversation by id.\n- `conversations list` and `conversations show` for transcript reads.\n- `messages get`, with run recovery keyed on message id.\n- Connect cards surface in headless `-p` mode so a driving agent never gets stuck.\n\n**Authentication**\n\n- `skydive auth login` via the browser now auto-mints an API key, so one login yields both a chat session and a usable management credential. Management commands announce the key's pinned workspace when it drives them, so a workspace mismatch is visible at use time.\n- Workspace picker on the device authorization page.\n- Account and workspace identity shown in `auth status`.\n\n**Platform**\n\n- Standalone binary builds compiling the CLI into a per-target executable.\n- Interactive workspace switcher; management commands follow the active workspace.\n- Terminal host integrations and agent notifications.\n\n### Fixed\n\n- Transcript errors collapse to one line, click to expand (REST and portal errors keep their full body).\n- Dragged/pasted image file paths attach the file instead of inserting path text, including macOS paths with literal parentheses.\n- Bare URLs in chat markdown are hyperlinked so they survive text wrap.\n- Composer draft is preserved across TUI overlays.\n- Relative connect links resolve before opening the browser.\n- Numbered markdown headings render colored in the TUI.\n- Chat transcript pages by 75% of a screen; picker rows stay on one line.\n- Run starts push to the TUI over the conversation stream.\n- Security: remediated high-severity dependency findings and cleared tar/shell-quote CVEs.\n\n## [0.1.0] - 2026-07-21\n\nInitial public release: `skydive chat` TUI, agent and conversation management,\ndevice authorization, and headless `-p` mode.\n";
 
 //#endregion
 //#region src/whats-new.ts

package/dist/js/{boot-CCz28zCI.mjs → boot--whEK1H-.mjs}

@@ -19,7 +19,7 @@ import { MarkdownRenderable, RenderableEvents, SyntaxStyle, createCliRenderer, d
 import { createRoot, extend, useKeyboard, usePaste, useRenderer, useTerminalDimensions } from "@opentui/react";
 import { createContext, memo, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
 import { create } from "zustand";
-import { createConnection } from "node:net";
+import { connect, createConnection } from "node:net";
 import { access, appendFile, mkdir, mkdtemp, readFile, readdir, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
 import { Fragment, jsx, jsxs } from "@opentui/react/jsx-runtime";
 import fuzzysort from "fuzzysort";
@@ -272,6 +272,7 @@ function usePortal({ appUrl, sessionToken, shareMachine }) {
 const noopAgentHost = {
 	transition() {},
 	setSession() {},
+	setTitle() {},
 	dispose() {}
 };
 const AgentHostContext = createContext(noopAgentHost);
@@ -293,6 +294,10 @@ function composeAgentHost(adapters) {
 			if (disposed) return;
 			for (const adapter of adapters) adapter.setSession?.(sessionId);
 		},
+		setTitle(title) {
+			if (disposed) return;
+			for (const adapter of adapters) adapter.setTitle?.(title);
+		},
 		dispose() {
 			if (disposed) return;
 			disposed = true;
@@ -354,6 +359,167 @@ function createTerminalNotificationsAdapter({ renderer, enabled }) {
 	};
 }
 
+//#endregion
+//#region src/chat/agent-host/adapters/terminal-title.ts
+/**
+* The title shown when there is no conversation title yet, or after the chat
+* closes. Keeps the tab identifiable as this CLI rather than leaving a stale
+* conversation name behind.
+*/
+const DEFAULT_TERMINAL_TITLE = "skydive";
+/**
+* Collapses a conversation title to a single terminal-title line. Titles arrive
+* from autoname / web / Slack and can carry newlines, tabs, or other control
+* characters (the same reason picker rows sanitize them); a raw newline in an
+* OSC title terminates the sequence early and corrupts the tab, so flatten
+* whitespace and drop C0 controls. Empty or whitespace-only input falls back to
+* the default so the tab is never blanked.
+*/
+function terminalTitleFor(title) {
+	if (!title) return DEFAULT_TERMINAL_TITLE;
+	return title.replace(/[\u0000-\u001f\u007f]+/g, " ").trim() || DEFAULT_TERMINAL_TITLE;
+}
+/**
+* Mirrors the live conversation title onto the terminal title (OSC), so a
+* multiplexer tab or window carries the conversation name instead of a bare
+* shell/binary label. OpenTUI owns the escape transport via
+* `setTerminalTitle`, so this never interleaves with the rendered frame.
+*
+* Writes are deduped, and the title is reset to a neutral default on dispose so
+* leaving the chat doesn't strand the last conversation's name on the tab.
+*/
+function createTerminalTitleAdapter({ renderer }) {
+	let last;
+	const apply = (next) => {
+		if (next === last) return;
+		last = next;
+		try {
+			renderer.setTerminalTitle(next);
+		} catch (_error) {}
+	};
+	return {
+		setTitle(title) {
+			apply(terminalTitleFor(title));
+		},
+		dispose() {
+			apply(DEFAULT_TERMINAL_TITLE);
+		}
+	};
+}
+
+//#endregion
+//#region src/chat/agent-host/adapters/cmux/workspace-title.ts
+/**
+* cmux is present only inside a cmux terminal. Reads the socket path and
+* workspace id from the environment; returns null when either is missing, so
+* the caller registers no adapter outside cmux.
+*/
+function cmuxWorkspaceEnv(env = process.env) {
+	const socketPath = env.CMUX_SOCKET_PATH?.trim();
+	const workspaceId = env.CMUX_WORKSPACE_ID?.trim();
+	if (!socketPath || !workspaceId) return null;
+	if (!socketPath.startsWith("/")) return null;
+	return {
+		socketPath,
+		workspaceId
+	};
+}
+/** The fields of a `workspace.current` result we care about. */
+const workspaceCurrentSchema = z.object({
+	workspace_id: z.string().optional(),
+	has_custom_title: z.boolean().optional()
+});
+/** True when the current workspace carries a user-set custom title. */
+async function hasUserCustomTitle(socket, workspaceId) {
+	const res = await socket.request("workspace.current", {});
+	const parsed = res?.ok ? workspaceCurrentSchema.safeParse(res.result) : void 0;
+	if (!parsed?.success) return false;
+	const result = parsed.data;
+	if (result.workspace_id && result.workspace_id !== workspaceId) return false;
+	return result.has_custom_title === true;
+}
+function createCmuxWorkspaceTitleAdapter({ socket, workspaceId }) {
+	let lastApplied;
+	let chain = Promise.resolve();
+	let pending = null;
+	const flush = async () => {
+		const desired = pending;
+		pending = null;
+		if (desired === null || desired === lastApplied) return;
+		if (await hasUserCustomTitle(socket, workspaceId)) {
+			lastApplied = desired;
+			return;
+		}
+		if ((await socket.request("workspace.rename", {
+			workspace_id: workspaceId,
+			title: desired
+		}))?.ok) lastApplied = desired;
+	};
+	return { setTitle(title) {
+		const next = title?.trim();
+		if (!next) return;
+		pending = next;
+		chain = chain.then(flush, flush);
+	} };
+}
+
+//#endregion
+//#region src/chat/agent-host/adapters/cmux/socket.ts
+const cmuxRpcResponseSchema = z.object({
+	ok: z.boolean(),
+	result: z.unknown().optional(),
+	error: z.unknown().optional()
+});
+/** How long to wait for a single round-trip before giving up. */
+const RPC_TIMEOUT_MS = 1500;
+function createCmuxSocket({ socketPath, timeoutMs = RPC_TIMEOUT_MS }) {
+	let seq = 0;
+	return { request(method, params) {
+		return new Promise((resolve) => {
+			let settled = false;
+			const finish = (value) => {
+				if (settled) return;
+				settled = true;
+				clearTimeout(timer);
+				try {
+					socket.destroy();
+				} catch (_error) {}
+				resolve(value);
+			};
+			const timer = setTimeout(() => finish(null), timeoutMs);
+			const id = `skydive-${++seq}`;
+			let buffer = "";
+			const socket = connect(socketPath);
+			socket.setEncoding("utf8");
+			socket.on("connect", () => {
+				try {
+					socket.write(`${JSON.stringify({
+						id,
+						method,
+						params
+					})}\n`);
+				} catch (_error) {
+					finish(null);
+				}
+			});
+			socket.on("data", (chunk) => {
+				buffer += chunk;
+				const newline = buffer.indexOf("\n");
+				if (newline === -1) return;
+				const line = buffer.slice(0, newline);
+				try {
+					const parsed = cmuxRpcResponseSchema.safeParse(JSON.parse(line));
+					finish(parsed.success ? parsed.data : null);
+				} catch (_error) {
+					finish(null);
+				}
+			});
+			socket.on("error", () => finish(null));
+			socket.on("close", () => finish(null));
+		});
+	} };
+}
+
 //#endregion
 //#region src/chat/agent-host/adapters/herdr/adapter.ts
 /** Maps one complete semantic transition to one herdr state report. */
@@ -523,7 +689,12 @@ function createAgentHost({ renderer, notifications }) {
 	const adapters = [createTerminalNotificationsAdapter({
 		renderer,
 		enabled: notifications
-	})];
+	}), createTerminalTitleAdapter({ renderer })];
+	const cmux = cmuxWorkspaceEnv();
+	if (cmux) adapters.push(createCmuxWorkspaceTitleAdapter({
+		socket: createCmuxSocket({ socketPath: cmux.socketPath }),
+		workspaceId: cmux.workspaceId
+	}));
 	const herdr = createHerdrReporter();
 	if (herdr) adapters.push(createHerdrAdapter(herdr));
 	return composeAgentHost(adapters);
@@ -840,22 +1011,52 @@ function portalIndicator(portal) {
 		};
 	}
 }
-function screenLabel(screen, chatTitle) {
+/**
+* The per-screen label, split into its parts: the screen's own `title` and,
+* when the screen belongs to an agent, that `agentName`. Kept structured so the
+* two surfaces can order the parts differently — the status bar reads
+* agent-first (a header), the terminal/workspace title reads title-first.
+*/
+function screenLabelParts(screen, chatTitle) {
 	switch (screen.kind) {
-		case "splash": return "";
-		case "error": return "";
-		case "agent-picker": return "pick an agent";
-		case "agent-create": return "create an agent";
-		case "workspace-picker": return "switch workspace";
-		case "conversation-picker": return `${screen.agent.name} · pick a conversation`;
+		case "splash": return { title: "" };
+		case "error": return { title: "" };
+		case "agent-picker": return { title: "pick an agent" };
+		case "agent-create": return { title: "create an agent" };
+		case "workspace-picker": return { title: "switch workspace" };
+		case "conversation-picker": return {
+			title: "pick a conversation",
+			agentName: screen.agent.name
+		};
 		case "chat": {
 			const c = screen.conversation;
 			const known = isNewConv(c) ? null : c.title ?? null;
-			const label = chatTitle ?? known ?? (isNewConv(c) ? "new conversation" : "untitled");
-			return `${screen.agent.name} · ${label}`;
+			return {
+				title: chatTitle ?? known ?? (isNewConv(c) ? "new conversation" : "untitled"),
+				agentName: screen.agent.name
+			};
 		}
 	}
 }
+/**
+* Status-bar label: agent-first (`agent · title`), which reads as a header of
+* who you're talking to and where.
+*/
+function screenLabel(screen, chatTitle) {
+	const { title, agentName } = screenLabelParts(screen, chatTitle);
+	if (!title) return "";
+	return agentName ? `${agentName} · ${title}` : title;
+}
+/**
+* Terminal tab / cmux workspace title: title-first (`title · agent`), so the
+* conversation reads first in a tab or sidebar entry, with the agent as the
+* trailing qualifier.
+*/
+function titleLabel(screen, chatTitle) {
+	const { title, agentName } = screenLabelParts(screen, chatTitle);
+	if (!title) return "";
+	return agentName ? `${title} · ${agentName}` : title;
+}
 function isNewConv(c) {
 	return "kind" in c && c.kind === "new";
 }
@@ -10036,6 +10237,7 @@ function ToastView() {
 function App({ appUrl, sessionToken, shareMachine, promptHistoryPath, notifications, agentSelector, conversationId }) {
 	const renderer = useRenderer();
 	const screen = useStore((s) => s.screen);
+	const chatTitle = useStore((s) => s.chatTitle);
 	useStore((s) => s.themeId);
 	const rest = useStore((s) => s.rest);
 	const goTo = useStore((s) => s.goTo);
@@ -10054,6 +10256,13 @@ function App({ appUrl, sessionToken, shareMachine, promptHistoryPath, notificati
 		agentHost.transition({ state: "idle" });
 		return () => agentHost.dispose();
 	}, [agentHost]);
+	useEffect(() => {
+		agentHost.setTitle(titleLabel(screen, chatTitle));
+	}, [
+		agentHost,
+		screen,
+		chatTitle
+	]);
 	useEffect(() => {
 		const selectionCopy = createSelectionCopy({
 			renderer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skydive-cli",
-  "version": "0.2.0-beta.559",
+  "version": "0.2.0-beta.577",
   "description": "Skydive CLI — cloud agents from the command line",
   "homepage": "https://skydive.com",
   "license": "MIT",