agenter-app 1.1.0 → 1.2.0

package/public/style.css

@@ -72,6 +72,15 @@
 :root[data-accent="teal"] { --accent: #73cfcb; --accent-deep: #1d7a76; }
 :root[data-accent="rose"] { --accent: #e58aa6; --accent-deep: #ad3a61; }
 :root[data-accent="lavender"] { --accent: #b8acf2; --accent-deep: #6450c4; }
+:root[data-accent="mint"] { --accent: #8fe0b4; --accent-deep: #1b7049; }
+:root[data-accent="sky"] { --accent: #8cc4ef; --accent-deep: #27689f; }
+:root[data-accent="indigo"] { --accent: #a0aef5; --accent-deep: #3f51bf; }
+:root[data-accent="plum"] { --accent: #d49ae0; --accent-deep: #8b3a9b; }
+:root[data-accent="magenta"] { --accent: #f08fd0; --accent-deep: #a82a83; }
+:root[data-accent="coral"] { --accent: #f29a8b; --accent-deep: #b03f2b; }
+:root[data-accent="amber"] { --accent: #eec15f; --accent-deep: #855b05; }
+:root[data-accent="lemon"] { --accent: #e3d96b; --accent-deep: #6d640b; }
+:root[data-accent="slate"] { --accent: #a9b8c6; --accent-deep: #4b5f72; }
 
 * { box-sizing: border-box; }
 html, body { height: 100%; margin: 0; }
@@ -101,7 +110,9 @@ kbd {
   width: 300px; flex: none; display: flex; flex-direction: column; gap: 6px;
   background: var(--sidebar); border-right: 1px solid var(--border); padding: 14px 10px 10px; min-height: 0;
 }
-.brand-row { display: flex; align-items: center; justify-content: space-between; padding: 0 6px 8px; }
+.brand-row { display: flex; align-items: center; gap: 8px; padding: 0 6px 8px; }
+.brand-row .brand { margin-right: auto; }
+.nav-min-btn { padding: 4px; color: var(--muted); }
 .brand { display: flex; align-items: center; gap: 9px; font-weight: 700; font-size: 15px; letter-spacing: -.01em; }
 .logo { width: 22px; height: 22px; border-radius: 7px; background: var(--accent); position: relative; }
 .logo::after { content: ""; position: absolute; inset: 6px; background: var(--accent-text); transform: rotate(45deg); border-radius: 2px; }
@@ -115,6 +126,7 @@ kbd {
 }
 .nav-item:hover { background: var(--hover); }
 .nav-item.active { background: var(--panel); box-shadow: var(--shadow-sm); }
+.nav-item:disabled { opacity: .6; cursor: progress; }
 .count { margin-left: auto; min-width: 20px; padding: 0 6px; border-radius: 99px; background: var(--warn); color: #fff; font-size: 11.5px; font-weight: 700; text-align: center; line-height: 19px; }
 
 .search { position: relative; display: flex; align-items: center; margin: 4px 0 2px; }
@@ -236,7 +248,8 @@ kbd {
 .segmented button:focus-visible { outline: 2px solid var(--accent-ink); outline-offset: 1px; }
 .segmented .ic { width: 14px; height: 14px; }
 .accent-row { display: flex; align-items: center; gap: 7px; font-size: 13px; color: var(--text-2); }
-.accent-row span { margin-right: auto; }
+.accent-row > span { margin-right: auto; }
+.swatches { display: grid; grid-template-columns: repeat(7, 16px); gap: 7px; }
 .accent-row button {
   width: 16px; height: 16px; border-radius: 4px; border: 0; padding: 0; cursor: pointer;
   background: var(--sw); box-shadow: inset 0 0 0 1px rgba(0, 0, 0, .15);
@@ -276,16 +289,17 @@ kbd {
 .btn.primary kbd { background: transparent; color: inherit; border-color: currentColor; opacity: .7; }
 
 /* ---------- main ---------- */
-.main { flex: 1; display: flex; flex-direction: column; min-width: 0; }
+/* Measured as a container: what matters is the room left beside the sidebar, not the window. */
+.main { flex: 1; display: flex; flex-direction: column; min-width: 0; container: main / inline-size; }
 .main-head {
-  display: flex; align-items: center; gap: 12px; padding: 12px 24px; min-height: 64px;
+  display: flex; flex-wrap: wrap; align-items: center; gap: 8px 12px; padding: 12px 24px; min-height: 64px;
   border-bottom: 1px solid var(--border); background: var(--panel);
 }
-.head-text { min-width: 0; flex: 1; }
+.head-text { min-width: 0; flex: 1 1 180px; }
 .head-title { display: flex; align-items: center; gap: 8px; font-weight: 700; font-size: 16px; letter-spacing: -.01em; }
 .head-title span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .head-sub { font-size: 12.5px; color: var(--muted); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-.head-actions { display: flex; align-items: center; gap: 8px; flex: none; }
+.head-actions { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; min-width: 0; }
 .menu-btn { display: none; }
 .path-chip { cursor: pointer; border: 0; background: none; padding: 0; color: var(--muted); font-size: 12px; }
 .path-chip:hover { color: var(--text); text-decoration: underline; }
@@ -318,6 +332,59 @@ dialog.new-dialog { max-width: 520px; }
 .new-dialog .dlg-error { margin-top: 12px; font-size: 13px; color: var(--danger); }
 .new-dialog .dlg-actions { display: flex; justify-content: flex-end; gap: 8px; margin-top: 18px; }
 
+.new-dialog .folder-row { display: flex; gap: 8px; }
+.new-dialog .folder-row .field { flex: 1; min-width: 0; }
+.new-carry { display: flex; align-items: center; gap: 8px; margin-top: 10px; padding: 7px 10px; border-radius: 8px; background: var(--accent-soft); font-size: 12.5px; }
+.new-carry[hidden] { display: none; }
+.new-carry span { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+
+/* ---------- update bar ---------- */
+.update-bar { display: flex; flex-wrap: wrap; align-items: center; gap: 6px 12px; padding: 8px 24px; background: var(--accent-soft); border-bottom: 1px solid var(--border); font-size: 13px; }
+.update-bar[hidden] { display: none; }
+.update-bar .update-text { flex: 1 1 240px; min-width: 0; }
+.update-bar .update-text code { font-size: 12px; }
+
+/* ---------- more menu ---------- */
+.more-menu { position: fixed; inset: auto; margin: 0; min-width: 200px; padding: 4px; border: 1px solid var(--border); border-radius: 10px; background: var(--panel); color: var(--text); box-shadow: var(--shadow); }
+.more-menu button { display: flex; align-items: center; gap: 10px; width: 100%; padding: 7px 10px; border: 0; border-radius: 7px; background: none; cursor: pointer; font-size: 13px; text-align: left; }
+.more-menu button:hover, .more-menu button:focus-visible { background: var(--hover); outline: none; }
+.more-menu .ic { color: var(--muted); }
+
+/* ---------- terminal ---------- */
+.term { flex: none; height: min(36vh, 360px); min-height: 160px; display: flex; flex-direction: column; border-top: 1px solid var(--border); background: var(--code-bg); }
+.term[hidden] { display: none; }
+.term-bar { display: flex; align-items: center; gap: 6px; padding: 4px 8px 4px 14px; border-bottom: 1px solid var(--border); background: var(--panel); }
+.term-title { font-size: 12px; font-weight: 600; flex: none; }
+.term-cwd { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; color: var(--muted); font-size: 12px; }
+.term-bar .btn.icon { padding: 4px; }
+.term-out { flex: 1; min-height: 0; overflow: auto; padding: 8px 14px; font-size: 12.5px; line-height: 1.45; outline: none; }
+.term-line { display: flex; align-items: center; gap: 8px; padding: 6px 14px; border-top: 1px solid var(--border); }
+.term-prompt { color: var(--accent-ink); flex: none; }
+.term-input { flex: 1; min-width: 0; border: 0; outline: none; background: none; color: var(--text); padding: 0; }
+.term-input::placeholder { color: var(--muted); }
+
+/* ---------- memory ---------- */
+dialog.mem-dialog { max-width: 860px; }
+.mem-dialog[open] { display: flex; flex-direction: column; height: min(640px, calc(100vh - 48px)); }
+.mem-head { display: flex; align-items: baseline; gap: 10px; margin-bottom: 12px; min-width: 0; }
+.mem-head h2 { margin: 0; flex: none; }
+.mem-head span { color: var(--muted); font-size: 13px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.mem-body { flex: 1; min-height: 0; display: grid; grid-template-columns: 220px minmax(0, 1fr); gap: 14px; }
+.mem-list { overflow-y: auto; }
+.mem-group { font-size: 11px; font-weight: 600; text-transform: uppercase; letter-spacing: .06em; color: var(--muted); padding: 10px 8px 4px; }
+.mem-group:first-child { padding-top: 0; }
+.mem-file { display: flex; align-items: center; gap: 6px; width: 100%; padding: 5px 8px; border: 0; border-radius: 7px; background: none; cursor: pointer; font-size: 13px; text-align: left; }
+.mem-file span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.mem-file:hover { background: var(--hover); }
+.mem-file[aria-current="true"] { background: var(--accent-soft); }
+.mem-file .new { margin-left: auto; flex: none; color: var(--muted); font-size: 11px; }
+.mem-file .dirty { margin-left: auto; flex: none; width: 7px; height: 7px; border-radius: 50%; background: var(--warn); }
+.mem-edit { display: flex; flex-direction: column; gap: 8px; min-height: 0; min-width: 0; }
+.mem-path { font-size: 11.5px; color: var(--muted); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.mem-edit textarea { flex: 1; min-height: 0; resize: none; line-height: 1.5; }
+.mem-dialog .dlg-error { font-size: 13px; color: var(--danger); }
+.mem-dialog .dlg-actions { display: flex; justify-content: flex-end; gap: 8px; margin-top: 14px; }
+
 /* ---------- steering ---------- */
 .kind-steer .reply-row .hint { white-space: normal; }
 .link { border: 0; background: none; padding: 0; font: inherit; color: var(--accent-ink); text-decoration: underline; cursor: pointer; }
@@ -363,6 +430,9 @@ dialog.new-dialog { max-width: 520px; }
 .convo { display: flex; flex-direction: column; gap: 10px; }
 .msg-user { align-self: flex-end; max-width: 78%; background: var(--accent-soft); border: 1px solid transparent; padding: 9px 14px; border-radius: 14px 14px 4px 14px; white-space: pre-wrap; word-break: break-word; }
 .msg-user.from-dash { border-color: var(--accent-ink); }
+.carried { margin-top: 6px; font-size: 12.5px; color: var(--text-2); white-space: normal; }
+.carried > summary { cursor: pointer; }
+.carried pre { margin-top: 6px; max-height: 280px; overflow: auto; font-size: 12px; }
 .live-echo { display: flex; justify-content: flex-end; margin-top: 12px; }
 .msg-claude { display: grid; grid-template-columns: 26px 1fr; gap: 10px; align-items: start; }
 .claude-mark { width: 26px; height: 26px; border-radius: 8px; background: var(--panel); border: 1px solid var(--border); display: grid; place-items: center; color: var(--accent-ink); }
@@ -495,7 +565,7 @@ dialog.new-dialog { max-width: 520px; }
 .section-title { display: flex; align-items: baseline; gap: 8px; font-size: 12px; font-weight: 600; text-transform: uppercase; letter-spacing: .06em; color: var(--muted); margin: 26px 0 10px; }
 #inboxPending > .section-title { margin-top: 0; }
 .all-clear { display: flex; align-items: center; gap: 14px; padding: 18px 20px; border-radius: var(--radius); background: var(--panel); border: 1px solid var(--border); }
-.all-clear .big { width: 38px; height: 38px; border-radius: 50%; background: var(--ok-soft); color: var(--ok); display: grid; place-items: center; flex: none; }
+.all-clear .big { width: 38px; height: 38px; border-radius: 50%; background: var(--accent-soft); color: var(--accent-ink); display: grid; place-items: center; flex: none; }
 .all-clear b { display: block; }
 .all-clear span { color: var(--muted); font-size: 13px; }
 .tiles { display: grid; grid-template-columns: repeat(auto-fill, minmax(250px, 1fr)); gap: 10px; }
@@ -538,23 +608,49 @@ dialog form { text-align: right; }
   *, *::before, *::after { animation: none !important; transition: none !important; }
 }
 
+/* ---------- collapsed sidebar: a rail of icons and sessions ---------- */
+@media (min-width: 801px) {
+  .app.nav-min .sidebar { width: 60px; padding: 14px 8px 10px; align-items: stretch; }
+  .app.nav-min .brand-row { flex-direction: column; padding: 0 0 8px; }
+  .app.nav-min .brand { margin: 0; }
+  .app.nav-min .brand-name, .app.nav-min .search, .app.nav-min .usage, .app.nav-min .sidebar-foot, .app.nav-min .group-label { display: none; }
+  .app.nav-min .nav-item { justify-content: center; padding: 8px 0; position: relative; }
+  .app.nav-min .nav-item > span:not(.count) { display: none; }
+  .app.nav-min .nav-item .count { position: absolute; top: 0; right: 0; min-width: 16px; padding: 0 4px; line-height: 15px; font-size: 10px; }
+  .app.nav-min .session-list { margin: 0; padding: 0; }
+  .app.nav-min .s-item { grid-template-columns: 32px; justify-content: center; padding: 6px 0; }
+  .app.nav-min .s-main, .app.nav-min .s-when { display: none; }
+}
+
 /* ---------- small screens ---------- */
 @media (max-width: 800px) {
   .sidebar { position: fixed; inset: 0 auto 0 0; z-index: 40; transform: translateX(-100%); transition: transform .2s; box-shadow: var(--shadow); width: min(300px, 86vw); }
   .app.nav-open .sidebar { transform: none; }
   .app.nav-open .scrim { display: block; position: fixed; inset: 0; background: rgba(0, 0, 0, .35); z-index: 30; }
   .menu-btn { display: inline-flex; }
+  .search kbd { display: none; }
+}
+
+/* Going by the space beside the sidebar, so the same room lays out the same way whether
+   the sidebar is open, collapsed or a drawer. */
+@container main (max-width: 900px) {
+  .head-actions .label { display: none; }
+}
+@container main (max-width: 760px) {
   .main-head { padding: 10px 16px; }
+  .update-bar { padding: 8px 16px; }
   .content { padding: 16px; }
   .dock { padding: 0 16px 14px; }
-  .head-actions .label { display: none; }
   .msg-user { max-width: 92%; }
-  .btn kbd, .reply-row .hint, .search kbd { display: none; }
+  .btn kbd, .reply-row .hint { display: none; }
   .tools { margin-left: 8px; }
   /* No room side by side: the app goes on top, the conversation below. */
   .split { flex-direction: column; }
   .splitter { display: none; }
-  .preview { order: -1; width: auto; max-width: none; min-width: 0; height: 48vh; border-bottom: 1px solid var(--border); }
+  .preview { order: -1; width: auto; max-width: none; min-width: 0; height: 48vh; flex: none; border-bottom: 1px solid var(--border); }
+}
+@media (max-width: 640px) {
+  .mem-body { grid-template-columns: minmax(0, 1fr); grid-template-rows: minmax(0, 2fr) minmax(0, 5fr); }
 }
 
 .auth-lost { position: fixed; top: 12px; left: 50%; transform: translateX(-50%); z-index: 1000; max-width: calc(100vw - 32px); padding: 10px 14px; border-radius: 10px; background: #5c2a26; color: #fff; font-size: 13px; }

package/scripts/pick-folder.ps1

@@ -0,0 +1,85 @@
+# The Windows folder window behind New session. Prints the folder you chose, or nothing if
+# you cancel.
+Add-Type -AssemblyName System.Windows.Forms
+
+# Windows won't let a background process take focus, so without this the window could open
+# behind the dashboard and clicking New session would seem to do nothing. Joining the input
+# of the window that has focus is what makes SetForegroundWindow allowed.
+Add-Type @"
+using System;
+using System.Text;
+using System.Runtime.InteropServices;
+public static class PickFolderWindow {
+  [DllImport("user32.dll")] static extern IntPtr GetForegroundWindow();
+  [DllImport("user32.dll")] static extern uint GetWindowThreadProcessId(IntPtr h, IntPtr p);
+  [DllImport("kernel32.dll")] static extern uint GetCurrentThreadId();
+  [DllImport("user32.dll")] static extern bool AttachThreadInput(uint a, uint b, bool attach);
+  [DllImport("user32.dll")] static extern bool SetForegroundWindow(IntPtr h);
+  [DllImport("user32.dll")] static extern bool BringWindowToTop(IntPtr h);
+  [DllImport("user32.dll")] static extern bool IsWindowVisible(IntPtr h);
+  [DllImport("user32.dll", CharSet = CharSet.Unicode)] static extern int GetClassName(IntPtr h, StringBuilder name, int size);
+  delegate bool WindowVisitor(IntPtr h, IntPtr data);
+  [DllImport("user32.dll")] static extern bool EnumThreadWindows(uint thread, WindowVisitor visit, IntPtr data);
+  [DllImport("user32.dll")] static extern bool SetWindowPos(IntPtr h, IntPtr after, int x, int y, int cx, int cy, uint flags);
+  // Dialogs are the #32770 class. Runs on the dialog's thread, so its windows are ours.
+  static IntPtr FindDialog(uint thread) {
+    IntPtr found = IntPtr.Zero;
+    EnumThreadWindows(thread, (h, data) => {
+      StringBuilder name = new StringBuilder(16);
+      GetClassName(h, name, 16);
+      if (name.ToString() != "#32770" || !IsWindowVisible(h)) return true;
+      found = h;
+      return false;
+    }, IntPtr.Zero);
+    return found;
+  }
+  // True once the dialog really has focus.
+  public static bool BringForward() {
+    uint self = GetCurrentThreadId();
+    IntPtr dialog = FindDialog(self);
+    if (dialog == IntPtr.Zero) return false; // not up yet
+    if (GetForegroundWindow() == dialog) return true;
+    SetWindowPos(dialog, new IntPtr(-1), 0, 0, 0, 0, 0x0043); // topmost, no move or size, show
+    uint focused = GetWindowThreadProcessId(GetForegroundWindow(), IntPtr.Zero);
+    bool joined = focused != 0 && focused != self && AttachThreadInput(self, focused, true);
+    BringWindowToTop(dialog);
+    SetForegroundWindow(dialog);
+    if (joined) AttachThreadInput(self, focused, false);
+    return GetForegroundWindow() == dialog;
+  }
+}
+"@
+
+[Console]::OutputEncoding = [Text.UTF8Encoding]::new($false)
+
+$owner = New-Object System.Windows.Forms.Form
+$owner.TopMost = $true
+# Windows can still refuse focus, and this keeps the window findable when it does.
+$owner.ShowInTaskbar = $true
+$owner.Text = 'Agenter: choose a folder'
+$owner.FormBorderStyle = 'None'
+$owner.Opacity = 0
+$owner.StartPosition = 'Manual'
+$owner.Location = New-Object System.Drawing.Point(-32000, -32000)
+$owner.Show()
+
+$dialog = New-Object System.Windows.Forms.FolderBrowserDialog
+$dialog.Description = 'Choose the project folder for this session'
+$dialog.ShowNewFolderButton = $true
+if ($env:AGENTER_PICK_START -and (Test-Path -LiteralPath $env:AGENTER_PICK_START)) { $dialog.SelectedPath = $env:AGENTER_PICK_START }
+
+# Runs inside the dialog's own message loop. Keeps trying for a few seconds, then lets you be.
+$raise = New-Object System.Windows.Forms.Timer
+$raise.Interval = 50
+$script:tries = 0
+$raise.add_Tick({
+  $script:tries++
+  if ([PickFolderWindow]::BringForward() -or $script:tries -ge 60) { $raise.Stop() }
+})
+$raise.Start()
+
+if ($dialog.ShowDialog($owner) -eq [System.Windows.Forms.DialogResult]::OK) {
+  [Console]::Out.Write($dialog.SelectedPath)
+}
+$raise.Dispose()
+$owner.Dispose()

package/server.js

@@ -13,6 +13,10 @@ const { truncate, describeTool, readTail, readHead, parseCodexItem, readTranscri
 const { normalizeLimits, codexWindowLabel } = require('./lib/limits');
 const { buildDiffs } = require('./lib/diff');
 const { getToken, sameToken } = require('./lib/token');
+const { version: VERSION } = require('./package.json');
+const updates = require('./lib/update');
+const { createTerminals } = require('./lib/terminal');
+const { readMemory, saveMemory, carriedContext } = require('./lib/memory');
 
 const PORT = Number(process.env.AGENTER_PORT) || 4317;
 const HOST = '127.0.0.1';
@@ -36,6 +40,9 @@ const DISCOVER_FULL_SCAN_MS = 5 * 60 * 1000; // when a file watcher catches chan
 const CREDENTIALS_FILE = path.join(os.homedir(), '.claude', '.credentials.json');
 const USAGE_URL = 'https://api.anthropic.com/api/oauth/usage';
 const USAGE_INTERVAL_MS = 2 * 60 * 1000;
+// A window opening also checks, so a long-running server still tells you about updates.
+const UPDATE_INTERVAL_MS = 6 * 60 * 60 * 1000;
+const UPDATE_THROTTLE_MS = 60 * 1000;
 
 const sessions = new Map(); // session_id -> session
 const pending = new Map(); // pending id -> { item, res, payload }
@@ -463,6 +470,56 @@ function noteCodexLimits(rl, at) {
   codexUsage = { updatedAt: at, plan: rl.plan_type || '', limits, credits: rl.credits || null };
 }
 
+// ---------- updates ----------
+
+let latestVersion = updates.cachedLatest();
+let updateCheckedAt = 0;
+
+async function checkForUpdate() {
+  if (!updates.enabled()) return;
+  updateCheckedAt = Date.now();
+  latestVersion = (await updates.checkLatest({ timeoutMs: 10000 })) || latestVersion;
+  broadcast();
+}
+
+function updateState() {
+  const installed = updates.installedVersion();
+  return {
+    current: VERSION,
+    latest: latestVersion,
+    installed,
+    available: updates.isNewer(latestVersion, VERSION) && !updates.isNewer(installed, VERSION),
+    restart: updates.isNewer(installed, VERSION), // installed, but this server is still the old code
+    canSelfUpdate: updates.canSelfUpdate(),
+  };
+}
+
+// ---------- terminal ----------
+
+const TERMINAL_ENABLED = process.platform === 'win32' && process.env.AGENTER_TERMINAL !== '0';
+const terminals = createTerminals((e) => sendAll('terminal', e));
+const terminalId = (cwd) => path.resolve(cwd).toLowerCase();
+
+// ---------- folder window ----------
+// The dashboard can't browse this machine's folders itself, so the server opens Windows' own.
+
+let pickingFolder = null;
+
+function pickFolder(start) {
+  return new Promise((resolve) => {
+    if (pickingFolder) return resolve({ busy: true });
+    if (process.platform !== 'win32') return resolve({ unsupported: true });
+    const args = ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-STA', '-File', path.join(__dirname, 'scripts', 'pick-folder.ps1')];
+    pickingFolder = execFile('powershell.exe', args, { windowsHide: true, env: { ...process.env, AGENTER_PICK_START: String(start || '') } }, (err, out) => {
+      pickingFolder = null;
+      onAttentionChanged();
+      const folder = String(out || '').trim();
+      resolve(err ? { unsupported: true } : folder ? { path: folder } : { cancelled: true });
+    });
+    onAttentionChanged();
+  });
+}
+
 function openInVSCode(cwd) {
   if (!cwd || /["&|<>^%]/.test(cwd) || !fs.existsSync(cwd)) return false;
   const child =
@@ -660,7 +717,8 @@ function respond(id, action, body = {}) {
 
 // Sessions are only held while a dashboard window has focus. If you're in VS Code,
 // Claude finishes (or asks) there as usual instead of spinning on the dashboard.
-const inUse = () => [...clients.values()].some((c) => c.focused);
+// The folder window takes focus from the dashboard, but you're still here.
+const inUse = () => !!pickingFolder || [...clients.values()].some((c) => c.focused);
 
 let releaseTimer = null;
 function onAttentionChanged() {
@@ -673,15 +731,24 @@ function onAttentionChanged() {
 }
 
 // Quit, from the tray. Open windows close themselves on the 'quit' event.
-function stopServer() {
-  for (const c of clients.keys()) c.write('event: quit\ndata: {}\n\n');
+// A restart (to finish an update) leaves them open; they reconnect to the new server.
+function stopServer({ restart = false } = {}) {
+  if (!restart) sendAll('quit', {});
   for (const id of [...pending.keys()]) respond(id, 'pass');
   for (const child of runners.values()) {
     child.interrupted = true;
     killRun(child);
   }
-  fs.mkdirSync(SETTINGS_DIR, { recursive: true });
-  fs.writeFileSync(STOPPED_FILE, '');
+  terminals.killAll();
+  pickingFolder?.kill();
+  if (restart) {
+    // It waits for this process to let go of the port.
+    const env = { ...process.env, AGENTER_RESTART: '1' };
+    spawn(process.execPath, [path.join(__dirname, 'server.js'), '--no-open'], { detached: true, stdio: 'ignore', windowsHide: true, env }).unref();
+  } else {
+    fs.mkdirSync(SETTINGS_DIR, { recursive: true });
+    fs.writeFileSync(STOPPED_FILE, '');
+  }
   // Long enough for the hooks to receive those answers.
   setTimeout(() => process.exit(0), 300);
 }
@@ -929,6 +996,15 @@ function startCodexRun(s, text, { fresh = false } = {}) {
   });
 }
 
+// ---------- memory ----------
+
+const memoryContext = (s) => ({ agent: s.agent, cwd: s.cwd, transcriptPath: s.transcriptPath, home: os.homedir(), codexHome: CODEX_HOME });
+
+function carryFrom(s) {
+  const t = s?.transcriptPath && readTranscript(s.transcriptPath);
+  return t ? carriedContext({ agent: s.agent, cwd: s.cwd, title: s.title, messages: t.messages }) : '';
+}
+
 // ---------- hook events ----------
 
 function handleHook(p, res) {
@@ -1011,6 +1087,9 @@ function handleHook(p, res) {
 
 function snapshot() {
   return {
+    version: VERSION,
+    update: updateState(),
+    terminal: TERMINAL_ENABLED,
     settings,
     usage,
     codexUsage,
@@ -1020,14 +1099,18 @@ function snapshot() {
   };
 }
 
+const sendAll = (event, data) => {
+  const msg = `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
+  for (const c of clients.keys()) c.write(msg);
+};
+
 let broadcastQueued = false;
 function broadcast() {
   if (broadcastQueued) return;
   broadcastQueued = true;
   setTimeout(() => {
     broadcastQueued = false;
-    const msg = `event: state\ndata: ${JSON.stringify(snapshot())}\n\n`;
-    for (const c of clients.keys()) c.write(msg);
+    sendAll('state', snapshot());
   }, 30);
 }
 
@@ -1115,6 +1198,7 @@ const server = http.createServer(async (req, res) => {
       clients.set(res, { id: url.searchParams.get('client') || '', focused: url.searchParams.get('focused') === '1' });
       onAttentionChanged();
       if (!usage || Date.now() - usage.fetchedAt > 60000) fetchUsage();
+      if (Date.now() - updateCheckedAt > UPDATE_THROTTLE_MS) checkForUpdate();
       const ping = setInterval(() => res.write(': ping\n\n'), 20000);
       req.on('close', () => {
         clearInterval(ping);
@@ -1141,6 +1225,12 @@ const server = http.createServer(async (req, res) => {
       return json(res, 200, { apps: await findApps(s.cwd), detects: process.platform === 'win32' });
     }
 
+    if (req.method === 'GET' && url.pathname === '/api/memory') {
+      const s = sessions.get(url.searchParams.get('session'));
+      if (!s) return json(res, 404, { error: 'unknown session' });
+      return json(res, 200, { files: readMemory(memoryContext(s)) });
+    }
+
     if (req.method === 'POST' && url.pathname.startsWith('/api/')) {
       const body = await readBody(req);
 
@@ -1148,6 +1238,39 @@ const server = http.createServer(async (req, res) => {
         stopServer();
         return json(res, 200, {});
       }
+      if (url.pathname === '/api/restart') {
+        stopServer({ restart: true });
+        return json(res, 200, {});
+      }
+      if (url.pathname === '/api/update') {
+        if (!TERMINAL_ENABLED) return json(res, 400, { error: 'Run agenter update in a terminal.' });
+        if (!updates.canSelfUpdate()) return json(res, 400, { error: 'This copy is a git clone. Update it with git pull.' });
+        const id = terminalId(os.homedir());
+        const term = terminals.open(id, os.homedir());
+        if (term.running) return json(res, 409, { error: 'That terminal is busy. Wait for it to finish, or press Stop.' });
+        const quote = (p) => `'${p.replace(/'/g, "''")}'`;
+        terminals.run(id, `& ${quote(process.execPath)} ${quote(path.join(__dirname, 'cli.js'))} update`, checkForUpdate);
+        return json(res, 200, { id });
+      }
+      if (url.pathname.startsWith('/api/terminal/')) {
+        if (!TERMINAL_ENABLED) return json(res, 400, { error: 'The terminal is turned off or not available here.' });
+        if (url.pathname === '/api/terminal/open') {
+          const cwd = sessions.get(body.sessionId)?.cwd;
+          const folder = cwd && fs.existsSync(cwd) ? cwd : os.homedir();
+          return json(res, 200, terminals.open(terminalId(folder), folder));
+        }
+        const ok = url.pathname === '/api/terminal/run' ? terminals.run(body.id, String(body.input ?? '')) : url.pathname === '/api/terminal/stop' && terminals.stop(body.id);
+        return json(res, ok ? 200 : 404, {});
+      }
+      if (url.pathname === '/api/pick-folder') {
+        return json(res, 200, await pickFolder(body.start));
+      }
+      if (url.pathname === '/api/memory/save') {
+        const s = sessions.get(body.sessionId);
+        if (!s) return json(res, 404, { error: 'unknown session' });
+        const { status, ...out } = saveMemory(memoryContext(s), body.path, body.text, body.mtime);
+        return json(res, status, out);
+      }
       if (url.pathname === '/api/respond') {
         const s = sessions.get(pending.get(body.id)?.item.sessionId);
         const ok = respond(body.id, body.action, body);
@@ -1178,6 +1301,8 @@ const server = http.createServer(async (req, res) => {
         const cwd = String(body.cwd || '').trim().replace(/^"(.*)"$/, '$1');
         const text = String(body.message || '').trim();
         const codex = body.agent === 'codex';
+        const carried = carryFrom(sessions.get(body.fromSessionId));
+        const prompt = carried ? `${text}\n\n${carried}` : text;
         if (!text) return json(res, 400, { error: `Type a first message for ${codex ? 'Codex' : 'Claude'}.` });
         let isDir = false;
         try {
@@ -1189,7 +1314,7 @@ const server = http.createServer(async (req, res) => {
           // Codex names the session itself, so it's registered once Codex has started it.
           const draft = Object.assign(newSession(''), { agent: 'codex', title: text.split('\n')[0].slice(0, 140), lastEventAt: Date.now() });
           setCwd(draft, path.resolve(cwd));
-          const started = await Promise.race([startCodexRun(draft, text, { fresh: true }), new Promise((r) => setTimeout(() => r({ error: 'Codex took too long to start.' }), 60000))]);
+          const started = await Promise.race([startCodexRun(draft, prompt, { fresh: true }), new Promise((r) => setTimeout(() => r({ error: 'Codex took too long to start.' }), 60000))]);
           if (!started?.id) return json(res, 500, { error: `Codex couldn't start: ${started?.error || 'unknown error'}` });
           settings.drive = { ...settings.drive, [started.id]: 'agenter' };
           saveSettings();
@@ -1204,7 +1329,7 @@ const server = http.createServer(async (req, res) => {
         s.lastEventAt = Date.now();
         settings.drive = { ...settings.drive, [s.id]: 'agenter' };
         saveSettings();
-        if (!startRun(s, text, { fresh: true })) {
+        if (!startRun(s, prompt, { fresh: true })) {
           sessions.delete(s.id);
           return json(res, 500, { error: "Couldn't start Claude." });
         }
@@ -1278,7 +1403,9 @@ const server = http.createServer(async (req, res) => {
 server.requestTimeout = 0; // hooks can legitimately wait a long time for you
 // Only listen when run directly; the tests load this file to drive the hook and steering logic.
 if (require.main === module) {
+  let portRetries = process.env.AGENTER_RESTART ? 50 : 0;
   server.on('error', (err) => {
+    if (err.code === 'EADDRINUSE' && portRetries-- > 0) return void setTimeout(() => server.listen(PORT, HOST), 200);
     if (err.code === 'EADDRINUSE') console.error(`Port ${PORT} is busy. Is Agenter already running? (Set AGENTER_PORT to use another port.)`);
     else console.error(err);
     process.exit(1);
@@ -1286,12 +1413,18 @@ if (require.main === module) {
   server.listen(PORT, HOST, () => {
     const url = `http://localhost:${PORT}`;
     console.log(`Agenter dashboard: ${url}`);
+    delete process.env.AGENTER_RESTART;
     fs.rmSync(STOPPED_FILE, { force: true });
+    // Shortcuts start us inside the install folder, and on Windows a folder that's in use
+    // can't be replaced by `npm i -g`. Everything here uses full paths.
+    process.chdir(os.homedir());
     startTray();
     startDiscovery();
     startCodexDiscovery();
     fetchUsage();
     setInterval(fetchUsage, USAGE_INTERVAL_MS);
+    checkForUpdate();
+    setInterval(checkForUpdate, UPDATE_INTERVAL_MS);
     if (!process.argv.includes('--no-open')) openDashboard(url);
   });
 }