symbiot 0.55.3 → 0.56.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 What each Symbiot release brought, newest first. When Approve bumps the version, it writes that release here from the tasks it approved, worded as release notes by your connected AI (or in the tasks' own words without one). The app shows the releases newer than yours under "What's new" when it offers an update, and once more after you update.
 
+## 0.56.0
+
+- **Symbiot in your app menu, no terminal.** On Linux, `npm install -g symbiot` puts Symbiot in your app menu with its own icon, the orb. Click it and Symbiot starts in the background and opens its window; click it again and the window comes up. You never need a terminal to run it. Its window shows the orb in your taskbar too, and the menu entry keeps itself pointing at the installed Symbiot (a new Node, a moved install).
+- **`symbiot uninstall`** removes Symbiot and everything it added: the menu entry and icon, start at login, the Away shortcut, and its data (`--keep-data` keeps your settings, tasks and memory). Claude Code and its sign-in stay.
+- `symbiot open` does what the icon does, from a terminal.
+
 ## 0.55.3
 
 - **Your Claude subscription, no API key.** With Claude Code signed in to your Claude account (Pro or Max), Symbiot now answers through it: chats, write-ups, posts, screenshots. Nothing to connect, no separate bill. It comes first when you haven't picked an AI, ahead of an old saved key. `symbiot login` and Settings → Your AI offer it first; if Claude Code isn't signed in yet, they tell you to run `claude` once and sign in. Before, a fresh install sent you to `symbiot login`, which only asked for an API key.

package/README.md

@@ -43,6 +43,14 @@ npm install -g symbiot        # or run without installing:  npx symbiot week
 With Claude Code signed in to your Claude account, that's all: Symbiot uses your
 subscription, no API key. See [Connect it (once)](#connect-it-once) for the other options.
 
+On Linux, installing puts **Symbiot in your app menu**, with its icon. Open it from
+there: it starts in the background (no terminal) and opens its window, or brings the
+window up if it's already running. You don't need a terminal again; `symbiot open`
+does the same from one.
+
+To remove it and everything it added (menu entry, icon, start at login, shortcut,
+its data): `symbiot uninstall` (`--keep-data` keeps your settings, tasks and memory).
+
 ## Prefer a window? `symbiot app`
 
 ```bash

package/away.mjs

@@ -14,7 +14,7 @@
 // Any key or click, or Super+` again, closes every window. Not a lock: Super+Esc
 // locks the computer.
 import { spawn, spawnSync } from "node:child_process";
-import { mkdirSync, readFileSync, writeFileSync, existsSync } from "node:fs";
+import { mkdirSync, readFileSync, writeFileSync, existsSync, unlinkSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
 import { CONFIG_DIR, chromeBinary } from "./core.mjs";
@@ -110,4 +110,14 @@ function installShortcut({ cmd, home = homedir(), desktop = process.env.XDG_CURR
   return { ok: true, file: f, replaced: /key:\s*"grave"/.test(had) };
 }
 
-export { placeable, grantProfile, parseMonitors, screens, awayQueries, openAway, closeAway, awayOpen, toggleAway, withShortcut, installShortcut, COSMIC_CUSTOM };
+// Uninstalling: our Super+` line comes out of COSMIC's custom shortcuts; the file
+// goes if nothing else was in it. True when there was one.
+function removeShortcut(home = homedir()) {
+  const f = COSMIC_CUSTOM(home); let had = ""; try { had = readFileSync(f, "utf8"); } catch { return false; }
+  const lines = had.split("\n"), kept = lines.filter((l) => !/Spawn\("[^"]*symbiot[^"]* away"\)/.test(l));
+  if (kept.length === lines.length) return false;
+  const rest = kept.join("\n");
+  try { if (!rest.replace(/[{}\s]/g, "")) unlinkSync(f); else writeFileSync(f, rest); } catch {}
+  return true;
+}
+export { removeShortcut, placeable, grantProfile, parseMonitors, screens, awayQueries, openAway, closeAway, awayOpen, toggleAway, withShortcut, installShortcut, COSMIC_CUSTOM };

package/desktop.mjs

@@ -4,6 +4,7 @@
 // start-at-login launches that server in the background (no window) when you
 // log in, so the write-up still happens on days you never open Symbiot.
 // `symbiot app` then finds that running copy and opens its window.
+import { fileURLToPath } from "node:url";
 import { spawn } from "node:child_process";
 import { homedir } from "node:os";
 import { join, dirname } from "node:path";
@@ -144,6 +145,52 @@ function autostartContent(node, script, platform = OS, path = process.env.PATH |
   return ["[Desktop Entry]", "Type=Application", "Name=Symbiot", "Comment=Symbiot in the background: the weekly write-up and its notification",
     `Exec=env SYMBIOT_NO_OPEN=1 ${q("PATH=" + path)} ${q(node)} ${q(script)} app`, "Terminal=false", "NoDisplay=true", "X-GNOME-Autostart-enabled=true", ""].join("\n");
 }
+// ---- the app launcher ---------------------------------------------------------
+// Symbiot in your app menu, with its icon: click it and Symbiot starts in the
+// background (no terminal) and opens its window, or brings the window up if it's
+// running (`symbiot open`). Linux (XDG): an entry in ~/.local/share/applications and
+// the icon in your icon theme. `npm install -g` writes it (postinstall.mjs), and each
+// start of an installed Symbiot writes it again if it's missing or out of date (a
+// new Node, a moved install), so it never points at something gone.
+const launcherFile = (home = homedir()) => join(home, ".local", "share", "applications", "symbiot.desktop");
+const launcherIcon = (home = homedir()) => join(home, ".local", "share", "icons", "hicolor", "scalable", "apps", "symbiot.svg");
+const ICON_SRC = fileURLToPath(new URL("./icon.svg", import.meta.url));
+function launcherContent(node, script, path = process.env.PATH || "") {
+  const q = (s) => '"' + String(s).replace(/(["`$\\])/g, "\\$1") + '"';
+  return ["[Desktop Entry]", "Type=Application", "Name=Symbiot", "GenericName=Assistant",
+    "Comment=Your work, your agents and what needs you, in one place",
+    `Exec=env ${q("PATH=" + path)} ${q(node)} ${q(script)} open`, "Icon=symbiot", "Terminal=false",
+    "Categories=Office;Utility;Development;", "Keywords=assistant;agents;tasks;week;standup;", "StartupNotify=true",
+    // the app's window is Chrome's --app window on Symbiot's address: this groups it under this icon
+    "StartupWMClass=chrome-127.0.0.1__-Default", ""].join("\n");
+}
+// The PATH the launcher starts it with: yours, without the throwaway folders npm adds
+// while it installs (…/node_modules/.bin), each once, and Node's own folder in it.
+function launcherPath(path, node) {
+  const seen = new Set(), out = [];
+  for (const d of [...String(path || "").split(":"), dirname(node)]) if (d && !/node_modules[\\/]\.bin|node-gyp-bin/.test(d) && !seen.has(d)) { seen.add(d); out.push(d); }
+  return out.join(":");
+}
+// Writes the entry and icon when they're missing or differ. { written, file } or { skipped }.
+function installLauncher({ node = process.execPath, script, home = homedir(), platform = OS, path = process.env.PATH || "" } = {}) {
+  if (platform !== "linux" || !script) return { skipped: true };
+  const file = launcherFile(home), icon = launcherIcon(home), want = launcherContent(node, script, launcherPath(path, node));
+  let wrote = false;
+  try {
+    let had = ""; try { had = readFileSync(file, "utf8"); } catch {}
+    if (had !== want) { mkdirSync(join(file, ".."), { recursive: true }); writeFileSync(file, want, { mode: 0o644 }); wrote = true; }
+    let hadIcon = ""; try { hadIcon = readFileSync(icon, "utf8"); } catch {}
+    const svg = readFileSync(ICON_SRC, "utf8");
+    if (hadIcon !== svg) { mkdirSync(join(icon, ".."), { recursive: true }); writeFileSync(icon, svg, { mode: 0o644 }); wrote = true; }
+  } catch (e) { return { error: (e && e.message) || String(e) }; }
+  if (wrote) { try { spawn("update-desktop-database", [join(file, "..")], { stdio: "ignore", detached: true }).on("error", () => {}).unref(); } catch {} }
+  return { written: wrote, file };
+}
+function removeLauncher(home = homedir()) {
+  const gone = [];
+  for (const f of [launcherFile(home), launcherIcon(home)]) { try { if (existsSync(f)) { unlinkSync(f); gone.push(f); } } catch {} }
+  return gone;
+}
 function autostartState() { const file = autostartFile(); return { on: existsSync(file), file, ...(OS === "android-app" ? { phone: "app" } : OS === "android" ? { phone: "termux" } : {}) }; }
 // `script` is index.mjs's real path. From npx that's a cache folder that goes
 // away, so it has to be installed for this to keep working.
@@ -159,4 +206,4 @@ function setAutostart(on, script) {
   } catch (e) { return { ...autostartState(), error: String((e && e.message) || e) }; }
 }
 
-export { weeklyCfg, lastSlot, weeklyDue, setWeekly, weeklyState, latestWeek, runWeekly, startWeekly, notifyCmd, desktopNotify, autostartFile, autostartContent, autostartState, setAutostart };
+export { launcherPath, launcherFile, launcherIcon, launcherContent, installLauncher, removeLauncher, weeklyCfg, lastSlot, weeklyDue, setWeekly, weeklyState, latestWeek, runWeekly, startWeekly, notifyCmd, desktopNotify, autostartFile, autostartContent, autostartState, setAutostart };

package/icon.svg

@@ -0,0 +1,33 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" width="256" height="256">
+  <title>Symbiot</title>
+  <defs>
+    <radialGradient id="bg" cx="50%" cy="42%" r="70%">
+      <stop offset="0" stop-color="#1B1D22"/>
+      <stop offset="1" stop-color="#08090B"/>
+    </radialGradient>
+    <radialGradient id="orb" cx="40%" cy="34%" r="66%">
+      <stop offset="0" stop-color="#3A3D44"/>
+      <stop offset="0.45" stop-color="#121317"/>
+      <stop offset="1" stop-color="#030304"/>
+    </radialGradient>
+    <radialGradient id="rim" cx="50%" cy="50%" r="50%">
+      <stop offset="0.86" stop-color="#000" stop-opacity="0"/>
+      <stop offset="0.97" stop-color="#B0466E" stop-opacity="0.55"/>
+      <stop offset="1" stop-color="#F2A541" stop-opacity="0"/>
+    </radialGradient>
+    <radialGradient id="glow" cx="50%" cy="56%" r="50%">
+      <stop offset="0.55" stop-color="#F2A541" stop-opacity="0.16"/>
+      <stop offset="1" stop-color="#F2A541" stop-opacity="0"/>
+    </radialGradient>
+    <linearGradient id="shine" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#FFFFFF" stop-opacity="0.85"/>
+      <stop offset="1" stop-color="#FFFFFF" stop-opacity="0"/>
+    </linearGradient>
+  </defs>
+  <rect width="256" height="256" rx="58" fill="url(#bg)"/>
+  <circle cx="128" cy="136" r="96" fill="url(#glow)"/>
+  <circle cx="128" cy="128" r="78" fill="url(#orb)"/>
+  <circle cx="128" cy="128" r="78" fill="url(#rim)"/>
+  <ellipse cx="102" cy="92" rx="30" ry="17" transform="rotate(-28 102 92)" fill="url(#shine)"/>
+  <ellipse cx="160" cy="176" rx="22" ry="5" transform="rotate(-30 160 176)" fill="#FFFFFF" opacity="0.12"/>
+</svg>

package/index.mjs

@@ -23,14 +23,14 @@
 // tasks.mjs (tasks, review and Approve), agents.mjs (handing work to an agent),
 // drift.mjs, server.mjs (`symbiot app`'s server) and ui.mjs (its page).
 
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { homedir } from "node:os";
 import { join, basename } from "node:path";
-import { realpathSync, readFileSync } from "node:fs";
+import { realpathSync, readFileSync, mkdirSync, openSync, rmSync, existsSync } from "node:fs";
 import { createInterface } from "node:readline";
 import { fileURLToPath } from "node:url";
 import { EMBEDDED_UI } from "./ui.mjs";
-import { VERSION, CONFIG_PATH, loadConfig, saveConfig, repoState, semverGt } from "./core.mjs";
+import { VERSION, CONFIG_PATH, CONFIG_DIR, loadConfig, saveConfig, repoState, semverGt } from "./core.mjs";
 import { HANDOFF_PROMPT, CLAUDE_CMD, ORCA_CLAUDE_CMD, handoffCmd, setHandoffCmd, fillHandoff, runHandoff, orcaHandoffCmd, migrateOrcaCmd, migrateClaudeCmd, parseQuestions, agentQuestions } from "./agents.mjs";
 import { AI_UI, PROVIDERS, resolveProvider, validate, detectHardware, recommendModels, hasOllama, ollamaInstall, ensureOllama, useOllamaModel, claudeState, connectProvider } from "./ai.mjs";
 import { setScanOptions, scanBase, authorship, readmeInfo, repoShape, houseRules, reportFooter, findAllRepos, buildMap } from "./scan.mjs";
@@ -42,7 +42,7 @@ import { mapPage, wholePage, pressRegion, typeRegion, scrollPage, signIn, isTrus
 import { watchState, addWatch, removeWatch, seenWatch, newsSince, markNews, checkWatch, setBrief, draftReply, watchBoard, boardLine, boardChat, boardTalk, clearBoardChat } from "./watch.mjs";
 import { PORT as PHONE_PORT, phoneState, pairComputer, pollComputer, forgetComputer } from "./phone.mjs";
 import { KIND_LABEL as POST_KIND, PATHS as POST_PATHS, draftPosts, postsState, postLog, approvePost, editPost, skipPost, voiceFromLinkedIn, openUrl, addMedia as addPostMedia, removeMedia as removePostMedia, mediaDir as postMediaDir, pictureOfPage, clipOfPage } from "./post.mjs";
-import { startApp, updateCmd, isAppRunningWeekly } from "./server.mjs";
+import { startApp, updateCmd, isAppRunningWeekly, askRunningApp, openApp } from "./server.mjs";
 import { listReports, readReport } from "./reports.mjs";
 import { runSandbox } from "./sandbox.mjs";
 import { knowledgeState, addKnowledgeFolder, removeKnowledgeFolder, indexKnowledge, searchKnowledge, waitingOn, ownerOf, myName, setMyName, itemLine, caseLine } from "./knowledge.mjs";
@@ -350,6 +350,43 @@ async function cmdAway() {
   if (!r) { console.log(c.y("Symbiot's app isn't running.") + c.d("  Start it with  symbiot app,  then Away works.")); process.exitCode = 1; return; }
   if (r.error) { console.log(c.y(r.error)); process.exitCode = 1; }
 }
+// symbiot open: what the app-menu icon runs. Running: its window comes up. Not
+// running: it starts in the background (no terminal; what it prints goes to
+// ~/.config/symbiot/app.log) and opens its own window.
+async function cmdOpen() {
+  const cfg = loadConfig(), port = Number(process.env.SYMBIOT_PORT || cfg.appPort) || 7391;
+  const p = cfg.appToken ? await askRunningApp("ping", { port, token: cfg.appToken, ms: 1500 }) : null;
+  if (p && p.version) { openApp(`http://127.0.0.1:${port}/?t=${cfg.appToken}`); return; }
+  let fd = "ignore"; try { mkdirSync(CONFIG_DIR, { recursive: true }); fd = openSync(join(CONFIG_DIR, "app.log"), "a"); } catch {}
+  const env = { ...process.env }; delete env.SYMBIOT_NO_OPEN;
+  spawn(process.execPath, [realpathSync(fileURLToPath(import.meta.url)), "app"], { detached: true, stdio: ["ignore", fd, fd], env }).unref();
+}
+// symbiot uninstall: everything Symbiot put on this computer, then the program.
+// --keep-data keeps ~/.config/symbiot (settings, tasks, memory); --yes doesn't ask.
+async function cmdUninstall() {
+  const keep = has("keep-data");
+  console.log(c.b("Remove Symbiot from this computer") + "\n");
+  console.log("  · its app-menu entry and icon, start at login, the Super+` shortcut");
+  console.log(keep ? "  · " + c.d("keeps your data in " + CONFIG_DIR) : "  · everything it knows: settings, tasks, memory, drafts, screenshots (" + CONFIG_DIR + ")");
+  if (!has("keep-program")) console.log("  · the program itself (npm uninstall -g symbiot)");
+  console.log(c.d("  Claude Code and its sign-in stay. Folders it made inside your projects (.symbiot/) stay too."));
+  if (!has("yes")) {
+    if (!process.stdin.isTTY) { console.log("\n" + c.y("Run it again with --yes to go ahead.")); process.exitCode = 1; return; }
+    if (((await ask("\nType yes to remove it: ")) || "").trim().toLowerCase() !== "yes") { console.log("Nothing removed."); return; }
+  }
+  const { removeLauncher, setAutostart } = await import("./desktop.mjs");
+  const { removeShortcut } = await import("./away.mjs");
+  await askRunningApp("quit", { ms: 2000 });
+  try { setAutostart(false); } catch {}
+  removeLauncher(); removeShortcut();
+  try { rmSync(join(homedir(), ".symbiot"), { recursive: true, force: true }); } catch {}
+  if (!keep) { try { rmSync(CONFIG_DIR, { recursive: true, force: true }); } catch {} }
+  console.log(c.g("✓ ") + "Removed what Symbiot added" + (keep ? ", your data kept." : ", and its data."));
+  if (has("keep-program")) return;
+  const r = spawnSync("npm", ["uninstall", "-g", "symbiot"], { stdio: "inherit", shell: process.platform === "win32" });
+  console.log(r.status === 0 ? c.g("✓ ") + "Symbiot is uninstalled." : c.y("Couldn't remove the program: run  npm uninstall -g symbiot"));
+  if (existsSync(CONFIG_DIR) && !keep) console.log(c.d("(Something wrote to " + CONFIG_DIR + " meanwhile; delete it if you like.)"));
+}
 async function cmdScreens() {
   const [sub = "list", a1, a2, a3] = argv.slice(1).filter((x, i, all) => !x.startsWith("--") && all[i - 1] !== "--name");
   const out = (x) => { console.log(JSON.stringify(x, null, 2)); if (x && x.error) process.exitCode = 1; };
@@ -775,6 +812,9 @@ ${c.b("Usage")}
   symbiot standup                   yesterday + today, for standup
   symbiot todo                      what's still on your plate
   symbiot app                       open the visual app in your browser
+  symbiot open                      start Symbiot in the background and open its window
+                                    (what its app-menu icon does)
+  symbiot uninstall [--keep-data]   remove Symbiot and everything it added
   symbiot away [--shortcut]         Symbiot full screen on every screen while you're away;
                                     again closes it. --shortcut: Super+\` does it
   symbiot app --fresh [--keep]      try it as someone new: a brand-new Symbiot in
@@ -833,6 +873,8 @@ async function main() {
   if (cmd === "whoami" || cmd === "status") return cmdWhoami();
   if (cmd === "app" || cmd === "ui") return cmdApp();
   if (cmd === "away") return cmdAway();
+  if (cmd === "open") return cmdOpen();
+  if (cmd === "uninstall") return cmdUninstall();
   if (cmd === "models" || cmd === "hardware") return cmdModels();
   if (cmd === "setup-local" || cmd === "setup-ollama") return cmdSetupLocal();
   if (cmd === "drift") return cmdDrift();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "symbiot",
-  "version": "0.55.3",
+  "version": "0.56.0",
   "description": "Your week, written from your real work. Reads your local git and writes it up with the AI of your choice \u2014 Claude, OpenAI, Gemini, or a local model.",
   "type": "module",
   "bin": {
@@ -44,7 +44,9 @@
     "mapknn.mjs",
     "guard.mjs",
     "away.mjs",
-    "marketing.mjs"
+    "marketing.mjs",
+    "postinstall.mjs",
+    "icon.svg"
   ],
   "engines": {
     "node": ">=18"
@@ -77,8 +79,9 @@
     "@anthropic-ai/sdk": "^0.128.0"
   },
   "scripts": {
-    "test": "node test/load.mjs && node test/fixtures.mjs && node test/links.mjs && node test/post.mjs && node test/peek.mjs && node test/mind.mjs && node test/knowledge.mjs && node test/checks.mjs &&node test/lanes.mjs && node test/handback.mjs && node test/autoallow.mjs && node test/guard.mjs && node test/reports.mjs && node test/sandbox.mjs && node test/adapt.mjs && node test/work.mjs && node test/mapknn.mjs && node test/away.mjs && node test/subscription.mjs && node test/marketing.mjs && node test/paths.mjs && node test/smoke.mjs && node test/app.mjs && node test/install.mjs",
-    "lint": "eslint ."
+    "test": "node test/load.mjs && node test/fixtures.mjs && node test/links.mjs && node test/post.mjs && node test/peek.mjs && node test/mind.mjs && node test/knowledge.mjs && node test/checks.mjs &&node test/lanes.mjs && node test/handback.mjs && node test/autoallow.mjs && node test/guard.mjs && node test/reports.mjs && node test/sandbox.mjs && node test/adapt.mjs && node test/work.mjs && node test/mapknn.mjs && node test/away.mjs && node test/subscription.mjs && node test/launcher.mjs && node test/marketing.mjs && node test/paths.mjs && node test/smoke.mjs && node test/app.mjs && node test/install.mjs",
+    "lint": "eslint .",
+    "postinstall": "node postinstall.mjs"
   },
   "devDependencies": {
     "eslint": "^9.39.5",

package/postinstall.mjs

@@ -0,0 +1,12 @@
+// npm install -g symbiot runs this: Symbiot in your app menu, with its icon, so you
+// never need a terminal to start it (desktop.mjs installLauncher). Only for a global
+// install, and it never fails the install.
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+try {
+  if (process.env.npm_config_global === "true" && !process.env.SYMBIOT_NO_LAUNCHER) {
+    const { installLauncher } = await import("./desktop.mjs");
+    const r = installLauncher({ script: realpathSync(fileURLToPath(new URL("./index.mjs", import.meta.url))) });
+    if (r.file) console.log("Symbiot is in your app menu: open it from there, no terminal needed.");
+  }
+} catch {}

package/server.mjs

@@ -22,7 +22,7 @@ import { addTask, toggleTask, removeTask, restoreTask, syncTasks, taskType, push
 import { repoReview, repoSuggest, folderSuggest, taskChat, clearTaskChat, mailState, setMail, sentMail, produce, releaseNotes } from "./writeups.mjs";
 import { loadScreens, screenImage, captureScreen, splitScreen, listMonitors, allowScreenshots, importScreen, setRegions, renameScreen, removeScreen, blueprint, clickRegion } from "./screens.mjs";
 import { mapPage, wholePage, pressRegion, typeRegion, scrollPage, signIn, keepBrowserOpen, isTrusted, trustedSites, trustSite, untrustSite } from "./headless.mjs";
-import { weeklyState, setWeekly, runWeekly, startWeekly, autostartState, setAutostart } from "./desktop.mjs";
+import { weeklyState, setWeekly, runWeekly, startWeekly, autostartState, setAutostart, installLauncher } from "./desktop.mjs";
 import { markNews, newsSince, watchState, addWatch, setEvery, removeWatch, clearNews, seenWatch, checkWatch, startWatches, setBrief, draftReply, openChat, watchBoard, boardChat, clearBoardChat } from "./watch.mjs";
 import { linksState, linkSite, checkLink, unlinkSite } from "./links.mjs";
 import { testWeeks, testInstalls, postsState, draftPosts, approvePost, editPost, skipPost, voiceFromLinkedIn, addMedia, removeMedia, mediaFile, mediaDir, pictureOfPage, clipOfPage, openUrl } from "./post.mjs";
@@ -204,7 +204,7 @@ async function startApp({ bin, since = 7, all = false, c = PLAIN_COLOURS } = {})
     if (p && p.version) {
       const url = `http://127.0.0.1:${PORT}/?t=${TOKEN}`; const how = process.env.SYMBIOT_NO_OPEN === "1" ? "" : openApp(url);
       console.log(`\n${c.g("●")} ${c.b("Symbiot")} is already running (v${p.version}) at ${c.b(url)}`);
-      console.log(how ? c.d(`  Opened the existing window (a ${how}).`) : c.d("  Open that URL in your browser."));
+      console.log(how ? c.d(`  Opened the existing window (${/^[aeiou]/.test(how) ? "an" : "a"} ${how}).`) : c.d("  Open that URL in your browser."));
       console.log(c.d("  (Not starting a second copy. Set SYMBIOT_FORCE_NEW=1 to force one.)"));
       return;
     }
@@ -214,6 +214,9 @@ async function startApp({ bin, since = 7, all = false, c = PLAIN_COLOURS } = {})
   keepBrowserOpen(BROWSER_KEEP);
   const json = (res, obj) => { res.writeHead(200, { "content-type": "application/json" }); res.end(JSON.stringify(obj)); };
   const screenOut =(s) => (s && s.id ? { ...s, blueprint: blueprint(s), ...(s.page ? { trusted: isTrusted(s.page.url) } : {}) } : s && s.screens ? { ...s, screens: s.screens.map(screenOut) } : s);
+  // an installed Symbiot keeps its app-menu entry pointing at itself (a new Node, a moved
+  // install); not a copy run from a checkout or a test
+  if (/[\\/]node_modules[\\/]symbiot[\\/]/.test(bin || "") && !SANDBOX) { try { installLauncher({ script: bin }); } catch {} }
   let UPDATING = null; // an update in flight: { target, attempt, retrying? }
   let NEWEST_WIN = ""; // the Symbiot window opened last: older ones close themselves (one window, not a pile)
   process.on("exit", () => closeAway()); // Away's windows go with the app (a quit, an update's restart)
@@ -221,6 +224,12 @@ async function startApp({ bin, since = 7, all = false, c = PLAIN_COLOURS } = {})
     const u = new URL(req.url, "http://127.0.0.1");
     if (req.method === "GET" && u.pathname === "/") { res.writeHead(200, { "content-type": "text/html; charset=utf-8" }); res.end(EMBEDDED_UI); return; }
     // the app's typeface ships in the package (fonts/), so it's there offline
+    // the window's own icon (its taskbar entry), the same orb as the app menu's
+    if (req.method === "GET" && (u.pathname === "/favicon.svg" || u.pathname === "/favicon.ico")) {
+      try { const b = readFileSync(fileURLToPath(new URL("./icon.svg", import.meta.url))); res.writeHead(200, { "content-type": "image/svg+xml", "cache-control": "public, max-age=86400" }); res.end(b); }
+      catch { res.writeHead(404); res.end(); }
+      return;
+    }
     if (req.method === "GET" && u.pathname === "/fonts/Geist-Variable.woff2") {
       try { const b = readFileSync(fileURLToPath(new URL("./fonts/Geist-Variable.woff2", import.meta.url))); res.writeHead(200, { "content-type": "font/woff2", "cache-control": "public, max-age=31536000, immutable" }); res.end(b); }
       catch { res.writeHead(404); res.end(); }
@@ -477,7 +486,7 @@ async function startApp({ bin, since = 7, all = false, c = PLAIN_COLOURS } = {})
     const url = `http://127.0.0.1:${server.address().port}/?t=${TOKEN}`;
     const how = opened || RELAUNCH || process.env.SYMBIOT_NO_OPEN === "1" ? "" : openApp(url); opened = true; // only pop a window the first time (never in tests, never after an update)
     console.log(`\n${c.g("●")} ${c.b("Symbiot")} is running at ${c.b(url)}`);
-    console.log(RELAUNCH ? c.d("  Restarted after an update; the open window reloads itself.") : how ? c.d(`  Opened in a ${how}.`) : c.d("  Open that URL in your browser."));
+    console.log(RELAUNCH ? c.d("  Restarted after an update; the open window reloads itself.") : how ? c.d(`  Opened in ${/^[aeiou]/.test(how) ? "an" : "a"} ${how}.`) : c.d("  Open that URL in your browser."));
     console.log(c.d("  Leave this running; press Ctrl+C to stop (or click the X in the window's top corner)."));
   });
   server.on("error", (e) => {
@@ -508,4 +517,4 @@ async function startApp({ bin, since = 7, all = false, c = PLAIN_COLOURS } = {})
   setInterval(() => { try { awaitTick(); } catch {} }, 60000).unref(); // a reply an agent's email waits on: found, and handed on
 }
 
-export { updateCmd, changesSince, whatsNew, tarFile, registryChangelog, BROWSER_KEEP, startApp, askRunningApp, isAppRunningWeekly };
+export { updateCmd, changesSince, whatsNew, tarFile, registryChangelog, BROWSER_KEEP, startApp, askRunningApp, isAppRunningWeekly, openApp };

package/ui.mjs

@@ -5,7 +5,8 @@
 // Kept apart from the CLI/server so UI edits can't break the backend (and vice
 // versa); test/smoke.mjs boots the real page and exercises every handler.
 export const EMBEDDED_UI = `<!doctype html><html><head><meta charset="utf8">
-<meta name="viewport" content="width=device-width,initial-scale=1"><meta name="theme-color" id="themecolor" content="#08090B"><meta name="color-scheme" content="dark light"><title>Symbiot</title>
+<meta name="viewport" content="width=device-width,initial-scale=1"><meta name="theme-color" id="themecolor" content="#08090B">
+<link rel="icon" type="image/svg+xml" href="/favicon.svg"><meta name="color-scheme" content="dark light"><title>Symbiot</title>
 <style>
 @font-face{font-family:'Geist';src:url('/fonts/Geist-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
 :root{--ink:#0E1A1F;--ink2:#15262C;--ink3:#1D333A;--line:#24404A;--bone:#F4F1EA;--text:#B7C9C4;--faint:#7E9690;--green:#3DDC97;--amber:#F2A541;--green-dim:#16322D;--sans:'Geist',-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif}