openpond 0.0.30-bootstrap.0 → 0.0.31

package/README.md

@@ -4,13 +4,27 @@ OpenPond CLI
 
 The generated [command reference](./docs/command-reference.md) is the authoritative command and option inventory.
 
-Install:
+Launch the complete local web app without installing it globally:
 
 ```bash
-npm i -g openpond
-# or
-npx --package openpond openpond tool list handle/repo
-# or (curl installer)
+npx openpond@latest
+```
+
+The command starts a local OpenPond server, passes its authenticated URL directly to your system browser, and stays attached until you press `Ctrl+C`. Application state persists under `~/.openpond/openpond-app`; the directory where you invoke the command is not modified. npm maintains its own package cache separately.
+
+Node.js 24.18 or newer in the Node 24 release line is required. Other installation and launch forms remain available:
+
+```bash
+npm install --global openpond
+openpond
+
+# Print the authenticated local URL instead of opening a browser.
+openpond ui --no-open
+
+# Launch the terminal UI explicitly.
+openpond tui
+
+# GitHub release installer for a compiled CLI.
 curl -fsSL https://openpond.ai/install.sh | bash
 ```
 

package/dist/chunks/{app-layer-YKXEQGOW.js → app-layer-53U5JVE7.js}

@@ -1,11 +1,11 @@
 import { createRequire as __openpondCreateRequire } from "node:module"; var require = __openpondCreateRequire(import.meta.url);
 import {
   runProcessCommand
-} from "./chunk-XSAXENQD.js";
+} from "./chunk-NC2GQQOT.js";
 import {
   CliUsageError
-} from "./chunk-5G4E547X.js";
-import "./chunk-3Y4EL3P6.js";
+} from "./chunk-4GLUNJLZ.js";
+import "./chunk-7HZBKUUB.js";
 import "./chunk-UACZUFIA.js";
 
 // src/cli/app-layer.ts
@@ -17,6 +17,21 @@ import { fileURLToPath } from "node:url";
 // src/cli/build-mode.ts
 var IS_COMPILED_CLI = false;
 
+// src/cli/node-runtime.ts
+var OPENPOND_NODE_MAJOR = 24;
+var OPENPOND_NODE_MIN_MINOR = 18;
+var OPENPOND_NODE_MIN_VERSION = `${OPENPOND_NODE_MAJOR}.${OPENPOND_NODE_MIN_MINOR}.0`;
+function openPondTuiNodeRuntimeMessage(version = process.versions.node) {
+  const match = /^(\d+)\.(\d+)\.(\d+)/.exec(version);
+  const major = match ? Number(match[1]) : Number.NaN;
+  const minor = match ? Number(match[2]) : Number.NaN;
+  if (major === OPENPOND_NODE_MAJOR && minor >= OPENPOND_NODE_MIN_MINOR) return null;
+  return [
+    `OpenPond TUI requires Node.js ${OPENPOND_NODE_MIN_VERSION} or newer in the Node ${OPENPOND_NODE_MAJOR} release line; detected Node.js ${version}.`,
+    `Switch Node versions and retry (with nvm: \`nvm install ${OPENPOND_NODE_MIN_VERSION} && nvm use ${OPENPOND_NODE_MIN_VERSION}\`).`
+  ].join("\n");
+}
+
 // src/cli/app-layer.ts
 var __dirname = path.dirname(fileURLToPath(import.meta.url));
 var OpenPondChildProcessExitError = class extends Error {
@@ -30,12 +45,17 @@ var OpenPondChildProcessExitError = class extends Error {
 async function runOpenPondServerCommand(mode, options, rest) {
   const server = resolveAppEntrypoint("server");
   const args = [...server.args, mode, ...forwardedOptions(options), ...rest];
+  if (mode === "web") {
+    args.push(options.noOpen === true || options.noOpen === "true" ? "--print-access-url" : "--open-browser");
+  }
   const webRoot = mode === "web" && typeof options.webRoot !== "string" ? packagedWebRoot() : null;
   if (webRoot) args.push("--web-root", webRoot);
   await runChild(server.runner, args, server.cwd);
 }
 async function runOpenPondTerminalCommand(options, rest) {
   validateTerminalForwardingOptions(options);
+  const runtimeMessage = openPondTuiNodeRuntimeMessage();
+  if (runtimeMessage) throw new CliUsageError(runtimeMessage);
   const terminal = resolveAppEntrypoint("terminal");
   const server = resolveAppEntrypoint("server");
   const args = [...terminal.args, "chat", ...forwardedOptions(normalizeTerminalPaths(options)), ...rest];
@@ -107,7 +127,7 @@ function isCompiledExecutable() {
   return Boolean(argvEntry && path.resolve(argvEntry) === path.resolve(process.execPath));
 }
 function forwardedOptions(options) {
-  const ignored = /* @__PURE__ */ new Set(["account", "handle", "baseUrl", "tui"]);
+  const ignored = /* @__PURE__ */ new Set(["account", "handle", "baseUrl", "noOpen", "tui"]);
   const args = [];
   for (const [key, value] of Object.entries(options)) {
     if (ignored.has(key)) continue;

package/dist/chunks/{apps-GGSIN2ZF.js → apps-MJ47WJNC.js}

@@ -23,17 +23,17 @@ import {
   submitPositionsTx,
   updateAppCodeVisibility,
   updateAppEnvironment
-} from "./chunk-XSAXENQD.js";
+} from "./chunk-NC2GQQOT.js";
 import {
   resolveBaseUrl,
   resolvePublicApiBaseUrl
-} from "./chunk-5G4E547X.js";
+} from "./chunk-4GLUNJLZ.js";
 import {
   parseBooleanOption,
   parseJsonOption,
   parseTimeOption,
   resolveTemplateEnvironment
-} from "./chunk-3Y4EL3P6.js";
+} from "./chunk-7HZBKUUB.js";
 import "./chunk-UACZUFIA.js";
 
 // src/cli/apps.ts

package/dist/chunks/{chunk-5G4E547X.js → chunk-4GLUNJLZ.js}

@@ -5,7 +5,7 @@ import {
   getCliCommandDefinition,
   getCliOptionKind,
   parseJsonOption
-} from "./chunk-3Y4EL3P6.js";
+} from "./chunk-7HZBKUUB.js";
 
 // ../../packages/cloud/src/urls.ts
 var DEFAULT_OPENPOND_WEB_BASE_URL = "https://openpond.ai";

package/dist/chunks/{chunk-AUJLPKGI.js → chunk-5X47XJC4.js}

@@ -4,14 +4,14 @@ import {
   parseSandboxRuntimeProfileIdOption,
   parseSandboxRuntimePromotionPolicyOption,
   parseSandboxWorkflowModeOption
-} from "./chunk-XSAXENQD.js";
+} from "./chunk-NC2GQQOT.js";
 import {
   parseBooleanOption,
   parseCsvOption,
   parseIntegerOption,
   parseJsonOption,
   parseNumberOption
-} from "./chunk-3Y4EL3P6.js";
+} from "./chunk-7HZBKUUB.js";
 
 // src/cli/sandbox-helpers.ts
 import { Buffer } from "node:buffer";

package/dist/chunks/{chunk-3Y4EL3P6.js → chunk-7HZBKUUB.js}

