skydive-cli 0.5.0-beta.19 → 0.5.0-beta.20

package/CHANGELOG.md

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- First run in a workspace with no agents now sets you up automatically: instead of dropping you on an empty agent picker, `skydive` creates your first agent for you (with a suggested name and avatar, mirroring the web onboarding flow) and then offers to have it learn how you already work — reading the other coding agents set up on your machine (Claude Code, Cursor, Codex, and more), the same import that `skydive import` runs, with a plan shown first and credentials never copied. Decline and you go straight into the new agent's chat. You can replay this flow anytime with `skydive --onboarding` (or `SKYDIVE_FORCE_ONBOARDING=1`), even in a workspace that already has agents.
 - `/computer` (alias `/stats`) in the chat TUI — a snapshot of the agent's sandbox drawn as colored bar graphs: CPU load (scaled to core count), memory, swap (when present), and disk usage, plus uptime and process count. Bars turn amber past 75%% and red past 90%% so a glance tells you whether the box is under pressure. The card keeps itself current quietly (a slow background refresh, no flicker or "updating" chrome); only the most recent card refreshes, and it silently stops while you're scrolled up (no wasted polls on a card you're not looking at) and resumes at the bottom. Stats are read over the same relay `skydive sandbox` uses, so it's gated on EDIT access to the agent like the other sandbox commands.
 - `skydive fs` — a namespace for working with the files on an agent's computer (its sandbox) from your own machine. Its first subcommand, `skydive fs edit <path>`, reads a remote file down over the same relay `skydive sandbox` uses, opens it in your local editor (`$VISUAL`/`$EDITOR`, override with `--editor`, defaults to `vi`), and writes your changes back atomically when you save and close — so you can edit a remote file as if it were local without opening the chat TUI. A path that doesn't exist yet is created on save; no changes means nothing is written. Access is gated on EDIT permission for the agent, exactly like `skydive sandbox`. (A first-class `fs` relay channel and `skydive fs mount` land in follow-ups.)
 

package/dist/js/bin.mjs

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { A as version, D as listWorkspaces, E as getSessionIdentity, O as setActiveWorkspace, S as themes, T as getActiveWorkspaceId, a as installCrashHandler, k as name, t as maybeStartProfiling, u as brandHelpArt, w as ensureActiveOrganization } from "./profiler-DlxtXXGp.mjs";
-import { A as getStoredApiKeyId, B as saveConfig, C as getDefaultAgent, E as getPromptHistoryPath, F as resolveChatAuth, I as resolveConfig, L as resolveManagementAuth, M as getUpdateCheckDisabled, P as resolveAppUrl, R as resolveSession, S as getConfigPath, T as getPreference, U as setLastSeenVersion, V as saveSession, _ as API_KEY_PREFIX, b as PREFERENCES, g as API_KEY_FAMILY_PREFIX, h as API_KEYS_URL, i as resolveAgent, j as getStoredApiKeyWorkspaceName, k as getShareMachineDefault, v as DEFAULT_API_URL, w as getLastSeenVersion, x as deleteConfig } from "./print-CPRgbo2N.mjs";
+import { A as setActiveWorkspace, D as getActiveWorkspaceId, E as ensureActiveOrganization, M as version, O as getSessionIdentity, S as themes, T as machineOsFromPlatform, a as installCrashHandler, j as name, k as listWorkspaces, t as maybeStartProfiling, u as brandHelpArt, w as buildImportSeedPrompt } from "./profiler-C44QO8Op.mjs";
+import { A as getStoredApiKeyId, B as saveConfig, C as getDefaultAgent, E as getPromptHistoryPath, F as resolveChatAuth, I as resolveConfig, L as resolveManagementAuth, M as getUpdateCheckDisabled, P as resolveAppUrl, R as resolveSession, S as getConfigPath, T as getPreference, U as setLastSeenVersion, V as saveSession, _ as API_KEY_PREFIX, b as PREFERENCES, g as API_KEY_FAMILY_PREFIX, h as API_KEYS_URL, i as resolveAgent, j as getStoredApiKeyWorkspaceName, k as getShareMachineDefault, v as DEFAULT_API_URL, w as getLastSeenVersion, x as deleteConfig } from "./print-OvYyj6Uk.mjs";
 import { n as printError, r as printTable, t as output } from "./output-DYzzdXYV.mjs";
 import { t as HttpError } from "./http-error-DzyrsLAZ.mjs";
-import { t as createRestClient } from "./rest-CLrHVkxh.mjs";
+import { t as createRestClient } from "./rest-Dx6b-Nq_.mjs";
 import "./billing-blocked-2wju4gC_.mjs";
 import { r as resolveMachineIdentity } from "./client-DbqRBquD.mjs";
-import { i as queryDaemonStatus, l as PORTAL_DAEMON_FLAG, n as ensureDaemonRunning, s as stopDaemon, u as daemonPaths } from "./daemon-DWw9AjB4.mjs";
+import { i as queryDaemonStatus, l as PORTAL_DAEMON_FLAG, n as ensureDaemonRunning, s as stopDaemon, u as daemonPaths } from "./daemon-WOEEiYWf.mjs";
 import { i as grantPortalAccess, n as fetchPortalDevices, o as registerPortalDevice, r as findThisDevice, s as revokePortalAccess } from "./api-DG5W6iwx.mjs";
 import { t as SandboxStream } from "./client-c4c5MmgN.mjs";
 import { hideBin } from "yargs/helpers";
@@ -1463,19 +1463,6 @@ function ensureBunAndReexec(onProgress) {
 
 //#endregion
 //#region src/commands/import.ts
-/**
-* The first message of the import conversation, sent as the user. It hands
-* the real work to the agent's `import-config` skill; this text only needs
-* to establish intent, anchor the starting directory, and set the two
-* expectations the user cares about most (plan first, no credentials).
-*/
-function buildImportSeedPrompt(projectDir) {
-	return [
-		"I'm migrating from another coding agent. Import my setup from this machine.",
-		"",
-		`Use your import-config skill. I ran this from \`${projectDir}\`, so start there and in my home directory. Don't assume one tool — do the discovery sweep so you catch whatever I actually use (Claude Code, Cursor, Codex, Gemini CLI, Copilot, Windsurf, Cline, OpenCode, Aider, and any nested AGENTS.md). Show me the plan first: everything you found, what you'll bring over, where it lands in you, and anything you're leaving out (credentials especially). Then wait for my OK before committing anything.`
-	].join("\n");
-}
 const importCommand = {
 	command: "import",
 	describe: "Import your existing coding-agent setup (Claude Code, Cursor, Codex, Gemini, Copilot, and more) into an agent (opens a machine-shared chat)",
@@ -1517,7 +1504,7 @@ const importCommand = {
 				process.exit(1);
 			}
 		}
-		const { runChat } = await import("./boot-C831RDoa.mjs");
+		const { runChat } = await import("./boot-DX50EPUe.mjs");
 		await runChat({
 			appUrl,
 			sessionToken: session.value.sessionToken,
@@ -1528,7 +1515,8 @@ const importCommand = {
 			conversationId: null,
 			newConversation: false,
 			defaultAgentSelector: getDefaultAgent(),
-			seedPrompt: buildImportSeedPrompt(process.cwd())
+			forceOnboarding: false,
+			seedPrompt: buildImportSeedPrompt(process.cwd(), machineOsFromPlatform(process.platform))
 		});
 	}
 };
@@ -1552,8 +1540,8 @@ async function runImportPrintMode({ argv, appUrl }) {
 		timeoutHint: "Check `skydive portal status`, then re-run."
 	});
 	const extra = (argv.print ?? "").trim();
