symbiot 0.55.2 → 0.56.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 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.
+- **Home remembers the conversation you're having.** Home's chat didn't pass its own last turns to the AI, only what was said elsewhere in the app, so a "yeah" to its own "want that?" was read as an answer to something else and the task you'd agreed to was never made. Home now keeps its own thread: the last 16 turns, each in full, from the last 12 hours. A short answer (yes, yeah, ok, do it, 2) always answers what it just said there.
+- **Ideas get hashed out first.** Bring Symbiot an idea and it sharpens it with you (what's strong, where it's weak, what's missing) before proposing a task, and files it once you agree.
+- **An ambiguous ask gets readings, not a guess.** When a request could mean two things (which project, how big, what done looks like), Symbiot gives two or three numbered readings, its pick first, and asks which. Clear asks still go straight through.
+
 ## 0.55.2 — 2026-10-07
 
 - Fixed a feature description being read as something waiting on you: an agent's "lit amber when something needs you: work waiting for your OK" showed as a Marketing lane step only you could do. A "when / if / once / until" before the words now means it describes behaviour.

package/README.md

@@ -40,6 +40,17 @@ agent and brings its work back to you to approve.
 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
@@ -911,18 +922,26 @@ Every brief also tells the agent what else it can leave in `.symbiot/`:
 
 ## Connect it (once)
 
-Pick the AI you want it to write with:
+**Have a Claude subscription (Pro or Max)? There's nothing to connect.** If
+[Claude Code](https://claude.com/claude-code) is installed and signed in with your
+Claude account (run `claude` once and sign in), Symbiot answers through it: no API
+key, no separate bill. It runs Claude Code headless with Symbiot's own instructions,
+no tools (Read only, for a screenshot you attach), none of your settings, plugins or
+servers, and no session kept.
+
+Otherwise, pick the AI you want it to write with:
 
 ```bash
-symbiot login     # choose Claude, OpenAI, Gemini, or a local model (Ollama)
+symbiot login     # your Claude subscription, Claude (API key), OpenAI, Gemini, or a local model (Ollama)
 ```
 
-You'll get a short menu; paste that provider's API key (or, for Ollama, just point
+You'll get a short menu; for a hosted model paste its API key (for Ollama, just point
 it at your local server) and it's saved to `~/.config/symbiot/config.json`. The
 app's Settings tab does the same.
 
 | Provider | Get a key | Default model |
 |----------|-----------|---------------|
+| Your Claude subscription (Claude Code) | no key: sign in to Claude Code | your plan's default |
 | Claude (Anthropic) | <https://console.anthropic.com/settings/keys> | `claude-opus-5-5` |
 | OpenAI (GPT) | <https://platform.openai.com/api-keys> | `gpt-4o-mini` |
 | Gemini (Google) | <https://aistudio.google.com/apikey> | `gemini-1.5-flash` |

package/ai.mjs

@@ -1,23 +1,52 @@
 // The AI Symbiot writes with: the providers, which one is set up, one call per
 // provider (same in, same out), and the local-model (Ollama) setup.
 import Anthropic from "@anthropic-ai/sdk";
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { homedir, totalmem, cpus as oscpus } from "node:os";
 import { join } from "node:path";
-import { existsSync } from "node:fs";
-import { loadConfig, saveConfig, sh } from "./core.mjs";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { loadConfig, saveConfig, sh, hasCmd, CONFIG_DIR } from "./core.mjs";
 
 const MAX_TOKENS = 1600;
 
 // The providers Symbiot can write with. Models are sensible defaults; override
 // per provider at login, or globally with SYMBIOT_MODEL.
 const PROVIDERS = {
+  // your Claude subscription (Pro or Max), through Claude Code signed in on this computer: no key
+  claude:    { label: "Your Claude subscription (Claude Code)", sub: true, keyUrl: "https://claude.com/claude-code", keyName: null, model: "" },
   anthropic: { label: "Claude (Anthropic)", env: ["ANTHROPIC_API_KEY", "ANTHROPIC_AUTH_TOKEN"], keyUrl: "https://console.anthropic.com/settings/keys", keyName: "Anthropic API key (sk-ant-…)", model: "claude-opus-5-5" },
   openai:    { label: "OpenAI (GPT)",       env: ["OPENAI_API_KEY"],                            keyUrl: "https://platform.openai.com/api-keys",       keyName: "OpenAI API key (sk-…)",     model: "gpt-4o-mini" },
   gemini:    { label: "Gemini (Google)",    env: ["GEMINI_API_KEY", "GOOGLE_API_KEY"],          keyUrl: "https://aistudio.google.com/apikey",         keyName: "Google AI API key",         model: "gemini-1.5-flash" },
   ollama:    { label: "Local model (Ollama)", local: true,                                       keyUrl: "https://ollama.com",                         keyName: null,                        model: "llama3.1" },
 };
 
+// ---- your Claude subscription -------------------------------------------------
+// Claude Code signed in with a Claude account (Pro or Max) answers with that account,
+// no API key: Symbiot runs it headless (claude -p), the way it already runs your
+// agents. Whether it's there and signed in: `claude auth status` (a quarter of a
+// second), kept 5 minutes. SYMBIOT_CLAUDE_CMD replaces the command (the tests' stand-in).
+const CLAUDE_BIN = () => process.env.SYMBIOT_CLAUDE_CMD || "claude";
+let CLAUDE_SEEN = null;
+function claudeState(fresh = false) {
+  if (!fresh && CLAUDE_SEEN && Date.now() - CLAUDE_SEEN.at < 300000) return CLAUDE_SEEN;
+  let installed = !!process.env.SYMBIOT_CLAUDE_CMD || hasCmd("claude"), signedIn = false;
+  if (installed) {
+    try {
+      const r = spawnSync(CLAUDE_BIN(), ["auth", "status"], { encoding: "utf8", timeout: 8000, env: process.env });
+      if (r.error && r.error.code === "ENOENT") installed = false;
+      else { const j = JSON.parse(String(r.stdout || "").trim() || "{}"); signedIn = !!j.loggedIn && j.authMethod !== "apiKey"; }
+    } catch {}
+  }
+  CLAUDE_SEEN = { installed, signedIn, at: Date.now() };
+  return CLAUDE_SEEN;
+}
+const claudeReady = (fresh) => claudeState(fresh).signedIn;
+// What to do when it isn't: one line, for the CLI and the app.
+function claudeHelp(st = claudeState()) {
+  return st.installed ? "Claude Code is installed but not signed in: run  claude  once in a terminal and sign in with your Claude account, then try again."
+    : "Install Claude Code ( npm install -g @anthropic-ai/claude-code ), run  claude  once and sign in with your Claude account, then try again.";
+}
+
 // ---- config + provider resolution (config files: core.mjs) -----------------
 function antProfileExists() {
   try { return existsSync(join(homedir(), ".config", "anthropic")); } catch { return false; }
@@ -28,17 +57,22 @@ function envKey(provider) {
   return null;
 }
 // Returns { provider, key?, baseUrl?, model, source } or null if nothing set up.
-// Order: saved choice → legacy saved key → env keys → an `ant` profile.
+// Order: saved choice → your Claude subscription (Claude Code signed in) → legacy
+// saved key → env keys → an `ant` profile. With no choice saved, the subscription
+// comes before a key: it's what most people already pay for.
 function resolveProvider() {
   const cfg = loadConfig();
   const m = process.env.SYMBIOT_MODEL;
-  if (cfg.provider && PROVIDERS[cfg.provider]) {
+  const sub = () => ({ provider: "claude", model: m || (cfg.claude || {}).model || "", source: "your Claude subscription (Claude Code)" });
+  if (cfg.provider === "claude" && claudeReady()) return sub();
+  if (cfg.provider && cfg.provider !== "claude" && PROVIDERS[cfg.provider]) {
     const p = cfg.provider, pc = cfg[p] || {};
     if (p === "ollama") return { provider: p, baseUrl: pc.baseUrl || "http://localhost:11434", model: m || pc.model || PROVIDERS.ollama.model, source: "saved login" };
     const key = pc.apiKey || envKey(p);
     if (key || (p === "anthropic" && (process.env.ANTHROPIC_AUTH_TOKEN || antProfileExists())))
       return { provider: p, key, model: m || pc.model || PROVIDERS[p].model, source: pc.apiKey ? "saved login" : "environment" };
   }
+  if ((!cfg.provider || cfg.provider === "claude") && claudeReady()) return sub();
   if (cfg.apiKey) return { provider: "anthropic", key: cfg.apiKey, model: m || PROVIDERS.anthropic.model, source: "saved login (~/.config/symbiot)" };
   if (process.env.ANTHROPIC_API_KEY || process.env.ANTHROPIC_AUTH_TOKEN) return { provider: "anthropic", key: process.env.ANTHROPIC_API_KEY, model: m || PROVIDERS.anthropic.model, source: "ANTHROPIC_* (environment)" };
   if (process.env.OPENAI_API_KEY) return { provider: "openai", key: process.env.OPENAI_API_KEY, model: m || PROVIDERS.openai.model, source: "OPENAI_API_KEY (environment)" };
@@ -48,6 +82,36 @@ function resolveProvider() {
 }
 
 // ---- model calls (one per provider, same in/out) --------------------------
+// Claude Code, headless, on your subscription: Symbiot's own instructions as the
+// system prompt, the prompt on stdin, no tools (Read only, for screenshots you
+// attached), none of your settings, plugins or servers, no session kept. Not --bare:
+// that ignores the subscription sign-in.
+function callClaude(r, system, prompt, images = []) {
+  const shots = [];
+  for (const i of images) {
+    if (i.path) { shots.push(i.path); continue; }
+    try { const dir = join(CONFIG_DIR, "uploads"); mkdirSync(dir, { recursive: true, mode: 0o700 }); const f = join(dir, `${Date.now()}-${shots.length}.${/png/.test(i.mime) ? "png" : /webp/.test(i.mime) ? "webp" : /gif/.test(i.mime) ? "gif" : "jpg"}`); writeFileSync(f, Buffer.from(i.data, "base64"), { mode: 0o600 }); shots.push(f); } catch {}
+  }
+  const input = shots.length ? `${prompt}\n\nScreenshots they attached (look at them with your Read tool): ${shots.join(", ")}` : prompt;
+  const args = ["-p", "--output-format", "json", "--system-prompt", system, "--tools", shots.length ? "Read" : "", "--setting-sources", "",
+    "--strict-mcp-config", "--no-session-persistence", "--disable-slash-commands", ...(r.model ? ["--model", r.model] : [])];
+  return new Promise((resolve, reject) => {
+    let out = "", err = "", done = false;
+    let ch; try { ch = spawn(CLAUDE_BIN(), args, { cwd: CONFIG_DIR, stdio: ["pipe", "pipe", "pipe"], env: process.env }); } catch (e) { reject(e); return; }
+    const t = setTimeout(() => { if (!done) { done = true; try { ch.kill("SIGTERM"); } catch {} reject(new Error("Claude Code didn't answer within 3 minutes")); } }, 180000);
+    ch.stdout.on("data", (d) => { out += d; }); ch.stderr.on("data", (d) => { err += d; });
+    ch.on("error", (e) => { if (!done) { done = true; clearTimeout(t); reject(e); } });
+    ch.on("close", () => {
+      if (done) return; done = true; clearTimeout(t);
+      let j = null; try { j = JSON.parse(out.trim().split("\n").filter(Boolean).pop() || "{}"); } catch {}
+      if (j && j.is_error === false && typeof j.result === "string") { resolve(j.result.trim()); return; }
+      const why = (j && j.result) || err.trim().split("\n").pop() || out.trim().slice(0, 200) || "no answer";
+      CLAUDE_SEEN = null; // signed out since? ask again next time
+      reject(new Error(`Claude Code: ${String(why).slice(0, 300)}`));
+    });
+    ch.stdin.end(input);
+  });
+}
 // Screenshots you dropped into the talk: [{ mime, data (base64) }], in each model's own shape.
 async function callAnthropic(r, system, prompt, images = []) {
   const client = new Anthropic(r.key ? { apiKey: r.key } : {});
@@ -111,7 +175,7 @@ async function callOllama(r, system, prompt, images = []) {
 // spinner, its coloured hints); imported on its own, it stays quiet.
 const AI_UI = {
   spinner: () => () => {},
-  notConnected: () => console.log("Symbiot needs an AI to write your updates. Connect one with: symbiot login"),
+  notConnected: () => console.log("Symbiot needs an AI to write your updates. With a Claude subscription, sign in to Claude Code (run  claude  once) and Symbiot uses it, no key. Otherwise: symbiot login"),
   rejected: (label) => console.log(`Your ${label} credentials were rejected. Reconnect with:  symbiot login --force`),
 };
 async function write(system, prompt, { images = [] } = {}) {
@@ -119,6 +183,7 @@ async function write(system, prompt, { images = [] } = {}) {
   if (!r) { AI_UI.notConnected(); return null; }
   const stop = AI_UI.spinner("thinking…");
   try {
+    if (r.provider === "claude") return await callClaude(r, system, prompt, images);
     if (r.provider === "anthropic") return await callAnthropic(r, system, prompt, images);
     if (r.provider === "openai") return await callOpenAI(r, system, prompt, images);
     if (r.provider === "gemini") return await callGemini(r, system, prompt, images);
@@ -135,6 +200,7 @@ async function write(system, prompt, { images = [] } = {}) {
 
 async function validate(provider, { key, baseUrl } = {}) {
   try {
+    if (provider === "claude") return claudeReady(true);
     if (provider === "anthropic") { await new Anthropic({ apiKey: key }).models.list(); return true; }
     if (provider === "openai") return (await fetch("https://api.openai.com/v1/models", { headers: { Authorization: `Bearer ${key}` } })).ok;
     if (provider === "gemini") return (await fetch(`https://generativelanguage.googleapis.com/v1beta/models?key=${encodeURIComponent(key)}`)).ok;
@@ -197,6 +263,12 @@ async function connectProvider(b) {
   const provider = b && b.provider;
   if (!PROVIDERS[provider]) return { ok: false, message: "Unknown provider." };
   const cfg = loadConfig();
+  if (provider === "claude") {
+    if (!claudeReady(true)) return { ok: false, message: claudeHelp(claudeState()) };
+    const model = (b.model || "").trim();
+    cfg.provider = "claude"; cfg.claude = model ? { model } : {};
+    return saveConfig(cfg) ? { ok: true, message: `Connected: ${PROVIDERS.claude.label}${model ? " · " + model : ""}. No key needed.` } : { ok: false, message: "Couldn't write the config file." };
+  }
   if (provider === "ollama") {
     const baseUrl = (b.baseUrl || "http://localhost:11434").trim();
     const model = (b.model || "").trim() || PROVIDERS.ollama.model;
@@ -212,4 +284,4 @@ async function connectProvider(b) {
   return saveConfig(cfg) ? { ok: true, message: `Connected: ${PROVIDERS[provider].label} · ${model}` } : { ok: false, message: "Couldn't write the config file." };
 }
 
-export { PROVIDERS, AI_UI, resolveProvider, write, validate, connectProvider, detectHardware, recommendModels, hasOllama, ollamaInstall, ensureOllama, useOllamaModel };
+export { PROVIDERS, AI_UI, resolveProvider, write, validate, connectProvider, detectHardware, recommendModels, hasOllama, ollamaInstall, ensureOllama, useOllamaModel , claudeState, claudeReady, claudeHelp };

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/home.mjs

@@ -260,7 +260,7 @@ function homeState({ now = Date.now(), fresh = false, deps = {} } = {}) {
   // What Symbiot works through (an AI, your agent, the connectors runs use) shows
   // only when it's missing, and then first (urgent): nothing works without it.
   // First run: what only a new user can do before the rest means anything.
-  if (!connected()) you.push({ kind: "setup", id: "setup:ai", urgent: true, title: "Connect an AI", sub: "Symbiot can't work without one: a key, or a free local model", shape: "settings", focus: "ai" });
+  if (!connected()) you.push({ kind: "setup", id: "setup:ai", urgent: true, title: "Connect an AI", sub: "Symbiot can't work without one: your Claude subscription (sign in to Claude Code), a key, or a free local model", shape: "settings", focus: "ai" });
   const gone = agentGone(); if (gone) you.push({ kind: "setup", id: "setup:agent", urgent: true, title: "Your agent is unavailable", sub: `${gone} isn't on this computer any more, so no task can start`, shape: "settings", focus: "agent" });
   for (const c of signedOut()) you.push({ kind: "setup", id: "setup:conn:" + c.id, urgent: true, title: `Reconnect ${c.name}`, sub: `its Claude connector is signed out, so agent runs can't use ${c.name}`, shape: "settings", focus: "agent" });
   if (!Object.keys(map).some((n) => map[n] !== MARKETING_DIR)) you.push({ kind: "setup", id: "setup:folders", title: "Show me your work", sub: "where your repos are", shape: "settings", focus: "work" });
@@ -408,7 +408,7 @@ async function homeAsk(question, { ask, now = Date.now(), state, images = [] } =
   const h = state || homeState({ now });
   let map = {}; try { map = laneMap(); } catch {}
   const role = "Here they're on Symbiot's home: one liquid surface that shows what only they can do, what's new on what they watch, and the lanes. Answer from what it shows, and act on what they ask.";
-  const r = await converse({ where: "Home", role, context: homeContext(h), question: question + (pics.length ? `\n(The user attached ${pics.length} screenshot${pics.length > 1 ? "s" : ""}: you can see ${pics.length > 1 ? "them" : "it"}.)` : ""), map, now, images: pics.map(({ mime, data }) => ({ mime, data })), ...(ask ? { ask } : {}),
+  const r = await converse({ where: "Home", role, context: homeContext(h), question: question + (pics.length ? `\n(The user attached ${pics.length} screenshot${pics.length > 1 ? "s" : ""}: you can see ${pics.length > 1 ? "them" : "it"}.)` : ""), map, now, images: pics.map(({ mime, data, path }) => ({ mime, data, path })), ...(ask ? { ask } : {}),
     act: {
       agent: (req, known, repo) => (repo ? actIn(req + shotNote, repo, { map, known, title: "Home" }) : actNow(req + shotNote, { title: "Home", known })),
       task: (text, repo) => taskIn(text + shotNote, repo, { map }),

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,16 +23,16 @@
 // 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 } from "./ai.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";
 import { gitDefaultBranch, loadDeploys, driftRepo, computeDrift } from "./drift.mjs";
 import { buildTasksMd, taskType, shipChanges, shipWithBump, bumpOffer, learnNpm, releaseNeeded, withReleases, setVersion, syncTasks, pendingReview, unreleased, publishesOnMerge, addTask, approveRepo, approveChanges, sendBack, pushTasks } from "./tasks.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";
@@ -118,7 +118,7 @@ function ask(question, { secret = false } = {}) {
 
 const AUTH_HELP =
   c.y("Symbiot needs an AI to write your updates. Connect one:\n") +
-  "  " + c.b("symbiot login") + c.d("   pick Claude, OpenAI, Gemini, or a local model (Ollama)") + "\n" +
+  "  " + c.b("symbiot login") + c.d("   your Claude subscription (Claude Code, no key), Claude, OpenAI, Gemini or a local model") + "\n" +
   c.d("  Or set a key in your environment: ANTHROPIC_API_KEY / OPENAI_API_KEY / GEMINI_API_KEY.");
 // What writing with the AI (ai.mjs) shows in the terminal.
 Object.assign(AI_UI, {
@@ -215,26 +215,34 @@ async function cmdLogin() {
   const flagProvider = flag("provider", null);
   const existing = resolveProvider();
   if (existing && !flagProvider && !flag("key", null) && !has("force")) {
-    console.log(c.g("✓ ") + `Already connected — ${PROVIDERS[existing.provider].label} via ${existing.source}.`);
+    console.log(c.g("✓ ") + (existing.provider === "claude" ? "Already connected: your Claude subscription, through Claude Code signed in here. No key needed." : `Already connected — ${PROVIDERS[existing.provider].label} via ${existing.source}.`));
     console.log(c.d("  Switch or replace it with `symbiot login --force`."));
     return;
   }
 
   let provider = flagProvider;
   if (!provider) {
+    const cs = claudeState(true);
     console.log("\n" + c.b("Connect Symbiot") + "\n");
     console.log("Which AI should Symbiot write your updates with?\n");
-    console.log("  1) " + PROVIDERS.anthropic.label + c.d("    — needs an Anthropic API key"));
-    console.log("  2) " + PROVIDERS.openai.label + c.d("          — needs an OpenAI API key"));
-    console.log("  3) " + PROVIDERS.gemini.label + c.d("       — needs a Google AI API key"));
-    console.log("  4) " + PROVIDERS.ollama.label + c.d("  — runs on your machine, no key"));
-    const pick = (await ask("\nChoose 1-4 [1]: ")) || "1";
-    provider = { 1: "anthropic", 2: "openai", 3: "gemini", 4: "ollama" }[pick] || (PROVIDERS[pick] ? pick : "anthropic");
+    console.log("  1) " + PROVIDERS.claude.label + c.d(cs.signedIn ? "  — signed in here, no key" : cs.installed ? "  — Claude Code is here; sign in first (run  claude )" : "  — needs Claude Code, signed in (no key)"));
+    console.log("  2) " + PROVIDERS.anthropic.label + c.d("    — needs an Anthropic API key"));
+    console.log("  3) " + PROVIDERS.openai.label + c.d("          — needs an OpenAI API key"));
+    console.log("  4) " + PROVIDERS.gemini.label + c.d("       — needs a Google AI API key"));
+    console.log("  5) " + PROVIDERS.ollama.label + c.d("  — runs on your machine, no key"));
+    const pick = (await ask("\nChoose 1-5 [1]: ")) || "1";
+    provider = { 1: "claude", 2: "anthropic", 3: "openai", 4: "gemini", 5: "ollama" }[pick] || (PROVIDERS[pick] ? pick : "claude");
   }
   if (!PROVIDERS[provider]) { console.log(c.y("Unknown provider: " + provider)); return; }
   const meta = PROVIDERS[provider];
   const cfg = loadConfig();
 
+  if (provider === "claude") {
+    const r = await connectProvider({ provider: "claude", model: flag("model", null) || "" });
+    if (!r.ok) { console.log(c.y(r.message)); process.exitCode = 1; return; }
+    console.log(c.g("✓ ") + r.message + "  Try:  " + c.b("symbiot week"));
+    return;
+  }
   if (provider === "ollama") {
     const baseUrl = (flag("base-url", null) || (await ask("Ollama URL [http://localhost:11434]: ")) || "").trim() || "http://localhost:11434";
     const model = (flag("model", null) || (await ask(`Model name [${meta.model}]: `)) || "").trim() || meta.model;
@@ -342,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; };
@@ -767,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
@@ -825,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/mind.mjs

@@ -32,7 +32,7 @@ import { knowledgeFor } from "./knowledge.mjs";
 const MIND_FILE = join(CONFIG_DIR, "mind.json");
 const ACT_DIR = join(CONFIG_DIR, "drafts"); // runs of their own, next to drafted replies
 const CLI = fileURLToPath(new URL("./index.mjs", import.meta.url));
-const MAX_NODES = 400, MAX_FACTS = 12, MAX_LOG = 120, RECALL = 8, LOG_LINES = 6;
+const MAX_NODES = 400, MAX_FACTS = 12, MAX_LOG = 240, RECALL = 8, LOG_LINES = 6, TURN_CHARS = 1500;
 
 // ---- memory ---------------------------------------------------------------------
 function loadMind() {
@@ -80,10 +80,19 @@ function recall(query, now = Date.now(), d = loadMind(), limit = RECALL) {
 }
 const recallText = (nodes) => nodes.map((n) => `- ${n.name} (${n.kind}): ${n.facts.slice(-4).map((f) => f.text).join("; ")}`).join("\n");
 function logTurn(where, role, text, now = Date.now(), d = loadMind()) {
-  d.log = [...d.log, { ts: now, where, role, text: String(text || "").replace(/\s+/g, " ").trim().slice(0, 400) }].slice(-MAX_LOG);
+  d.log = [...d.log, { ts: now, where, role, text: String(text || "").replace(/\s+/g, " ").trim().slice(0, TURN_CHARS) }].slice(-MAX_LOG);
 }
 // The last few lines said anywhere else in the app: how the next page knows
 // what you were just talking about.
+// This chat's own last turns, for a chat that doesn't keep its thread itself (Home):
+// without them a "yeah" to "want that?" went to whatever was said elsewhere (a
+// kernel reboot card) and the task they'd agreed to was never made. Home is where
+// people think things through, so it keeps a real conversation: 16 turns, each whole
+// (up to TURN_CHARS), from the last 12 hours.
+const THREAD_TURNS = 16, THREAD_AGE = 12 * 3600000;
+function ownThread(where, d = loadMind(), now = Date.now()) {
+  return d.log.filter((l) => l.where === where && now - (l.ts || 0) < THREAD_AGE).slice(-THREAD_TURNS).map((l) => `${l.role === "user" ? "User" : "You"}: ${l.text}`).join("\n");
+}
 function lately(where, d = loadMind(), n = LOG_LINES) {
   return d.log.filter((l) => l.where !== where).slice(-n).map((l) => `- [${l.where}] ${l.role === "user" ? "User" : "You"}: ${l.text.slice(0, 200)}`).join("\n");
 }
@@ -156,6 +165,9 @@ function rulesFor(lanes = [], self = "") {
 When they ask you to do something (look into it, find out, fix, set up, sign in, close, send, chase), do it, don't explain what you can't do: "agent" starts a coding agent now, with their tools and connectors (MCP, the command line, a browser signed in to their linked sites). With a "repo", it's that project's agent, working in it; empty, an agent for everything outside a repo (this computer, accounts, services). Use "task" for what's for later. Don't ask their permission to hand it over: the agent asks them first, on the Workdesk, before anything hard to undo (closing an account, deleting, paying, sending); say so in your reply when it applies, with what to check first. A question you can answer from what's here: answer it, "do": null.
 Lanes ("repo" is one of these, exactly): ${lanes.length ? lanes.slice(0, 60).join(", ") : "(none found)"}.${lanes.includes(MARKETING) ? ` "${MARKETING}" is a lane of its own for marketing any of their products (posts, demo videos, launches, campaigns, pricing pages' copy): marketing work goes there, starting with the product it's for in brackets, "[Dailify] a launch post".` : ""}${self ? ` Symbiot itself is "${self}": a flaw in how Symbiot works (how it read a page, what a brief or a card said, anything in the app) goes there.` : ""}
 Don't wait to be asked to fix Symbiot. When you notice it got something wrong (you misread a page, a brief or a card misled them, a step made them do an agent's job), say so plainly and, in the same reply, start the fix: "agent"${self ? ` with "repo": "${self}"` : ""}, saying what went wrong, an example, and what it should do instead.
+A short answer (yes, yeah, ok, sure, go, do it, that one, 2) answers what you last said in "This chat so far", never something from elsewhere in the app. If you'd proposed a task or an agent and they agree, do it now in "do", in the lane you named.
+Hash it out first: when they bring an idea rather than a clear ask, sharpen it with them: say what's strong, push back where it's weak, add what's missing, and propose it as a task (naming the lane) once it holds up. "do" stays null until they agree.
+When an ask could mean two or more things (which lane, how much, what done looks like), don't guess: "do" stays null, and the reply gives 2-3 short numbered readings, your pick first, and asks which. A clear ask goes straight through.
 "remember": only lasting facts worth knowing on another page (who someone is, which account is what, a decision, how they like things); [] for anything else.`;
 }
 // Symbiot's own repo among your lanes (its package.json is symbiot's), or "".
@@ -193,6 +205,7 @@ function parseReply(raw) {
 // what "do" runs here. Gives { reply, did?, remembered }.
 async function converse({ where, role = "", context = "", history = "", question, act = {}, ask = write, map = null, now = Date.now(), images = [] }) {
   const d = loadMind(), hits = recall(question, now, d), known = recallText(hits), elsewhere = lately(where, d);
+  if (!history) history = ownThread(where, d, now);
   // what it did to answer, to show under the reply (as the app shows an agent's work)
   const steps = [];
   if (hits.length) steps.push(`recalled ${hits.length === 1 ? hits[0].name : hits.length + " things: " + hits.slice(0, 3).map((h) => h.name).join(", ")}`);
@@ -205,7 +218,7 @@ async function converse({ where, role = "", context = "", history = "", question
   // how they talk, from what they've typed into any chat (adapt.mjs: accommodation)
   const voice = styleLine(styleOf(d.log.filter((l) => l.role === "user").map((l) => l.text).concat(question)));
   const system = `${IDENTITY} ${role}\n\n${rulesFor(Object.keys(lanes), selfLane(lanes))}${voice ? "\n" + voice : ""}`;
-  const prompt = (known ? `What you know (from across the app):\n${known}\n\n` : "") + (kn.text ? kn.text + "\n\n" : "") + (elsewhere ? `Lately, elsewhere in the app:\n${elsewhere}\n\n` : "") +
+  const prompt = (known ? `What you know (from across the app):\n${known}\n\n` : "") + (kn.text ? kn.text + "\n\n" : "") + (elsewhere ? `Lately, elsewhere in the app (other chats: a short answer here doesn't reply to these):\n${elsewhere}\n\n` : "") +
     (context ? context + "\n\n" : "") + (history ? `This chat so far:\n${history}\n\n` : "") + `They say (on ${where}): ${question}`;
   const raw = await ask(system, prompt, images.length ? { images } : undefined);
   if (!raw || /^\(?couldn't reach the model/i.test(String(raw))) return { reply: "(couldn't reach the model)", remembered: 0 };
@@ -237,4 +250,4 @@ async function converse({ where, role = "", context = "", history = "", question
 // The usual "task" act, for a caller with no lanes of its own to pass.
 const addToTasks = (text, repo) => { let map = {}; try { map = laneMap(); } catch {} return taskIn(text, repo, { map }); };
 
-export { MIND_FILE, loadMind, remember, recall, recallText, lately, mindState, forget, actBrief, actNow, actIn, taskIn, selfLane, rulesFor, parseReply, converse, addToTasks };
+export { MIND_FILE, loadMind, remember, recall, recallText, lately, mindState, forget, actBrief, actNow, actIn, taskIn, selfLane, rulesFor, parseReply, converse, addToTasks , ownThread };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "symbiot",
-  "version": "0.55.2",
+  "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/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(); }
@@ -231,7 +240,7 @@ async function startApp({ bin, since = 7, all = false, c = PLAIN_COLOURS } = {})
       if (tok !== TOKEN) { res.writeHead(403); res.end("forbidden"); return; }
     }
     try {
-      if (u.pathname === "/api/status") { const r = resolveProvider(); return json(res, r ? { connected: true, line: `${PROVIDERS[r.provider].label} · ${r.model}` } : { connected: false }); }
+      if (u.pathname === "/api/status") { const r = resolveProvider(); return json(res, r ? { connected: true, provider: r.provider, line: `${PROVIDERS[r.provider].label}${r.model ? " · " + r.model : ""}` } : { connected: false }); }
       if (u.pathname === "/api/map") return json(res, await buildMap()); // local git only — no AI key needed
       if (u.pathname === "/api/scan") return json(res, { active: SCAN.active, phase: SCAN.phase, done: SCAN.done, total: SCAN.total, item: SCAN.item, elapsed: SCAN.startedAt ? Date.now() - SCAN.startedAt : 0, timeout: SCAN_TIMEOUT_MS, partial: SCAN.partial });
       if (u.pathname === "/api/models") { const hw = detectHardware(); return json(res, { hardware: hw, rec: recommendModels(hw) }); }
@@ -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}
@@ -1078,12 +1079,14 @@ body.lq-light .btip .bta button:not(.quiet){background:#151A21;color:#FFFFFF}
 <div class="sset"><h3 class="ssh">Your AI</h3>
 <label>Which AI should Symbiot write with?</label>
 <select id="provider">
-<option value="anthropic">Claude (Anthropic)</option>
+<option value="claude">Your Claude subscription (Claude Code) - no key</option>
+<option value="anthropic">Claude (Anthropic) - API key</option>
 <option value="openai">OpenAI (GPT)</option>
 <option value="gemini">Gemini (Google)</option>
 <option value="ollama">Local model (Ollama) - free, no key</option>
 </select>
-<div class="note muted">The Map needs no key. For the write-ups, a hosted model needs an API key - or run <b>Ollama</b> locally for a free, private option (nothing leaves your machine).</div>
+<div class="note muted">With a Claude subscription (Pro or Max), Symbiot answers through <b>Claude Code</b> signed in on this computer: no key, no extra bill. Otherwise a hosted model needs an API key, or run <b>Ollama</b> locally for a free, private option (nothing leaves your machine).</div>
+<div id="subWrap" class="note hidden"></div>
 <div id="keyWrap"><label>API key</label><input id="key" type="password" placeholder="paste your key">
 <div class="note"><a id="getkey">Where do I get a key?</a></div></div>
 <div id="baseWrap" class="hidden"><label>Ollama URL</label><input id="baseUrl" type="text" value="http://localhost:11434"></div>
@@ -1174,8 +1177,8 @@ body.lq-light .btip .bta button:not(.quiet){background:#151A21;color:#FFFFFF}
 <script>
 var T=new URLSearchParams(window.location.search).get('t')||'';
 function api(path,body){return fetch(path,{method:body?'POST':'GET',headers:{'x-symbiot-token':T,'content-type':'application/json'},body:body?JSON.stringify(body):undefined}).then(function(r){return r.json();});}
-var KEYURL={anthropic:'https://console.anthropic.com/settings/keys',openai:'https://platform.openai.com/api-keys',gemini:'https://aistudio.google.com/apikey',ollama:'https://ollama.com'};
-var DEFMODEL={anthropic:'claude-opus-5-5',openai:'gpt-4o-mini',gemini:'gemini-1.5-flash',ollama:'llama3.1'};
+var KEYURL={claude:'https://claude.com/claude-code',anthropic:'https://console.anthropic.com/settings/keys',openai:'https://platform.openai.com/api-keys',gemini:'https://aistudio.google.com/apikey',ollama:'https://ollama.com'};
+var DEFMODEL={claude:'your plan’s default',anthropic:'claude-opus-5-5',openai:'gpt-4o-mini',gemini:'gemini-1.5-flash',ollama:'llama3.1'};
 function $(id){return document.getElementById(id);}
 // Live updates never pull text out from under your selection. A refresh that would
 // redraw what you're selecting in waits until you let it go (selWait), and a redraw
@@ -1233,7 +1236,8 @@ function firstTab(){api('/api/watch/board').then(function(b){if(b&&b.cards&&b.ca
 // The AI in use isn't shown while it works (it's noise); only when none is
 // connected, as an urgent line that opens its part of Settings. Home has it out
 // front too, with the agent and the connectors runs use (home.mjs).
-function refresh(){api('/api/status').then(function(s){var st=$('status');if(!st)return;st.classList.toggle('hidden',!!s.connected);st.classList.toggle('urgent',!s.connected);st.textContent=s.connected?'':"No AI connected: Symbiot can't work. Connect one \\u203a";});}
+var SUBLINE='';
+function refresh(){api('/api/status').then(function(s){if(s&&s.connected&&s.provider){var pv=$('provider');if(pv&&!pv.getAttribute('data-touched')){pv.value=s.provider;SUBLINE=s.provider==='claude'?'Connected: '+s.line+'. No key needed.':'';syncP();}}var st=$('status');if(!st)return;st.classList.toggle('hidden',!!s.connected);st.classList.toggle('urgent',!s.connected);st.textContent=s.connected?'':"No AI connected: Symbiot can't work. Connect one \\u203a";});}
 // the status opens Settings: on a phone its tab is scrolled out of sight
 $('status').addEventListener('click',function(){var b=document.body;if(b&&b.classList&&b.classList.contains('lq-liquid')&&typeof lqFocus==='function'){lqFocus({kind:'setup',focus:'ai'});return;}setTab('settings');var t=document.querySelector('.tab[data-tab=settings]');if(t&&t.scrollIntoView)t.scrollIntoView({block:'nearest',inline:'nearest'});});
 // Where you are: the section you opened, named at the top of its panel (and the
@@ -1261,9 +1265,9 @@ api('/api/run',{cmd:current}).then(function(r){var f=$('outfoot');if(r.error==='
 var foot=[r.footer,r.file?'Saved to '+r.file:'',r.error&&r.text&&r.error!==r.text?r.error:''].filter(Boolean).join(' · ');
 WUTEXT=r.text||'';$('out').innerHTML=r.text?mdLite(r.text):'(no output)';$('out').classList.remove('muted');$('copy').classList.remove('hidden');if(foot){f.textContent=foot;f.style.display='block';}else{f.style.display='none';}});});
 $('copy').addEventListener('click',function(){var c=$('copy');try{navigator.clipboard.writeText(WUTEXT||$('out').textContent);}catch(e){}c.setAttribute('title','Copied');c.classList.add('done');setTimeout(function(){c.setAttribute('title','Copy');c.classList.remove('done');},1400);});
-function syncP(){var p=$('provider').value;var local=p==='ollama';$('keyWrap').classList.toggle('hidden',local);$('baseWrap').classList.toggle('hidden',!local);
+function syncP(){var p=$('provider').value;var local=p==='ollama',sub=p==='claude';$('keyWrap').classList.toggle('hidden',local||sub);$('baseWrap').classList.toggle('hidden',!local);var sw=$('subWrap');if(sw){sw.classList.toggle('hidden',!sub);sw.textContent=sub?(SUBLINE||'Uses Claude Code signed in on this computer with your Claude account. Not signed in yet? Run  claude  once in a terminal and sign in, then Save.'):'';}
 $('getkey').textContent=local?'About Ollama':'Where do I get a key?';$('modelHint').textContent='(default '+DEFMODEL[p]+')';$('model').placeholder='(blank = '+DEFMODEL[p]+')';}
-$('provider').addEventListener('change',syncP);
+$('provider').addEventListener('change',function(){$('provider').setAttribute('data-touched','1');syncP();});
 $('getkey').addEventListener('click',function(){window.open(KEYURL[$('provider').value],'_blank');});
 $('save').addEventListener('click',function(){var p=$('provider').value;$('saveMsg').textContent='checking...';$('saveMsg').className='note muted';
 var cfg={provider:p,model:$('model').value.trim()};if(p==='ollama')cfg.baseUrl=$('baseUrl').value.trim();else cfg.key=$('key').value.trim();