@@ -468,7 +468,7 @@ var CLI_COMMAND_REGISTRY = [
     name: "help",
     usage: "openpond help",
     optionSchema: {},
-    handler: async () => (await import("./help-LMH5FGT2.js")).printHelp()
+    handler: async () => (await import("./help-TIEOIVOA.js")).printHelp()
   },
   {
     name: "version",
@@ -480,19 +480,19 @@ var CLI_COMMAND_REGISTRY = [
     name: "check-update",
     usage: "openpond check-update",
     optionSchema: {},
-    handler: async () => (await import("./core-commands-IM2UKLU4.js")).runCheckUpdate()
+    handler: async () => (await import("./core-commands-KI53GSJF.js")).runCheckUpdate()
   },
   {
     name: "login",
     usage: "openpond login [--base-url <url>]",
     optionSchema: CLI_GLOBAL_OPTION_SCHEMA,
-    handler: async ({ options }) => (await import("./core-commands-IM2UKLU4.js")).runLogin(options)
+    handler: async ({ options }) => (await import("./core-commands-KI53GSJF.js")).runLogin(options)
   },
   {
     name: "init",
     usage: "openpond init [--path <dir>]",
     optionSchema: { path: "string" },
-    handler: async ({ options }) => (await import("./profile-NLDZDT3L.js")).runOpenPondInitCommand(options)
+    handler: async ({ options }) => (await import("./profile-A75O7EZ4.js")).runOpenPondInitCommand(options)
   },
   {
     name: "profile",
@@ -521,44 +521,44 @@ var CLI_COMMAND_REGISTRY = [
       teamId: "string",
       workItemId: "string"
     },
-    handler: async ({ options, rest }) => (await import("./profile-NLDZDT3L.js")).runOpenPondProfileCommand(options, rest)
+    handler: async ({ options, rest }) => (await import("./profile-A75O7EZ4.js")).runOpenPondProfileCommand(options, rest)
   },
   {
     name: "agents",
     usage: "openpond agents [--json]",
     optionSchema: { json: "boolean" },
-    handler: async ({ options, rest }) => (await import("./profile-NLDZDT3L.js")).runOpenPondAgentsCommand(options, rest)
+    handler: async ({ options, rest }) => (await import("./profile-A75O7EZ4.js")).runOpenPondAgentsCommand(options, rest)
   },
   ...profileSdkAliasDefinitions(),
   {
     name: "extend",
     usage: "openpond extend <instructions>",
     optionSchema: { cwd: "string" },
-    handler: async ({ options, rest }) => (await import("./extend-YXCBULPO.js")).runOpenPondExtendCommand(options, rest)
+    handler: async ({ options, rest }) => (await import("./extend-F4R3AI2G.js")).runOpenPondExtendCommand(options, rest)
   },
   {
     name: "edit",
     usage: "openpond edit <instructions>",
     optionSchema: { cwd: "string" },
-    handler: async ({ options, rest }) => (await import("./extend-YXCBULPO.js")).runOpenPondEditCommand(options, rest)
+    handler: async ({ options, rest }) => (await import("./extend-F4R3AI2G.js")).runOpenPondEditCommand(options, rest)
   },
   {
     name: "profiles",
     usage: "openpond profiles [args]",
     optionSchema: { json: "boolean" },
-    handler: async ({ options, rest }) => (await import("./core-commands-IM2UKLU4.js")).runProfiles(options, rest)
+    handler: async ({ options, rest }) => (await import("./core-commands-KI53GSJF.js")).runProfiles(options, rest)
   },
   {
     name: "account",
     usage: "openpond account",
     optionSchema: { json: "boolean" },
-    handler: async () => (await import("./core-commands-IM2UKLU4.js")).runAccount()
+    handler: async () => (await import("./core-commands-KI53GSJF.js")).runAccount()
   },
   {
     name: "health",
     usage: "openpond health",
     optionSchema: { json: "boolean" },
-    handler: async ({ options }) => (await import("./core-commands-IM2UKLU4.js")).runHealth(options)
+    handler: async ({ options }) => (await import("./core-commands-KI53GSJF.js")).runHealth(options)
   },
   {
     name: "serve",
@@ -569,19 +569,20 @@ var CLI_COMMAND_REGISTRY = [
       listen: "string",
       port: "integer"
     },
-    handler: async ({ options, rest }) => (await import("./app-layer-YKXEQGOW.js")).runOpenPondServerCommand("serve", options, rest)
+    handler: async ({ options, rest }) => (await import("./app-layer-53U5JVE7.js")).runOpenPondServerCommand("serve", options, rest)
   },
   {
     name: "ui",
-    usage: "openpond ui [args]",
+    usage: "openpond ui [--no-open] [--hostname HOST] [--port PORT]",
     optionSchema: {
       host: "string",
       hostname: "string",
       listen: "string",
+      noOpen: "boolean",
       port: "integer",
       webRoot: "string"
     },
-    handler: async ({ options, rest }) => (await import("./app-layer-YKXEQGOW.js")).runOpenPondServerCommand("web", options, rest)
+    handler: async ({ options, rest }) => (await import("./app-layer-53U5JVE7.js")).runOpenPondServerCommand("web", options, rest)
   },
   {
     name: "tui",
@@ -595,13 +596,13 @@ var CLI_COMMAND_REGISTRY = [
       provider: "string",
       server: "string"
     },
-    handler: async ({ options, rest }) => (await import("./app-layer-YKXEQGOW.js")).runOpenPondTerminalCommand(options, rest)
+    handler: async ({ options, rest }) => (await import("./app-layer-53U5JVE7.js")).runOpenPondTerminalCommand(options, rest)
   },
   {
     name: "chat",
     usage: "openpond chat (--message-file <path>|--message <text>|--stdin) --non-interactive [--provider <id>] [--model <id>] [--project <id>] [--yes] [--approval-policy <policy>] [--json] [--timeout-sec <n>] [--max-output-bytes <n>] [--sandbox <mode>]",
     optionSchema: CHAT_OPTION_SCHEMA,
-    handler: async ({ options, rest }) => (await import("./app-layer-YKXEQGOW.js")).runOpenPondTerminalCommand(options, rest)
+    handler: async ({ options, rest }) => (await import("./app-layer-53U5JVE7.js")).runOpenPondTerminalCommand(options, rest)
   },
   {
     name: "tool",
@@ -637,7 +638,7 @@ var CLI_COMMAND_REGISTRY = [
     name: "sandbox-template",
     usage: "openpond sandbox-template <command> [args]",
     optionSchema: SANDBOX_TEMPLATE_OPTION_SCHEMA,
-    handler: async ({ options, rest }) => (await import("./sandbox-template-LZN4F55Z.js")).runSandboxTemplateCommand(options, rest)
+    handler: async ({ options, rest }) => (await import("./sandbox-template-KWCE3OJV.js")).runSandboxTemplateCommand(options, rest)
   },
   {
     name: "repo",
@@ -659,13 +660,13 @@ var CLI_COMMAND_REGISTRY = [
       open: "boolean",
       timeoutSeconds: "integer"
     },
-    handler: async ({ options, rest }) => (await import("./organizations-4ISQRGMQ.js")).runOrganizationsCommand(options, rest)
+    handler: async ({ options, rest }) => (await import("./organizations-LAACUOYE.js")).runOrganizationsCommand(options, rest)
   },
   {
     name: "project",
     usage: "openpond project <list|create|upsert|get|update|sync|source-upload|archive> [args]",
     optionSchema: PROJECT_OPTION_SCHEMA,
-    handler: async ({ options, rest }) => (await import("./project-agent-ZPVO25HA.js")).runProjectCommand(options, rest)
+    handler: async ({ options, rest }) => (await import("./project-agent-JOZ6NRTW.js")).runProjectCommand(options, rest)
   },
   {
     name: "agent",
@@ -678,7 +679,7 @@ var CLI_COMMAND_REGISTRY = [
       "openpond agent edit checkpoint-result|commit-result|pr-result <workItemId> --team-id <id> --ref <artifact-ref>"
     ],
     optionSchema: AGENT_OPTION_SCHEMA,
-    handler: async ({ options, rest }) => (await import("./project-agent-ZPVO25HA.js")).runAgentCommand(options, rest)
+    handler: async ({ options, rest }) => (await import("./project-agent-JOZ6NRTW.js")).runAgentCommand(options, rest)
   },
   {
     name: "goal",
@@ -690,7 +691,7 @@ var CLI_COMMAND_REGISTRY = [
       json: "boolean",
       goalId: "string"
     },
-    handler: async ({ options, rest }) => (await import("./cli-X3HPLSOV.js")).runGoalCommand(options, rest)
+    handler: async ({ options, rest }) => (await import("./cli-H7PQLPKG.js")).runGoalCommand(options, rest)
   },
   {
     name: "harness",
@@ -711,13 +712,13 @@ var CLI_COMMAND_REGISTRY = [
       token: "string",
       tokenFile: "string"
     },
-    handler: async ({ options, rest }) => (await import("./harness-GMK6IY2U.js")).runHarnessCommand(options, rest)
+    handler: async ({ options, rest }) => (await import("./harness-WADDUNGU.js")).runHarnessCommand(options, rest)
   },
   {
     name: "sandbox",
     usage: "openpond sandbox <command> [args]",
     optionSchema: SANDBOX_OPTION_SCHEMA,
-    handler: async ({ options, rest }) => (await import("./sandbox-command-5GFJ2U3V.js")).runSandboxCommand(options, rest)
+    handler: async ({ options, rest }) => (await import("./sandbox-command-Q72CAVQ7.js")).runSandboxCommand(options, rest)
   },
   {
     name: "opchat",
@@ -726,7 +727,7 @@ var CLI_COMMAND_REGISTRY = [
       json: "boolean",
       stream: "boolean"
     },
-    handler: async ({ options, rest }) => (await import("./opchat-BWXZ32GX.js")).runOpChatCommand(options, rest)
+    handler: async ({ options, rest }) => (await import("./opchat-VYKKXDBO.js")).runOpChatCommand(options, rest)
   },
   {
     name: "teams-bot",
@@ -735,7 +736,7 @@ var CLI_COMMAND_REGISTRY = [
       json: "boolean",
       teamId: "string"
     },
-    handler: async ({ options, rest }) => (await import("./teams-bot-WP3FHKGA.js")).runTeamsBotCommand(options, rest)
+    handler: async ({ options, rest }) => (await import("./teams-bot-KNY5OEXB.js")).runTeamsBotCommand(options, rest)
   },
   {
     name: "apps",
@@ -756,7 +757,7 @@ var CLI_COMMAND_REGISTRY = [
     name: "opentool",
     usage: "openpond opentool <init|validate|build> [args]",
     optionSchema: {},
-    handler: async ({ rest }) => (await import("./core-commands-IM2UKLU4.js")).runOpentool(rest)
+    handler: async ({ rest }) => (await import("./core-commands-KI53GSJF.js")).runOpentool(rest)
   }
 ];
 var CLI_COMMAND_BY_NAME = /* @__PURE__ */ new Map();
@@ -773,7 +774,7 @@ function getCliCommandDefinition(command) {
   return CLI_COMMAND_BY_NAME.get(command) ?? null;
 }
 function getCliOptionKind(command, key) {
-  const definition = command ? getCliCommandDefinition(command) : null;
+  const definition = command ? getCliCommandDefinition(command) : getCliCommandDefinition("ui");
   return definition?.optionSchema[key] ?? CLI_GLOBAL_OPTION_SCHEMA[key];
 }
 function getAnyCliOptionKind(key) {
@@ -828,11 +829,11 @@ function profileSdkAliasDefinitions() {
     name,
     usage: `openpond ${name} [args]`,
     optionSchema: PROFILE_SDK_OPTION_SCHEMA,
-    handler: async ({ options, rest }) => (await import("./profile-NLDZDT3L.js")).runOpenPondProfileSdkAlias(name, options, rest)
+    handler: async ({ options, rest }) => (await import("./profile-A75O7EZ4.js")).runOpenPondProfileSdkAlias(name, options, rest)
   }));
 }
 async function runToolCommand({ options, rest }) {
-  const { runToolList, runToolRun } = await import("./core-commands-IM2UKLU4.js");
+  const { runToolList, runToolRun } = await import("./core-commands-KI53GSJF.js");
   const subcommand = rest[0];
   if (subcommand === "list") {
     const target = rest[1];
@@ -856,8 +857,8 @@ async function runToolCommand({ options, rest }) {
   throw new Error("usage: tool <list|run> <handle>/<repo> [args]");
 }
 async function runBacktestCommand({ options, rest }) {
-  const { runBacktestRun } = await import("./core-commands-IM2UKLU4.js");
-  const { runBacktestEvents, runBacktestGet } = await import("./apps-GGSIN2ZF.js");
+  const { runBacktestRun } = await import("./core-commands-KI53GSJF.js");
+  const { runBacktestEvents, runBacktestGet } = await import("./apps-MJ47WJNC.js");
   const subcommand = rest[0] || "run";
   if (subcommand === "run") {
     const target = rest[1];
@@ -891,7 +892,7 @@ async function runBacktestCommand({ options, rest }) {
   throw new Error("usage: backtest <run|events|get> <handle>/<repo> [args]");
 }
 async function runDeployCommand({ options, rest }) {
-  const { runDeployWatch } = await import("./core-commands-IM2UKLU4.js");
+  const { runDeployWatch } = await import("./core-commands-KI53GSJF.js");
   const subcommand = rest[0] || "watch";
   if (subcommand !== "watch") {
     throw new Error(
@@ -907,7 +908,7 @@ async function runDeployCommand({ options, rest }) {
   await runDeployWatch(options, target);
 }
 async function runTemplateCommand({ options, rest }) {
-  const { runTemplateBranches, runTemplateStatus, runTemplateUpdate } = await import("./core-commands-IM2UKLU4.js");
+  const { runTemplateBranches, runTemplateStatus, runTemplateUpdate } = await import("./core-commands-KI53GSJF.js");
   const subcommand = rest[0] || "status";
   const target = rest[1];
   if (!target) {
@@ -932,7 +933,7 @@ async function runTemplateCommand({ options, rest }) {
   );
 }
 async function runRepoCommand({ options, rest }) {
-  const { runRepoCreate, runRepoPush } = await import("./core-commands-IM2UKLU4.js");
+  const { runRepoCreate, runRepoPush } = await import("./core-commands-KI53GSJF.js");
   const subcommand = rest[0] || "create";
   if (subcommand === "create") {
     await runRepoCreate(options, rest.slice(1));
@@ -962,7 +963,7 @@ async function runAppsCommand({ options, rest }) {
     runAppsTools,
     runAppsToolsExecute,
     runAppsTradeFacts
-  } = await import("./apps-GGSIN2ZF.js");
+  } = await import("./apps-MJ47WJNC.js");
   const subcommand = rest[0];
   if (subcommand === "list") {
     await runAppsList(options);

package/dist/chunks/{chunk-Y6G6WRTG.js → chunk-7KYOO25A.js}

@@ -1,7 +1,8 @@
 import { createRequire as __openpondCreateRequire } from "node:module"; var require = __openpondCreateRequire(import.meta.url);
 import {
-  getBundledRuntimeVersion
-} from "./chunk-Q57SVPEH.js";
+  getBundledRuntimeVersion,
+  openUrlWithSystemBrowser
+} from "./chunk-IUTUUNAX.js";
 
 // ../server/src/cli.ts
 import { existsSync } from "node:fs";
@@ -11,7 +12,7 @@ import { fileURLToPath as fileURLToPath2 } from "node:url";
 // ../server/src/constants.ts
 var DEFAULT_HOST = "127.0.0.1";
 var DEFAULT_PORT = 17874;
-var VERSION = "0.0.30-bootstrap.0";
+var VERSION = "0.0.31";
 var HOSTED_CHAT_SYSTEM_PROMPT = "You are OpenPond Chat. Respond in the user's language. If the user's latest message is language-neutral, ambiguous, or only a short test, respond in English. Be concise and directly answer the latest request. Do not use emojis. Use Markdown when it improves scanability. If you emit reasoning or thinking content, keep it sparse and user-readable: at most one short sentence for major progress, decisions, or blockers. Omit reasoning for routine searches, reads, tool calls, and obvious next steps. Do not restate the user request, narrate every action, or include code blocks, code excerpts, diffs, raw tool payloads, or markdown examples in reasoning. Put necessary code or exact snippets only in the final assistant answer. When the user asks to show or preview an image that is available as a workspace path or signed image URL, use Markdown image syntax like ![description](path-or-url) instead of a bare path or raw HTML. For workspace-backed answers, use a Codex-style shape: brief outcome first, then Changed Files if files changed, then Verification if checks ran. End with a concise final answer that summarizes the result and verification when relevant. Do not mention raw tool JSON, internal repo paths, or origin/remote URLs unless the user explicitly asks for them or they are necessary to explain a git/deploy failure.";
 var APP_PREFERENCES_CACHE_TYPE = "app_preferences";
 var APP_PREFERENCES_CACHE_KEY = "global";
@@ -79,18 +80,23 @@ function parseCliArgs(args) {
   let host = DEFAULT_HOST;
   let port = DEFAULT_PORT;
   let webRoot = null;
+  let openBrowser = false;
+  let printAccessUrl = false;
   let index = 0;
   const command = args[0];
   if (command && !command.startsWith("-")) {
     if (command === "serve" || command === "server") mode = "serve";
     else if (command === "web") mode = "web";
-    else if (command === "help") return { mode, host, port, webRoot, help: true };
-    else throw new Error(`Unknown command: ${command}`);
+    else if (command === "help") {
+      return { mode, host, port, webRoot, openBrowser, printAccessUrl, help: true };
+    } else throw new Error(`Unknown command: ${command}`);
     index = 1;
   }
   for (let i = index; i < args.length; i += 1) {
     const arg = args[i];
-    if (arg === "--help" || arg === "-h") return { mode, host, port, webRoot, help: true };
+    if (arg === "--help" || arg === "-h") {
+      return { mode, host, port, webRoot, openBrowser, printAccessUrl, help: true };
+    }
     if (arg === "--listen") {
       const listen = parseListen(requireValue(args, i, arg));
       host = listen.host;
@@ -105,11 +111,21 @@ function parseCliArgs(args) {
     } else if (arg === "--web-root") {
       webRoot = path2.resolve(requireValue(args, i, arg));
       i += 1;
+    } else if (arg === "--open-browser") {
+      openBrowser = true;
+    } else if (arg === "--print-access-url") {
+      printAccessUrl = true;
     } else {
       throw new Error(`Unknown option: ${arg}`);
     }
   }
-  return { mode, host, port, webRoot, help: false };
+  if (openBrowser && printAccessUrl) {
+    throw new Error("--open-browser and --print-access-url cannot be used together.");
+  }
+  if (mode !== "web" && (openBrowser || printAccessUrl)) {
+    throw new Error("Browser options are only available in web mode.");
+  }
+  return { mode, host, port, webRoot, openBrowser, printAccessUrl, help: false };
 }
 function defaultWebRootCandidates() {
   return [
@@ -143,6 +159,23 @@ function tokenizedWebUrl(baseUrl, token) {
   url.hash = params.toString();
   return url.toString();
 }
+async function resolveWebLaunchMessages(input, handOffToBrowser = openUrlWithSystemBrowser) {
+  const accessUrl = tokenizedWebUrl(input.baseUrl, input.token);
+  if (input.printAccessUrl) {
+    return { stdout: [`OpenPond access URL: ${accessUrl}`], stderr: [] };
+  }
+  if (!input.openBrowser) {
+    return { stdout: [`OpenPond web UI: ${input.baseUrl}`], stderr: [] };
+  }
+  const handoff = await handOffToBrowser(accessUrl);
+  if (handoff.opened) {
+    return { stdout: [`Opened OpenPond in your browser: ${input.baseUrl}`], stderr: [] };
+  }
+  return {
+    stdout: [`OpenPond access URL: ${accessUrl}`],
+    stderr: [`Could not open the system browser: ${handoff.error}`]
+  };
+}
 function printHelp() {
   console.log(`Usage:
   openpond-app-server serve [--hostname HOST] [--port PORT]
@@ -153,6 +186,8 @@ Options:
   --hostname HOST        Bind host (default ${DEFAULT_HOST})
   --port PORT            Bind port, or 0 for any free port (default ${DEFAULT_PORT})
   --web-root DIR         Directory containing the built web UI for web mode
+  --open-browser         Open the authenticated web URL in the system browser
+  --print-access-url     Print the authenticated URL instead of opening it
 `);
 }
 async function runOpenPondServerCli(createOpenPondServer) {
@@ -166,25 +201,34 @@ async function runOpenPondServerCli(createOpenPondServer) {
     throw new Error("Could not find a built OpenPond web UI. Run `pnpm build:web` or pass --web-root.");
   }
   const instance = await createOpenPondServer({ host: args.host, port: args.port, webRoot });
-  const webUrl = args.mode === "web" ? tokenizedWebUrl(browserBaseUrl(instance), instance.token) : null;
+  const webBaseUrl = args.mode === "web" ? browserBaseUrl(instance) : null;
   console.log(
     `OPENPOND_APP_SERVER_READY ${JSON.stringify({
       mode: args.mode,
       url: instance.url,
-      webUrl,
+      webUrl: null,
       webRoot,
       tokenFile: instance.tokenFile,
       storePath: instance.storePath,
       runtime: getBundledRuntimeVersion()
     })}`
   );
-  if (webUrl) {
-    console.log(`OpenPond web UI: ${webUrl}`);
-    console.log(`Tailscale Serve URL token: #openpondToken=${encodeURIComponent(instance.token)}`);
+  if (webBaseUrl) {
+    const messages = await resolveWebLaunchMessages({
+      baseUrl: webBaseUrl,
+      openBrowser: args.openBrowser,
+      printAccessUrl: args.printAccessUrl,
+      token: instance.token
+    });
+    for (const message of messages.stderr) console.error(message);
+    for (const message of messages.stdout) console.log(message);
   } else {
     console.log(`OpenPond API server: ${instance.url}`);
   }
+  let shuttingDown = false;
   const shutdown = async () => {
+    if (shuttingDown) return;
+    shuttingDown = true;
     await instance.close();
     process.exit(0);
   };
@@ -206,5 +250,6 @@ export {
   extractDelta,
   event,
   isCliEntrypoint,
+  resolveWebLaunchMessages,
   runOpenPondServerCli
 };