-	const prompt = buildImportSeedPrompt(process.cwd()) + (extra ? `\n\nAdditional instructions: ${extra}` : "");
-	const { runPrint } = await import("./print-D8L3DAbD.mjs");
+	const prompt = buildImportSeedPrompt(process.cwd(), machineOsFromPlatform(process.platform)) + (extra ? `\n\nAdditional instructions: ${extra}` : "");
+	const { runPrint } = await import("./print-C8DHKrJu.mjs");
 	try {
 		const result = await runPrint({
 			appUrl,
@@ -1879,6 +1867,10 @@ const chatCommand = {
 		type: "boolean",
 		default: false,
 		describe: "Start a fresh conversation instead of opening the conversation list. With --agent, opens a new conversation with that agent directly. Without --agent, opens a new conversation once you pick an agent (auto-picked if the account has only one). Ignored with --resume, which always continues the named conversation."
+	}).option("onboarding", {
+		type: "boolean",
+		default: false,
+		describe: "Force the first-run onboarding flow (auto-create a first agent, then offer the machine import) even when the workspace already has agents. Also settable via SKYDIVE_FORCE_ONBOARDING=1. Handy for replaying the new-user experience; ignored with -p, --resume, or --agent."
 	}).option("share-machine", {
 		type: "boolean",
 		describe: "Share this machine with the agent over the portal so it can run commands here (default-deny; in the TUI you approve per agent, with -p the flag grants the target agent for the run). Defaults to `shareMachineDefault` in the CLI config file; --no-share-machine disables for this invocation."
@@ -1930,7 +1922,7 @@ const chatCommand = {
 			sessionToken: auth.value.token,
 			agentSelector: argv.agent ?? null
 		});
-		const { runChat } = await import("./boot-C831RDoa.mjs");
+		const { runChat } = await import("./boot-DX50EPUe.mjs");
 		await runChat({
 			appUrl: auth.value.appUrl,
 			sessionToken: auth.value.token,
@@ -1942,6 +1934,7 @@ const chatCommand = {
 			agentSelector: argv.agent ?? null,
 			conversationId: argv.conversation ?? null,
 			newConversation: resolveNewConversation(argv),
+			forceOnboarding: resolveForceOnboarding(argv),
 			defaultAgentSelector: getDefaultAgent(),
 			seedPrompt: null
 		});
@@ -1964,6 +1957,20 @@ function resolveNewConversation(argv) {
 	return argv.new === true && !argv.conversation;
 }
 /**
+* Whether to force the first-run onboarding flow: the `--onboarding` flag or
+* `SKYDIVE_FORCE_ONBOARDING` (any non-empty, non-"0"/"false" value). Lets the
+* new-user experience be replayed in a workspace that already has agents. The
+* TUI applies it only to a bare interactive launch — an explicit
+* `--agent`/`--resume`/`--new` still takes precedence.
+*/
+function resolveForceOnboarding(argv, env = process.env) {
+	if (argv.onboarding === true) return true;
+	const raw = env["SKYDIVE_FORCE_ONBOARDING"];
+	if (raw === void 0) return false;
+	const value = raw.trim().toLowerCase();
+	return value !== "" && value !== "0" && value !== "false";
+}
+/**
 * Cross-workspace `--agent <uuid>` handling shared by the TUI and -p paths:
 * on a hit in another workspace, switch to it and say so on stderr (stdout
 * may carry the -p reply/JSON envelope); when the id matches no workspace on
@@ -1998,7 +2005,7 @@ async function runPrintMode({ argv, appUrl }) {
 		printError(`${auth.error.message} For non-interactive use, run \`skydive auth login\` first, or set SKYDIVE_API_KEY / SKYDIVE_SESSION_TOKEN.`);
 		process.exit(1);
 	}
-	const { runPrint, readStdin } = await import("./print-D8L3DAbD.mjs");
+	const { runPrint, readStdin } = await import("./print-C8DHKrJu.mjs");
 	await ensureAgentWorkspace({
 		appUrl,
 		sessionToken: auth.value.token,
@@ -2087,7 +2094,7 @@ const getCommand$1 = {
 			printError(`${auth.error.message} Run \`skydive auth login\` first, or set SKYDIVE_API_KEY / SKYDIVE_SESSION_TOKEN.`);
 			process.exit(1);
 		}
-		const { messageGet } = await import("./print-D8L3DAbD.mjs");
+		const { messageGet } = await import("./print-C8DHKrJu.mjs");
 		try {
 			const result = await messageGet({
 				appUrl: auth.value.appUrl,
@@ -2290,7 +2297,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-C831RDoa.mjs");
+			const { runWorkspacePicker } = await import("./boot-DX50EPUe.mjs");
 			await runWorkspacePicker(session);
 			return;
 		}
@@ -2369,7 +2376,7 @@ const openCommand = {
 		const agent = argv.agent ? resolveAgent((await fetchPortalDevices(session)).agents, argv.agent) : null;
 		const cwd = argv.cwd ? path.resolve(argv.cwd) : process.cwd();
 		const { machineName } = await resolveMachineIdentity(null);
-		const { PortalDaemonClient } = await import("./daemon-client-CMsS0Ayk.mjs");
+		const { PortalDaemonClient } = await import("./daemon-client-BL3EohF6.mjs");
 		let lastLine = "";
 		let signalConnected;
 		const connected = new Promise((resolve) => {
@@ -2679,8 +2686,8 @@ const sandboxCommand = {
 	}).example("skydive sandbox --agent grace", "Live terminal (Ctrl-] detaches)").example("skydive sandbox --agent grace -- tail -n 50 /tmp/harness.log", "One-shot command (use `--` so its flags reach the sandbox)").example("skydive sandbox --agent grace -- sh -c 'ls /tmp | wc -l'", "Shell features go through an explicit `sh -c`"),
 	handler: async (argv) => {
 		const session = requireSession(argv);
-		const { createRestClient } = await import("./rest-DsdPAE8K.mjs");
-		const { resolveAgent } = await import("./print-D8L3DAbD.mjs");
+		const { createRestClient } = await import("./rest-DW05dMMc.mjs");
+		const { resolveAgent } = await import("./print-C8DHKrJu.mjs");
 		const client = createRestClient({
 			appUrl: session.appUrl,
 			sessionToken: session.sessionToken
@@ -2837,8 +2844,8 @@ const fsEditCommand = {
 	handler: async (argv) => {
 		const session = requireSession(argv);
 		const remotePath = argv.path;
-		const { createRestClient } = await import("./rest-DsdPAE8K.mjs");
-		const { resolveAgent } = await import("./print-D8L3DAbD.mjs");
+		const { createRestClient } = await import("./rest-DW05dMMc.mjs");
+		const { resolveAgent } = await import("./print-C8DHKrJu.mjs");
 		const client = createRestClient({
 			appUrl: session.appUrl,
 			sessionToken: session.sessionToken
@@ -4072,7 +4079,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## [Unreleased]\n\n### Added\n\n- `/computer` (alias `/stats`) in the chat TUI — a snapshot of the agent's sandbox drawn as colored bar graphs: CPU load (scaled to core count), memory, swap (when present), and disk usage, plus uptime and process count. Bars turn amber past 75%% and red past 90%% so a glance tells you whether the box is under pressure. The card keeps itself current quietly (a slow background refresh, no flicker or \"updating\" chrome); only the most recent card refreshes, and it silently stops while you're scrolled up (no wasted polls on a card you're not looking at) and resumes at the bottom. Stats are read over the same relay `skydive sandbox` uses, so it's gated on EDIT access to the agent like the other sandbox commands.\n- `skydive fs` — a namespace for working with the files on an agent's computer (its sandbox) from your own machine. Its first subcommand, `skydive fs edit <path>`, reads a remote file down over the same relay `skydive sandbox` uses, opens it in your local editor (`$VISUAL`/`$EDITOR`, override with `--editor`, defaults to `vi`), and writes your changes back atomically when you save and close — so you can edit a remote file as if it were local without opening the chat TUI. A path that doesn't exist yet is created on save; no changes means nothing is written. Access is gated on EDIT permission for the agent, exactly like `skydive sandbox`. (A first-class `fs` relay channel and `skydive fs mount` land in follow-ups.)\n\n## [0.4.0] - 2026-08-07\n\n### Added\n\n- `skydive chat` works with API key auth: an API key alone now opens the chat TUI (and headless `chat -p`) without a browser login, using the key's pinned workspace.\n- `skydive config` command to view and set the safe, hand-editable CLI preferences (`shareMachineDefault`, `updateCheck`) without opening `config.json`. `config`/`config list` shows each key, its effective value, and whether it comes from the file or the built-in default; `config get`/`set`/`unset` read and change one key; `config path` prints the config file location. It only ever touches those preference keys, never credentials or flow-managed state.\n- Billing-blocked sends and runs now surface the server-authored recovery\n  guidance from the typed billing outcome. The chat TUI renders it as a\n  warning-toned system-notice row — live when a send is refused or a run is\n  stopped at the billing boundary, and again when reopening a conversation\n  that holds a persisted billing notice — instead of a generic error.\n  Headless `chat -p` and `messages get` print the guidance (state, recovery\n  step, and manage-billing URL) on stderr, keep any partial output already\n  streamed on stdout, and exit with code `5` (distinct from the generic `1`)\n  so scripted callers can tell a billing pause from a failure.\n- Syntax highlighting for 14 more languages in the chat transcript and file/review panes (python, bash, go, rust, c, cpp, java, ruby, css, html, json, yaml, and more) — previously only JavaScript/TypeScript rendered colored.\n\n### Changed\n\n- `skydive agent list` lists the full agent roster by default instead of a truncated page.\n\n### Fixed\n\n- Long multi-line bash tool-call commands (e.g. heredocs) are clamped with a `+N more · click to expand` tail instead of dumping their whole body into the scrollback.\n- Tool error output is clipped the same way as ok output, so a failing command no longer floods the transcript.\n- The TUI toast overlay has an opaque background instead of letting the transcript bleed through.\n\n## [0.3.0] - 2026-08-04\n\n### Added\n\n**Chat TUI**\n\n- `/fork` slash command to fork a conversation at any point and continue in a new thread.\n- `/conversation` switches threads from inside a live session.\n- `/compact` triggers manual conversation compaction.\n- `/portal` and `/copy` slash commands.\n- Archive the current conversation from the chat TUI.\n- `--new` flag on `skydive chat` to start a fresh conversation.\n- Debounced server-side conversation search in the picker, with title matches ranked first.\n- File review pane orientation toggle, and review comments in the file pane.\n- Pinned plan card controls and a jump-to-latest hint.\n- Terminal title (OSC) follows the live conversation title on every screen; inside cmux the workspace is renamed too, and linked PRs are pushed to the cmux sidebar.\n- Every participating agent shows in the conversation list; connect cards each have their own identity, and ctrl+r asks which connect card to act on.\n- Colored Skydive splash art in `skydive --help` and the TUI pickers.\n- New-agent name prefilled from the server's suggestion.\n\n**CLI & platform**\n\n- `skydive update` self-updater, with an update notice when a new version is available.\n- Shell completions for bash, zsh, and fish via `completion install`.\n- Portal daemon: one connection per host with per-conversation working directories.\n- Agent-led coding-agent import (`skydive import`).\n- Per-workspace scoping on the REST client, and cross-org `--agent <uuid>` auto-switches workspace.\n- `skydive-beta` wrapper for the canary channel.\n\n### Fixed\n\n- `skydive update` no longer claims an update is available on every npm install.\n- Chat memory is bounded (payload clamps + windowed rows) with a memory watchdog and OOM diagnostic report; transcript rows are memoized so streaming stops re-rendering the whole chat.\n- Chat-send failures map to real error messages.\n- Notification and sidebar previews use the last text block of the reply and strip inline markdown.\n- Picker rows no longer overlap when a conversation title contains a newline, tab, or control character.\n- Sending to non-web channel conversations is blocked in the TUI.\n- GitHub bot connect opens on the web front door, not api.skydive.com.\n- TUI activity counter times from the run, not the screen.\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- First run in a workspace with no agents now sets you up automatically: instead of dropping you on an empty agent picker, `skydive` creates your first agent for you (with a suggested name and avatar, mirroring the web onboarding flow) and then offers to have it learn how you already work — reading the other coding agents set up on your machine (Claude Code, Cursor, Codex, and more), the same import that `skydive import` runs, with a plan shown first and credentials never copied. Decline and you go straight into the new agent's chat. You can replay this flow anytime with `skydive --onboarding` (or `SKYDIVE_FORCE_ONBOARDING=1`), even in a workspace that already has agents.\n- `/computer` (alias `/stats`) in the chat TUI — a snapshot of the agent's sandbox drawn as colored bar graphs: CPU load (scaled to core count), memory, swap (when present), and disk usage, plus uptime and process count. Bars turn amber past 75%% and red past 90%% so a glance tells you whether the box is under pressure. The card keeps itself current quietly (a slow background refresh, no flicker or \"updating\" chrome); only the most recent card refreshes, and it silently stops while you're scrolled up (no wasted polls on a card you're not looking at) and resumes at the bottom. Stats are read over the same relay `skydive sandbox` uses, so it's gated on EDIT access to the agent like the other sandbox commands.\n- `skydive fs` — a namespace for working with the files on an agent's computer (its sandbox) from your own machine. Its first subcommand, `skydive fs edit <path>`, reads a remote file down over the same relay `skydive sandbox` uses, opens it in your local editor (`$VISUAL`/`$EDITOR`, override with `--editor`, defaults to `vi`), and writes your changes back atomically when you save and close — so you can edit a remote file as if it were local without opening the chat TUI. A path that doesn't exist yet is created on save; no changes means nothing is written. Access is gated on EDIT permission for the agent, exactly like `skydive sandbox`. (A first-class `fs` relay channel and `skydive fs mount` land in follow-ups.)\n\n## [0.4.0] - 2026-08-07\n\n### Added\n\n- `skydive chat` works with API key auth: an API key alone now opens the chat TUI (and headless `chat -p`) without a browser login, using the key's pinned workspace.\n- `skydive config` command to view and set the safe, hand-editable CLI preferences (`shareMachineDefault`, `updateCheck`) without opening `config.json`. `config`/`config list` shows each key, its effective value, and whether it comes from the file or the built-in default; `config get`/`set`/`unset` read and change one key; `config path` prints the config file location. It only ever touches those preference keys, never credentials or flow-managed state.\n- Billing-blocked sends and runs now surface the server-authored recovery\n  guidance from the typed billing outcome. The chat TUI renders it as a\n  warning-toned system-notice row — live when a send is refused or a run is\n  stopped at the billing boundary, and again when reopening a conversation\n  that holds a persisted billing notice — instead of a generic error.\n  Headless `chat -p` and `messages get` print the guidance (state, recovery\n  step, and manage-billing URL) on stderr, keep any partial output already\n  streamed on stdout, and exit with code `5` (distinct from the generic `1`)\n  so scripted callers can tell a billing pause from a failure.\n- Syntax highlighting for 14 more languages in the chat transcript and file/review panes (python, bash, go, rust, c, cpp, java, ruby, css, html, json, yaml, and more) — previously only JavaScript/TypeScript rendered colored.\n\n### Changed\n\n- `skydive agent list` lists the full agent roster by default instead of a truncated page.\n\n### Fixed\n\n- Long multi-line bash tool-call commands (e.g. heredocs) are clamped with a `+N more · click to expand` tail instead of dumping their whole body into the scrollback.\n- Tool error output is clipped the same way as ok output, so a failing command no longer floods the transcript.\n- The TUI toast overlay has an opaque background instead of letting the transcript bleed through.\n\n## [0.3.0] - 2026-08-04\n\n### Added\n\n**Chat TUI**\n\n- `/fork` slash command to fork a conversation at any point and continue in a new thread.\n- `/conversation` switches threads from inside a live session.\n- `/compact` triggers manual conversation compaction.\n- `/portal` and `/copy` slash commands.\n- Archive the current conversation from the chat TUI.\n- `--new` flag on `skydive chat` to start a fresh conversation.\n- Debounced server-side conversation search in the picker, with title matches ranked first.\n- File review pane orientation toggle, and review comments in the file pane.\n- Pinned plan card controls and a jump-to-latest hint.\n- Terminal title (OSC) follows the live conversation title on every screen; inside cmux the workspace is renamed too, and linked PRs are pushed to the cmux sidebar.\n- Every participating agent shows in the conversation list; connect cards each have their own identity, and ctrl+r asks which connect card to act on.\n- Colored Skydive splash art in `skydive --help` and the TUI pickers.\n- New-agent name prefilled from the server's suggestion.\n\n**CLI & platform**\n\n- `skydive update` self-updater, with an update notice when a new version is available.\n- Shell completions for bash, zsh, and fish via `completion install`.\n- Portal daemon: one connection per host with per-conversation working directories.\n- Agent-led coding-agent import (`skydive import`).\n- Per-workspace scoping on the REST client, and cross-org `--agent <uuid>` auto-switches workspace.\n- `skydive-beta` wrapper for the canary channel.\n\n### Fixed\n\n- `skydive update` no longer claims an update is available on every npm install.\n- Chat memory is bounded (payload clamps + windowed rows) with a memory watchdog and OOM diagnostic report; transcript rows are memoized so streaming stops re-rendering the whole chat.\n- Chat-send failures map to real error messages.\n- Notification and sidebar previews use the last text block of the reply and strip inline markdown.\n- Picker rows no longer overlap when a conversation title contains a newline, tab, or control character.\n- Sending to non-web channel conversations is blocked in the TUI.\n- GitHub bot connect opens on the web front door, not api.skydive.com.\n- TUI activity counter times from the run, not the screen.\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
@@ -4215,7 +4222,7 @@ if (process.argv.includes(UPDATE_WORKER_FLAG)) {
 	process.exit(0);
 }
 if (process.argv.includes(PORTAL_DAEMON_FLAG)) {
-	const { runPortalDaemon } = await import("./daemon-BX8OBLBs.mjs");
+	const { runPortalDaemon } = await import("./daemon-BGPE3evT.mjs");
 	runPortalDaemon(process.argv);
 } else runCli();
 function runCli() {

package/dist/js/{boot-C831RDoa.mjs → boot-DX50EPUe.mjs}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
-import { C as themesForMode, D as listWorkspaces, O as setActiveWorkspace, T as getActiveWorkspaceId, _ as theme, a as installCrashHandler, b as themeModeFromColorFgBg, c as MARK_CELLS, d as splashFitsWidth, f as DEFAULT_THEME_ID, g as noColorRequested, h as monoTheme, i as writeArtifact, l as WORDMARK, m as findTheme, n as profilingEnabled, o as buildCrashReport, p as applyTheme, r as record, s as writeCrashReport, v as themeForMode, x as themeVersion, y as themeMode } from "./profiler-DlxtXXGp.mjs";
-import { D as getReviewStateDir, H as saveTheme, N as recordDefaultAgent, O as getSavedTheme, S as getConfigPath, c as cardActionErrorMessage, d as reconcileMaskedInput, f as resolveConnectUrl, i as resolveAgent, l as parseExternalOauthConnectParams, m as specKeyFor, p as parseConnectCard, s as MASK_CHAR, u as parseOauthConnectParams, v as DEFAULT_API_URL, y as DEFAULT_APP_URL, z as resolveWebUrl } from "./print-CPRgbo2N.mjs";
+import { A as setActiveWorkspace, C as themesForMode, D as getActiveWorkspaceId, T as machineOsFromPlatform, _ as theme, a as installCrashHandler, b as themeModeFromColorFgBg, c as MARK_CELLS, d as splashFitsWidth, f as DEFAULT_THEME_ID, g as noColorRequested, h as monoTheme, i as writeArtifact, k as listWorkspaces, l as WORDMARK, m as findTheme, n as profilingEnabled, o as buildCrashReport, p as applyTheme, r as record, s as writeCrashReport, v as themeForMode, x as themeVersion, y as themeMode } from "./profiler-C44QO8Op.mjs";
+import { D as getReviewStateDir, H as saveTheme, N as recordDefaultAgent, O as getSavedTheme, S as getConfigPath, c as cardActionErrorMessage, d as reconcileMaskedInput, f as resolveConnectUrl, i as resolveAgent, l as parseExternalOauthConnectParams, m as specKeyFor, p as parseConnectCard, s as MASK_CHAR, u as parseOauthConnectParams, v as DEFAULT_API_URL, y as DEFAULT_APP_URL, z as resolveWebUrl } from "./print-OvYyj6Uk.mjs";
 import { t as HttpError } from "./http-error-DzyrsLAZ.mjs";
-import { a as isRecord, i as errorMessage, n as errorDetail, r as sendErrorMessage, t as createRestClient } from "./rest-CLrHVkxh.mjs";
+import { a as isRecord, i as errorMessage, n as errorDetail, r as sendErrorMessage, t as createRestClient } from "./rest-Dx6b-Nq_.mjs";
 import { i as billingBlockedOutcomeFromSendResponse } from "./billing-blocked-2wju4gC_.mjs";
 import { t as PortalClient } from "./client-DbqRBquD.mjs";
-import "./daemon-DWw9AjB4.mjs";
+import "./daemon-WOEEiYWf.mjs";
 import "./api-DG5W6iwx.mjs";
 import { t as SandboxStream } from "./client-c4c5MmgN.mjs";
-import { t as PortalDaemonClient } from "./daemon-client-C_lgQr4E.mjs";
+import { t as PortalDaemonClient } from "./daemon-client-CX4qctxA.mjs";
 import { t as runRawPtyPassthrough } from "./raw-pty-DY4KelZW.mjs";
 import * as os$1 from "node:os";
 import { homedir, platform, release, tmpdir } from "node:os";
@@ -137,6 +137,7 @@ const useStore = create((set, get) => ({
 	seedPrompt: null,
 	autoGrantMachine: false,
 	newConversationIntent: false,
+	forcedOnboarding: false,
 	earlyInput: "",
 	goTo: (screen) => set({
 		screen,
@@ -254,7 +255,7 @@ const useStore = create((set, get) => ({
 * org roster. A name/slug selector is the only case that can be ambiguous and
 * therefore still needs the full candidate list to disambiguate. */
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-async function resolveInitialScreen({ rest, agentSelector, conversationId, newConversation, defaultAgentSelector }) {
+async function resolveInitialScreen({ rest, agentSelector, conversationId, newConversation, defaultAgentSelector, forceOnboarding }) {
 	if (conversationId) {
 		const conversation = await rest.getConversation({ conversationId }).catch((err) => {
 			if (err instanceof HttpError && err.status === 404) throw new Error(`No conversation with id ${conversationId}. It may have been deleted, or belong to another workspace.`);
@@ -284,7 +285,14 @@ async function resolveInitialScreen({ rest, agentSelector, conversationId, newCo
 			}
 		};
 	}
-	if (!agentSelector && !newConversation && !defaultAgentSelector) return { kind: "agent-picker" };
+	if (forceOnboarding && !agentSelector) return { kind: "first-run" };
+	if (!agentSelector && !newConversation && !defaultAgentSelector) {
+		if ((await rest.listAgents({
+			scope: "org",
+			onPage: null
+		})).length === 0) return { kind: "first-run" };
+		return { kind: "agent-picker" };
+	}
 	if (!agentSelector && defaultAgentSelector) {
 		const agent = UUID_RE.test(defaultAgentSelector) ? await rest.getAgent({ agentId: defaultAgentSelector }).catch((err) => {
 			if (err instanceof HttpError && (err.status === 404 || err.status === 403)) return null;
@@ -1640,6 +1648,7 @@ function screenLabelParts(screen, chatTitle) {
 		case "error": return { title: "" };
 		case "agent-picker": return { title: "pick an agent" };
 		case "agent-create": return { title: "create an agent" };
+		case "first-run": return { title: "welcome" };
 		case "workspace-picker": return { title: "switch workspace" };
 		case "conversation-picker": return {
 			title: "pick a conversation",
@@ -2249,6 +2258,208 @@ function AgentCreateScreen() {
 	});
 }
 
+//#endregion
+//#region src/chat/tui/screens/first-run.tsx
+/** Rows the mark lockup needs before it's worth painting (matches the
+* new-chat splash): the 6-row mark, a spacer, and a couple of content rows.
+* Below this the mark is dropped and only the message renders. */
+const MARK_MIN_ROWS$1 = 12;
+/** Columns the full mark + wordmark lockup spans; below this the pinwheel
+* mark renders alone instead of wrapping the wordmark. */
+const FULL_MARK_MIN_COLS$1 = 70;
+function FirstRunScreen() {
+	const rest = useStore((s) => s.rest);
+	const goTo = useStore((s) => s.goTo);
+	const fail = useStore((s) => s.fail);
+	const authKind = useStore((s) => s.authKind);
+	const forced = useStore((s) => s.forcedOnboarding);
+	const [state, setState] = useState({ kind: "creating" });
+	const canShareMachine = authKind === "session";
+	useEffect(() => {
+		if (!rest) return;
+		let cancelled = false;
+		(async () => {
+			try {
+				const agent = await rest.createAgent({});
+				if (cancelled) return;
+				setState({
+					kind: "offer",
+					agent
+				});
+			} catch (err) {
+				if (cancelled) return;
+				if (err instanceof HttpError && err.status === 401) {
+					fail("Session expired. Run `skydive auth login --web`, then retry.");
+					return;
+				}
+				setState({
+					kind: "error",
+					message: createErrorMessage(err)
+				});
+			}
+		})();
+		return () => {
+			cancelled = true;
+		};
+	}, [rest, fail]);
+	const openNewChat = (agent) => {
+		goTo({
+			kind: "chat",
+			agent,
+			conversation: {
+				kind: "new",
+				agentId: agent.id,
+				nonce: crypto.randomUUID()
+			}
+		});
+	};
+	const openOnboardingChat = (agent, conversationId, title) => {
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		goTo({
+			kind: "chat",
+			agent,
+			conversation: {
+				id: conversationId,
+				title,
+				createdAt: now,
+				updatedAt: now,
+				preview: null,
+				channel: "web",
+				channelLabel: null,
+				agent: {
+					id: agent.id,
+					name: agent.name,
+					slug: agent.slug ?? null,
+					title: agent.title ?? null
+				}
+			}
+		});
+	};
+	const acceptImport = async (agent) => {
+		if (!rest) return;
+		setState({ kind: "starting" });
+		const { portalClient } = useStore.getState();
+		try {
+			const os = machineOsFromPlatform(process.platform);
+			const { conversationId } = await rest.createOnboardingConversation({
+				agentId: agent.id,
+				projectDir: process.cwd(),
+				os
+			});
+			if (portalClient) {
+				portalClient.enable();
+				portalClient.grantAgent(agent.id, conversationId).catch(() => {
+					useStore.getState().showToast({
+						message: `Couldn't share this machine automatically. ${agent.name} will ask in chat.`,
+						variant: "warning"
+					});
+				});
+			}
+			openOnboardingChat(agent, conversationId, `Onboarding ${agent.name}`);
+		} catch (err) {
+			if (err instanceof HttpError && err.status === 401) {
+				fail("Session expired. Run `skydive auth login --web`, then retry.");
+				return;
+			}
+			useStore.getState().showToast({
+				message: "Couldn't start onboarding automatically. Opening a chat instead.",
+				variant: "warning"
+			});
+			openNewChat(agent);
+		}
+	};
+	const declineImport = (agent) => {
+		setState({ kind: "starting" });
+		openNewChat(agent);
+	};
+	useKeyboard((key) => {
+		if (state.kind !== "offer") return;
+		if (!canShareMachine) {
+			declineImport(state.agent);
+			return;
+		}
+		if (key.name === "return" || key.name === "y") acceptImport(state.agent);
+		else if (key.name === "n" || key.name === "escape") declineImport(state.agent);
+	});
+	return /* @__PURE__ */ jsx(Centered, { children: renderBody({
+		state,
+		forced,
+		canShareMachine
+	}) });
+}
+/** The Skydive mark centered above the screen's content, matching the
+* new-chat splash lockup and degrading by available space. */
+function Centered({ children }) {
+	const { width, height } = useTerminalDimensions();
+	return /* @__PURE__ */ jsxs("box", {
+		style: {
+			flexGrow: 1,
+			flexDirection: "column",
+			justifyContent: "center",
+			alignItems: "center"
+		},
+		children: [height >= MARK_MIN_ROWS$1 ? /* @__PURE__ */ jsx("box", {
+			style: {
+				flexDirection: "column",
+				alignItems: "center",
+				marginBottom: 1
+			},
+			children: /* @__PURE__ */ jsx(SkydiveMark, { variant: width >= FULL_MARK_MIN_COLS$1 ? "full" : "mark" })
+		}) : null, /* @__PURE__ */ jsx("box", {
+			style: {
+				flexDirection: "column",
+				alignItems: "center",
+				gap: 1
+			},
+			children
+		})]
+	});
+}
+function renderBody({ state, forced, canShareMachine }) {
+	if (state.kind === "error") return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("text", {
+		fg: theme.error,
+		children: state.message
+	}), /* @__PURE__ */ jsx("text", {
+		fg: theme.muted,
+		children: "press ctrl+c to quit, then run `skydive` again to retry."
+	})] });
+	if (state.kind === "creating") return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("text", {
+		fg: theme.fg,
+		children: "Welcome to Skydive."
+	}), /* @__PURE__ */ jsx("text", {
+		fg: theme.muted,
+		children: forced ? "creating an agent…" : "setting up your first agent…"
+	})] });
+	if (state.kind === "starting") return /* @__PURE__ */ jsx("text", {
+		fg: theme.muted,
+		children: "opening your agent…"
+	});
+	const { agent } = state;
+	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("text", {
+		fg: theme.fg,
+		children: forced ? `${agent.name} is ready.` : `Your first agent, ${agent.name}, is ready.`
+	}), canShareMachine ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs("text", {
+		fg: theme.muted,
+		children: [
+			"Want ",
+			agent.name,
+			" to learn how you already work? It can look at the coding agents set up on this machine to get up to speed fast. It will connect to your computer to read your setup, show you a plan first, and never copy credentials."
+		]
+	}), /* @__PURE__ */ jsx("text", {
+		fg: theme.dim,
+		children: "↵/y yes, learn from my setup · n skip"
+	})] }) : /* @__PURE__ */ jsx("text", {
+		fg: theme.dim,
+		children: "press any key to open the chat"
+	})] });
+}
+function createErrorMessage(err) {
+	if (err instanceof HttpError && err.status === 403) return "You don't have permission to create an agent in this workspace.";
+	if (err instanceof HttpError && err.status === 429) return "Too many requests. Wait a moment, then run `skydive` again.";
+	if (err instanceof HttpError) return "Skydive could not create your agent. Try again in a moment.";
+	return "Could not reach Skydive. Check your connection and try again.";
+}
+
 //#endregion
 //#region src/chat/tui/screens/workspace-picker.tsx
 function WorkspacePicker({ appUrl, sessionToken, onSelect, onCancel }) {
@@ -11966,7 +12177,8 @@ function ChatScreen({ agent, conversation }) {
 				agentSelector: null,
 				conversationId: target,
 				newConversation: false,
-				defaultAgentSelector: null
+				defaultAgentSelector: null,
+				forceOnboarding: false
 			}));
 		} catch (err) {
 			setItems((prev) => [...prev, {
@@ -13125,7 +13337,7 @@ function ToastView() {
 
 //#endregion
 //#region src/chat/tui/app.tsx
-function App({ appUrl, sessionToken, authKind, shareMachine, promptHistoryPath, notifications, agentSelector, conversationId, newConversation, defaultAgentSelector }) {
+function App({ appUrl, sessionToken, authKind, shareMachine, promptHistoryPath, notifications, agentSelector, conversationId, newConversation, defaultAgentSelector, forceOnboarding }) {
 	const renderer = useRenderer();
 	const screen = useStore((s) => s.screen);
 	useEffect(() => {
@@ -13214,7 +13426,8 @@ function App({ appUrl, sessionToken, authKind, shareMachine, promptHistoryPath,
 					agentSelector,
 					conversationId,
 					newConversation: newConversation || useStore.getState().seedPrompt !== null,
-					defaultAgentSelector
+					defaultAgentSelector,
+					forceOnboarding
 				});
 				if (cancelled) return;
 				goTo(screen);
@@ -13238,6 +13451,7 @@ function App({ appUrl, sessionToken, authKind, shareMachine, promptHistoryPath,
 		conversationId,
 		newConversation,
 		defaultAgentSelector,
+		forceOnboarding,
 		goTo,
 		setClients,
 		fail
@@ -13278,6 +13492,7 @@ function App({ appUrl, sessionToken, authKind, shareMachine, promptHistoryPath,
 						screen.kind === "error" && /* @__PURE__ */ jsx(ErrorScreen, { message: screen.message }),
 						screen.kind === "agent-picker" && rest && /* @__PURE__ */ jsx(AgentPickerScreen, {}),
 						screen.kind === "agent-create" && rest && /* @__PURE__ */ jsx(AgentCreateScreen, {}),
+						screen.kind === "first-run" && rest && /* @__PURE__ */ jsx(FirstRunScreen, {}),
 						screen.kind === "workspace-picker" && /* @__PURE__ */ jsx(WorkspacePicker, {
 							appUrl,
 							sessionToken,
@@ -13816,7 +14031,7 @@ function onRenderCommit(id, phase, actualDuration, baseDuration, startTime, comm
 * module — and the heavy OpenTUI dependency graph it pulls in — is
 * dynamically imported and never loaded on the Node management path.
 */
-async function runChat({ appUrl, sessionToken, authKind = "session", shareMachine, promptHistoryPath, theme: themeOverride, notifications, agentSelector, conversationId, newConversation, defaultAgentSelector, seedPrompt }) {
+async function runChat({ appUrl, sessionToken, authKind = "session", shareMachine, promptHistoryPath, theme: themeOverride, notifications, agentSelector, conversationId, newConversation, defaultAgentSelector, forceOnboarding, seedPrompt }) {
 	await registerGrammars();
 	const watchdog = startMemoryWatchdog();
 	installCrashHandler({ memoryProvider: () => watchdog.snapshot() });
@@ -13831,7 +14046,8 @@ async function runChat({ appUrl, sessionToken, authKind = "session", shareMachin
 		authKind,
 		seedPrompt: seedPrompt ?? null,
 		autoGrantMachine: Boolean(seedPrompt && shareMachine),
-		newConversationIntent: newConversation
+		newConversationIntent: newConversation,
+		forcedOnboarding: forceOnboarding
 	});
 	const store = useStore.getState();
 	if (noColorRequested()) {
@@ -13858,7 +14074,8 @@ async function runChat({ appUrl, sessionToken, authKind = "session", shareMachin
 			agentSelector: agentSelector ?? null,
 			conversationId: conversationId ?? null,
 			newConversation,
-			defaultAgentSelector: defaultAgentSelector ?? null
+			defaultAgentSelector: defaultAgentSelector ?? null,
+			forceOnboarding
 		})
 	}));
 }

package/dist/js/{daemon-BX8OBLBs.mjs → daemon-BGPE3evT.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import "./client-DbqRBquD.mjs";
-import { a as runPortalDaemon, i as queryDaemonStatus, n as ensureDaemonRunning, o as startPortalDaemon, r as isDaemonListening, s as stopDaemon, t as PortalDaemon } from "./daemon-DWw9AjB4.mjs";
+import { a as runPortalDaemon, i as queryDaemonStatus, n as ensureDaemonRunning, o as startPortalDaemon, r as isDaemonListening, s as stopDaemon, t as PortalDaemon } from "./daemon-WOEEiYWf.mjs";
 import "./api-DG5W6iwx.mjs";
 
 export { runPortalDaemon };

package/dist/js/{daemon-DWw9AjB4.mjs → daemon-WOEEiYWf.mjs}

@@ -20,7 +20,7 @@ import { access, appendFile, mkdir, readFile, unlink, writeFile } from "node:fs/
 * the commit time of the built tree is one monotonic clock they share.
 */
 function portalDaemonBuild() {
-	return "1786649704";
+	return "1786651284";
 }
 /**
 * Whether a client carrying `mine` should replace a running daemon carrying

package/dist/js/daemon-client-BL3EohF6.mjs

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import "./client-DbqRBquD.mjs";
+import "./daemon-WOEEiYWf.mjs";
+import "./api-DG5W6iwx.mjs";
+import { t as PortalDaemonClient } from "./daemon-client-CX4qctxA.mjs";
+
+export { PortalDaemonClient };

package/dist/js/{daemon-client-C_lgQr4E.mjs → daemon-client-CX4qctxA.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { c as LOCAL_PROTOCOL_VERSION, d as encodeLine, f as makeLineParser, n as ensureDaemonRunning, p as parseDaemonMessage, u as daemonPaths } from "./daemon-DWw9AjB4.mjs";
+import { c as LOCAL_PROTOCOL_VERSION, d as encodeLine, f as makeLineParser, n as ensureDaemonRunning, p as parseDaemonMessage, u as daemonPaths } from "./daemon-WOEEiYWf.mjs";
 import { randomUUID } from "node:crypto";
 import { connect } from "node:net";
 

package/dist/js/{print-D8L3DAbD.mjs → print-C8DHKrJu.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { a as runPrint, i as resolveAgent, n as messageGet, o as toPrintError, r as readStdin, t as collectRunText } from "./print-CPRgbo2N.mjs";
-import "./rest-CLrHVkxh.mjs";
+import { a as runPrint, i as resolveAgent, n as messageGet, o as toPrintError, r as readStdin, t as collectRunText } from "./print-OvYyj6Uk.mjs";
+import "./rest-Dx6b-Nq_.mjs";
 import "./billing-blocked-2wju4gC_.mjs";
 
 export { messageGet, readStdin, resolveAgent, runPrint };

package/dist/js/{print-CPRgbo2N.mjs → print-OvYyj6Uk.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { t as HttpError } from "./http-error-DzyrsLAZ.mjs";
-import { a as isRecord, i as errorMessage, r as sendErrorMessage, t as createRestClient } from "./rest-CLrHVkxh.mjs";
+import { a as isRecord, i as errorMessage, r as sendErrorMessage, t as createRestClient } from "./rest-Dx6b-Nq_.mjs";
 import { i as billingBlockedOutcomeFromSendResponse, n as BillingBlockedError } from "./billing-blocked-2wju4gC_.mjs";
 import path from "node:path";
 import Conf from "conf";

package/dist/js/{profiler-DlxtXXGp.mjs → profiler-C44QO8Op.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { S as getConfigPath } from "./print-CPRgbo2N.mjs";
+import { S as getConfigPath } from "./print-OvYyj6Uk.mjs";
 import os from "node:os";
 import path from "node:path";
 import { err, ok } from "neverthrow";
@@ -8,7 +8,7 @@ import fs from "node:fs";
 
 //#region package.json
 var name = "skydive-cli";
-var version$1 = "0.5.0-beta.19";
+var version$1 = "0.5.0-beta.20";
 
 //#endregion
 //#region src/auth/organization.ts
@@ -125,6 +125,30 @@ async function ensureActiveOrganization({ appUrl, sessionToken }) {
 	});
 }
 
+//#endregion
+//#region src/chat/import-seed.ts
+/** Map `process.platform` to the OS family used by the seed prompts. Every
+* non-`win32` platform Node runs on (darwin, linux, the BSDs) is POSIX. */
+function machineOsFromPlatform(platform) {
+	return platform === "win32" ? "windows" : "posix";
+}
+/** One clause describing the machine's shell/paths so the agent's discovery
+* sweep uses the right conventions instead of guessing. */
+function osHint(os) {
+	return os === "windows" ? "This machine is Windows, so use PowerShell and Windows paths (%USERPROFILE%, backslashes)." : "This machine is POSIX (macOS/Linux), so use a POSIX shell and paths (~, forward slashes).";
+}
+/**
+* The first message of an explicit `skydive import` conversation, sent as the
+* user. Frames the migration and points the agent at its import-config skill.
+*/
+function buildImportSeedPrompt(projectDir, os) {
+	return [
+		"I'm migrating from another coding agent. Import my setup from this machine.",
+		"",
+		`Use your import-config skill. I ran this from \`${projectDir}\`, so start there and in my home directory. ${osHint(os)} Don't assume one tool — do the discovery sweep so you catch whatever I actually use (Claude Code, Cursor, Codex, Gemini CLI, Copilot, Windsurf, Cline, OpenCode, Aider, and any nested AGENTS.md). Show me the plan first: everything you found, what you'll bring over, where it lands in you, and anything you're leaving out (credentials especially). Then wait for my OK before committing anything.`
+	].join("\n");
+}
+
 //#endregion
 //#region src/chat/tui/theme.ts
 const tokyonight = {
@@ -1275,4 +1299,4 @@ function maybeStartProfiling(argv, cliVersion) {
 }
 
 //#endregion
-export { version$1 as A, themesForMode as C, listWorkspaces as D, getSessionIdentity as E, setActiveWorkspace as O, themes as S, getActiveWorkspaceId as T, theme as _, installCrashHandler as a, themeModeFromColorFgBg as b, MARK_CELLS as c, splashFitsWidth as d, DEFAULT_THEME_ID as f, noColorRequested as g, monoTheme as h, writeArtifact as i, name as k, WORDMARK as l, findTheme as m, profilingEnabled as n, buildCrashReport as o, applyTheme as p, record as r, writeCrashReport as s, maybeStartProfiling as t, brandHelpArt as u, themeForMode as v, ensureActiveOrganization as w, themeVersion as x, themeMode as y };
+export { setActiveWorkspace as A, themesForMode as C, getActiveWorkspaceId as D, ensureActiveOrganization as E, version$1 as M, getSessionIdentity as O, themes as S, machineOsFromPlatform as T, theme as _, installCrashHandler as a, themeModeFromColorFgBg as b, MARK_CELLS as c, splashFitsWidth as d, DEFAULT_THEME_ID as f, noColorRequested as g, monoTheme as h, writeArtifact as i, name as j, listWorkspaces as k, WORDMARK as l, findTheme as m, profilingEnabled as n, buildCrashReport as o, applyTheme as p, record as r, writeCrashReport as s, maybeStartProfiling as t, brandHelpArt as u, themeForMode as v, buildImportSeedPrompt as w, themeVersion as x, themeMode as y };

package/dist/js/{rest-DsdPAE8K.mjs → rest-DW05dMMc.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { t as HttpError } from "./http-error-DzyrsLAZ.mjs";
-import { n as errorDetail, r as sendErrorMessage, t as createRestClient } from "./rest-CLrHVkxh.mjs";
+import { n as errorDetail, r as sendErrorMessage, t as createRestClient } from "./rest-Dx6b-Nq_.mjs";
 import "./billing-blocked-2wju4gC_.mjs";
 
 export { createRestClient };

package/dist/js/{rest-CLrHVkxh.mjs → rest-Dx6b-Nq_.mjs}

@@ -214,9 +214,19 @@ function createRestClient({ appUrl, sessionToken, workspaceId }) {
 			return all;
 		},
 		createAgent: async ({ name }) => {
-			const { agent } = await post("/api/v1/agents", { name }, createAgentResponseSchema);
+			const { agent } = await post("/api/v1/agents", name == null ? {} : { name }, createAgentResponseSchema);
 			return agent;
 		},
+		createOnboardingConversation: async ({ agentId, projectDir, os }) => {
+			const result = await post(`/api/v1/agents/${encodeURIComponent(agentId)}/onboarding-conversation`, {
+				projectDir,
+				os
+			}, onboardingConversationResponseSchema);
+			return {
+				conversationId: result.conversationId,
+				runId: result.runId
+			};
+		},
 		getAgent: async ({ agentId }) => {
 			const { agent } = await get(`/api/v1/agents/${encodeURIComponent(agentId)}`, getAgentResponseSchema);
 			return agent;
@@ -454,6 +464,10 @@ const listAgentsResponseSchema = z.object({
 	totalCount: z.number().nullable().optional()
 });
 const createAgentResponseSchema = z.object({ agent: agentSummarySchema });
+const onboardingConversationResponseSchema = z.object({
+	conversationId: z.string(),
+	runId: z.string().nullable()
+});
 const getAgentResponseSchema = z.object({ agent: agentSummarySchema });
 const agentSuggestionSchema = z.object({ name: z.string() });
 const suggestAgentResponseSchema = z.object({ suggestion: agentSuggestionSchema.nullable() });

package/package.json

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

package/dist/js/daemon-client-CMsS0Ayk.mjs

@@ -1,7 +0,0 @@
-#!/usr/bin/env node
-import "./client-DbqRBquD.mjs";
-import "./daemon-DWw9AjB4.mjs";
-import "./api-DG5W6iwx.mjs";
-import { t as PortalDaemonClient } from "./daemon-client-C_lgQr4E.mjs";
-
-export { PortalDaemonClient };