@saadnvd1/agent-os 0.3.794 → 0.3.799

package/content/tips.json

@@ -0,0 +1,456 @@
+{
+  "v": 1,
+  "tips": [
+    {
+      "id": "chat-enter-sends",
+      "title": "Enter sends, Shift+Enter adds a line",
+      "body": "Cmd/Ctrl+Enter always sends. On a phone, Enter is a new line.",
+      "guide": {
+        "file": "chat"
+      },
+      "added": "2026-10-31"
+    },
+    {
+      "id": "chat-plan-mode",
+      "title": "Plan before anything changes",
+      "body": "Turn on Plan under the composer, or press Shift+Tab, and the agent reads and plans without editing. It stays on for that session.",
+      "guide": {
+        "file": "chat"
+      },
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "crop",
+        "shot": "Composer bottom bar with Plan switched on, the agent's reply a plan checklist above it."
+      }
+    },
+    {
+      "id": "chat-attach-files",
+      "title": "Attach PDFs, spreadsheets and documents",
+      "body": "The paperclip, a paste or a drag takes up to 8 files a message, 25 MB each. Big photos are shrunk for you.",
+      "guide": {
+        "file": "chat"
+      },
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "clip",
+        "shot": "A PDF dragged onto the composer; its chip appears; one more pasted; send."
+      }
+    },
+    {
+      "id": "chat-slash-menu",
+      "title": "Type / for commands and skills",
+      "body": "/ in the composer lists every command and skill the agent knows, filtered as you type.",
+      "guide": {
+        "file": "chat"
+      },
+      "added": "2026-10-31",
+      "media": {
+        "kind": "video",
+        "src": "/tips/chat-slash-menu.mp4",
+        "poster": "/tips/chat-slash-menu-poster.webp",
+        "alt": "Typing a slash in the composer opens a menu of commands and skills that narrows as you type.",
+        "width": 768,
+        "height": 480,
+        "durationMs": 6367
+      }
+    },
+    {
+      "id": "chat-tab-suggestion",
+      "title": "Tab takes the suggested reply",
+      "body": "After the first turn, a guess at your next message shows in the empty composer. Tab or → takes it; typing sets it aside.",
+      "guide": {
+        "file": "chat"
+      },
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "clip",
+        "shot": "Empty composer shows a grey suggested reply; Tab fills it in."
+      }
+    },
+    {
+      "id": "chat-access-picker",
+      "title": "Choose what the agent may do",
+      "body": "The access picker under the composer has Ask first, Accept edits and Full access. Ask first shows an approval card for anything not already allowed.",
+      "guide": {
+        "file": "chat"
+      },
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "crop",
+        "shot": "The access picker open, showing Ask first, Accept edits, Full access."
+      }
+    },
+    {
+      "id": "chat-undo",
+      "title": "Undo a message and its edits",
+      "body": "Undo on a message puts back the files the agent edited since and returns the message to the composer. Shell command changes aren't tracked.",
+      "guide": {
+        "file": "chat"
+      },
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "crop",
+        "shot": "A user message with its Undo action visible on hover."
+      }
+    },
+    {
+      "id": "chat-terminal-handoff",
+      "title": "Hand a chat to the terminal",
+      "body": "The Chat / Terminal switch in the tab bar resumes the same conversation in the agent's own terminal, and back.",
+      "guide": {
+        "file": "chat"
+      },
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "clip",
+        "shot": "Click Terminal in the Chat / Terminal switch; the same conversation resumes in the terminal."
+      }
+    },
+    {
+      "id": "chat-bookmark",
+      "title": "Star a message to find it later",
+      "body": "Star a message, a step or a whole turn. The star in the chat header lists them and jumps to one.",
+      "guide": {
+        "file": "chat"
+      },
+      "when": ["no-bookmarks"],
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "crop",
+        "shot": "Chat header's star list open with three bookmarks."
+      }
+    },
+    {
+      "id": "chat-search",
+      "title": "⌘K searches every conversation",
+      "body": "Type in ⌘K for matching chats, or Tab for a full search of what you and the agents said.",
+      "guide": {
+        "file": "chat"
+      },
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "clip",
+        "shot": "⌘K, type two words, matching chats appear, Tab switches to the full search."
+      }
+    },
+    {
+      "id": "sidebar-draft",
+      "title": "⌥N opens a draft",
+      "body": "A draft in the project you're in. Nothing starts until you send, and unsent drafts wait under Drafts.",
+      "guide": {
+        "file": "sessions",
+        "anchor": "new-sessions"
+      },
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "clip",
+        "shot": "⌥N opens a draft with project, agent and worktree chips; type a line."
+      }
+    },
+    {
+      "id": "sidebar-open-pr",
+      "title": "Make a session a task",
+      "body": "Tick Open a PR when done on a draft and it runs in its own worktree and ends in a pull request.",
+      "guide": {
+        "file": "sessions",
+        "anchor": "new-sessions"
+      },
+      "added": "2026-10-31"
+    },
+    {
+      "id": "sidebar-pin",
+      "title": "Pin a session",
+      "body": "Pin in a row's ⋯ menu keeps it on the Pinned shelf, and a pinned session never settles on its own.",
+      "guide": {
+        "file": "sessions",
+        "anchor": "the-sidebar"
+      },
+      "added": "2026-10-31"
+    },
+    {
+      "id": "sidebar-snooze",
+      "title": "Snooze until tomorrow",
+      "body": "Snooze in a row's ⋯ menu hides it until 9 AM tomorrow or next Monday. It wakes early if it needs you.",
+      "guide": {
+        "file": "sessions",
+        "anchor": "the-sidebar"
+      },
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "crop",
+        "shot": "A row's ⋯ menu open on Snooze with Tomorrow and Next week."
+      }
+    },
+    {
+      "id": "sidebar-groups",
+      "title": "Put sessions in a group",
+      "body": "Move to group → New group… in a row's ⋯ menu gives them their own shelf. Select moves many at once.",
+      "guide": {
+        "file": "sessions",
+        "anchor": "groups"
+      },
+      "when": ["no-groups"],
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "screenshot",
+        "shot": "Sidebar with a named group shelf holding three sessions."
+      }
+    },
+    {
+      "id": "sidebar-load",
+      "title": "The dot that shows machine load",
+      "body": "The dot in the sidebar header turns amber or red when the machine is busy. Tap it to see which sessions use the most CPU.",
+      "guide": {
+        "file": "sessions",
+        "anchor": "machine-load"
+      },
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "crop",
+        "shot": "The machine load popover: the dot amber, the top CPU sessions listed."
+      }
+    },
+    {
+      "id": "tasks-sign-off",
+      "title": "Sign off and merge from the app",
+      "body": "Sign off & merge merges a task's PR once CI is green, then removes its worktree and branches.",
+      "guide": {
+        "file": "tasks"
+      },
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "crop",
+        "shot": "A task in review with CI green and the Sign off & merge button."
+      }
+    },
+    {
+      "id": "tasks-queue",
+      "title": "Cap how many tasks run at once",
+      "body": "Settings → Workspaces sets a running limit. Extra tasks wait under Queued and start in order.",
+      "guide": {
+        "file": "tasks"
+      },
+      "added": "2026-10-31"
+    },
+    {
+      "id": "tasks-pause",
+      "title": "Pause a task for a while",
+      "body": "A running task's row menu pauses it for an hour, until tomorrow, or until you resume it.",
+      "guide": {
+        "file": "tasks"
+      },
+      "added": "2026-10-31"
+    },
+    {
+      "id": "tasks-plan-pieces",
+      "title": "Approve a plan piece by piece",
+      "body": "A plan waiting on you lists its pieces, each with Merge into ① or Drop, and Approve with note… for the whole plan.",
+      "guide": {
+        "file": "tasks",
+        "anchor": "plans-in-pieces"
+      },
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "screenshot",
+        "shot": "A plan awaiting approval with two pieces, Merge into ① and Drop on the second."
+      }
+    },
+    {
+      "id": "tasks-linked-machines",
+      "title": "Run tasks on another machine",
+      "body": "Link a second machine and queued tasks start there when this one is busy. Linking more than one machine with Connect needs Pro.",
+      "guide": {
+        "file": "install",
+        "anchor": "with-agentos-connect-any-network-free-for-one-machine-pro-to-link-several"
+      },
+      "added": "2026-10-31"
+    },
+    {
+      "id": "tasks-stacks",
+      "title": "Run a board as a stack",
+      "body": "In a project linked to a board, Run as stack starts the cards as stacked PRs, and Land merges them in order.",
+      "guide": {
+        "file": "tasks",
+        "anchor": "stacks"
+      },
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "screenshot",
+        "shot": "A stack of three tasks with their PR states and Land."
+      }
+    },
+    {
+      "id": "schedule-first",
+      "title": "Start work on a timer",
+      "body": "Schedules in the sidebar's ⋯ menu runs a prompt every day, every few hours, or once.",
+      "guide": {
+        "file": "schedules",
+        "anchor": "schedules"
+      },
+      "when": ["no-schedules"],
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "screenshot",
+        "shot": "The Schedules form filled in: daily at 9 AM, a prompt, a project."
+      }
+    },
+    {
+      "id": "schedule-check-in",
+      "title": "Check in on a long session",
+      "body": "Schedule check-ins in a session's ⋯ menu sends it a message on a timer.",
+      "guide": {
+        "file": "schedules",
+        "anchor": "schedules"
+      },
+      "added": "2026-10-31"
+    },
+    {
+      "id": "recipe-save",
+      "title": "Save a job you'll do again",
+      "body": "Save as recipe on a finished session or task fills in a recipe from what it did. Each run starts fresh.",
+      "guide": {
+        "file": "schedules",
+        "anchor": "recipes"
+      },
+      "when": ["no-recipes"],
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "crop",
+        "shot": "The recipe form prefilled from a finished session."
+      }
+    },
+    {
+      "id": "net-peers",
+      "title": "Sessions can talk to each other",
+      "body": "Agents run aos peers to see other sessions and aos send to message one.",
+      "guide": {
+        "file": "agent-network"
+      },
+      "added": "2026-10-31"
+    },
+    {
+      "id": "net-await",
+      "title": "Wait for a reply without polling",
+      "body": "aos send <session> --await ends the agent's turn and wakes it with the answer.",
+      "guide": {
+        "file": "agent-network",
+        "anchor": "waiting-on-a-peer"
+      },
+      "added": "2026-10-31"
+    },
+    {
+      "id": "net-messages",
+      "title": "Read what your agents say to each other",
+      "body": "Messages shows every conversation between sessions, and you can join any of them.",
+      "guide": {
+        "file": "agent-network"
+      },
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "screenshot",
+        "shot": "Messages with two sessions talking, one waiting on a reply."
+      }
+    },
+    {
+      "id": "phone-pair",
+      "title": "Use AgentOS from your phone",
+      "body": "Settings → Devices & access → Add a device shows a code to scan. Each code works once.",
+      "guide": {
+        "file": "phone",
+        "anchor": "pair-the-phone"
+      },
+      "when": ["no-paired-device"],
+      "added": "2026-10-31"
+    },
+    {
+      "id": "phone-connect",
+      "title": "Reach this machine from anywhere",
+      "body": "Connect gives it a private address that works off your home network, free for one machine.",
+      "guide": {
+        "file": "phone",
+        "anchor": "from-anywhere-with-connect"
+      },
+      "when": ["connect-not-linked"],
+      "added": "2026-10-31"
+    },
+    {
+      "id": "phone-push",
+      "title": "Get pushes when an agent needs you",
+      "body": "Settings → Notifications → Your phone sends a test push to check it works.",
+      "guide": {
+        "file": "phone",
+        "anchor": "notifications"
+      },
+      "when": ["no-push-device"],
+      "added": "2026-10-31"
+    },
+    {
+      "id": "share-check",
+      "title": "Shares are masked before upload",
+      "body": "The Share dialog shows exactly what goes up, with secrets, addresses and emails masked. Nothing leaves until Create link.",
+      "guide": {
+        "file": "sharing",
+        "anchor": "check-it-first"
+      },
+      "when": ["no-shares"],
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "screenshot",
+        "shot": "The Share dialog preview with masked values highlighted, before Create link."
+      }
+    },
+    {
+      "id": "share-expiry",
+      "title": "Links can expire",
+      "body": "Create link lasts 1, 7 or 30 days, or never. Revoke one in Settings → Shared links.",
+      "guide": {
+        "file": "sharing",
+        "anchor": "create-the-link"
+      },
+      "added": "2026-10-31"
+    },
+    {
+      "id": "export-ai",
+      "title": "Hand a chat to another AI",
+      "body": "Export for AI… in the ⋯ menu saves the chat as Markdown, JSON or HTML, with secrets masked.",
+      "guide": {
+        "file": "export"
+      },
+      "added": "2026-10-31",
+      "mediaBrief": {
+        "kind": "crop",
+        "shot": "The Export for AI sheet: format, Compact selected, the size estimate."
+      }
+    },
+    {
+      "id": "export-compact",
+      "title": "Compact export for long chats",
+      "body": "Compact drops thinking and trims tool output, and the sheet warns when a file is too big for most models.",
+      "guide": {
+        "file": "export",
+        "anchor": "what-you-choose"
+      },
+      "added": "2026-10-31"
+    },
+    {
+      "id": "update-when-idle",
+      "title": "Update without interrupting work",
+      "body": "Update when idle in the update banner waits until nothing is working.",
+      "guide": {
+        "file": "install",
+        "anchor": "update-from-the-app"
+      },
+      "added": "2026-10-31"
+    },
+    {
+      "id": "tips-whats-new",
+      "title": "See what changed in each update",
+      "body": "The sparkle next to the lightbulb lists every change. A dot on it means something new since you last looked.",
+      "guide": {
+        "file": "tips",
+        "anchor": "whats-new"
+      },
+      "added": "2026-10-31"
+    }
+  ]
+}

package/content/whats-new.json

@@ -1793,6 +1793,30 @@
       "area": "Chat",
       "text": "GitHub Copilot chats can now ask you questions with clickable answer cards, like Claude chats do.",
       "url": "https://github.com/saadnvd1/agent-os/pull/530"
+    },
+    {
+      "id": 531,
+      "date": "2026-10-31",
+      "kind": "new",
+      "area": "Updates",
+      "text": "AgentOS now keeps itself up to date once nothing is working, and goes back to the previous version on its own if an update doesn't start cleanly.",
+      "url": "https://github.com/saadnvd1/agent-os/pull/531"
+    },
+    {
+      "id": 532,
+      "date": "2026-10-31",
+      "kind": "new",
+      "area": "AgentOS",
+      "text": "A lightbulb in the sidebar shows one short tip a day about a feature you may have missed, and you can turn tips off in Settings.",
+      "url": "https://github.com/saadnvd1/agent-os/pull/532"
+    },
+    {
+      "id": 533,
+      "date": "2026-10-31",
+      "kind": "fixed",
+      "area": "Chat",
+      "text": "Chats now fill the screen with earlier messages on open instead of showing a nearly empty view with a \"Show earlier messages\" button.",
+      "url": "https://github.com/saadnvd1/agent-os/pull/533"
     }
   ]
 }

package/data/tips/index.ts

@@ -0,0 +1,49 @@
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import type { TipsView } from "@/lib/tips/schema";
+
+export const tipsKeys = { all: ["tips"] as const };
+
+// The browser's own date: the tip changes at the user's midnight.
+const localDay = () => new Date().toLocaleDateString("sv");
+
+async function send(init?: { body: object }): Promise<TipsView> {
+  const res = await fetch(
+    init ? "/api/tips" : `/api/tips?day=${localDay()}`,
+    init && {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(init.body),
+    }
+  ).catch(() => {
+    throw new Error("Couldn't reach AgentOS. Try again.");
+  });
+  if (!res.ok) throw new Error(`Tips failed (${res.status})`);
+  return res.json();
+}
+
+// The tips file only changes with an update; the day can change under an open tab.
+export const useTips = () =>
+  useQuery({
+    queryKey: tipsKeys.all,
+    queryFn: () => send(),
+    staleTime: 10 * 60_000,
+    refetchOnWindowFocus: true,
+  });
+
+function useTipsMutation<V>(body: (v: V) => object) {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (v: V) => send({ body: body(v) }),
+    onSuccess: (view) => queryClient.setQueryData(tipsKeys.all, view),
+  });
+}
+
+export const useMarkTipSeen = () =>
+  useTipsMutation<string>((id) => ({
+    action: "seen",
+    ids: [id],
+    day: localDay(),
+  }));
+
+export const useSetTipsOff = () =>
+  useTipsMutation<boolean>((off) => ({ action: "off", off }));

package/data/updates/index.ts

@@ -61,3 +61,8 @@ export const useUpdateBannerSetting = () =>
   useUpdateMutation<boolean>((banner) =>
     send("PUT", "/api/updates/settings", { banner })
   );
+
+export const useAutoUpdateSetting = () =>
+  useUpdateMutation<{ auto?: boolean; idleMinutes?: number }>((patch) =>
+    send("PUT", "/api/updates/settings", patch)
+  );

package/hooks/useReloadWhenUpdated.ts

@@ -13,7 +13,11 @@ export function useReloadWhenUpdated(view: UpdateView | undefined) {
   useEffect(() => {
     if (!run) return;
     if (isActivePhase(run.phase)) watched.current = run.id;
-    else if (run.phase === "done" && watched.current === run.id)
+    // A rollback restarted the server onto the old build: reload onto it too.
+    else if (
+      (run.phase === "done" || run.phase === "rolled_back") &&
+      watched.current === run.id
+    )
       window.location.reload();
   }, [run]);
 }

package/lib/busy.ts

@@ -2,12 +2,14 @@ import { db } from "./db";
 import { runningStarts } from "./simulator";
 
 // What a restart would cut off and have to start over: reviews, task
-// setups and simulator starts run in the server. (Chat turns run in their own workers and
+// setups, simulator starts, merges and stack landings run in the server. (Chat turns run in their own workers and
 // outlive it.) Older than half an hour is stuck, not in flight.
 export function inFlight(): {
   reviews: number;
   setups: number;
   simulatorStarts: number;
+  merges: number;
+  landings: number;
 } {
   const count = (sql: string) => (db.prepare(sql).get() as { n: number }).n;
   return {
@@ -22,5 +24,25 @@ export function inFlight(): {
          AND created_at > datetime('now', '-30 minutes')`
     ),
     simulatorStarts: runningStarts(),
+    merges: mergesInFlight(),
+    landings: count(
+      `SELECT COUNT(*) AS n FROM stacks WHERE status = 'landing'`
+    ),
   };
 }
+
+// Between `gh pr merge` and the tidying after it (lib/tasks/finish.ts keeps
+// both on globalThis, so every bundle sees the same ones).
+function mergesInFlight(): number {
+  const g = globalThis as unknown as {
+    __agentosSigningOff?: Set<string>;
+    __agentosAfterMerge?: Map<string, unknown>;
+  };
+  return new Set([
+    ...(g.__agentosSigningOff ?? []),
+    ...(g.__agentosAfterMerge?.keys() ?? []),
+  ]).size;
+}
+
+export const inFlightTotal = (w: ReturnType<typeof inFlight>): number =>
+  w.reviews + w.setups + w.simulatorStarts + w.merges + w.landings;

package/lib/db/migrations.ts

@@ -26,6 +26,11 @@ export type { Migration } from "./migration-types";
 // typecheck, lint and test) and is not committed. A duplicate id or key, or a
 // file whose name does not match its id, throws when this module loads.
 // lib/db/migrations.test.ts enforces the rest.
+//
+// A migration must leave the previous release runnable: an automatic update
+// that isn't healthy rolls the code back but not the database (chat workers
+// keep writing through the restart, so a restore would drop their work). Add
+// columns and tables; don't rename or drop what the last release reads.
 
 export const migrationKey = (m: Migration): string => m.key ?? String(m.id);
 const migrationName = (m: Migration): string =>
@@ -93,6 +98,22 @@ function compareToUpTo(m: Migration, upTo: number | string): number {
 // All migrations in order - never modify existing ones, only add new
 export const migrations: Migration[] = buildRegistry(migrationFiles);
 
+/** How many of this build's migrations the database has; the update health check reads it. */
+export function migrationStatus(db: Database.Database): {
+  known: number;
+  applied: number;
+} {
+  const rows = db.prepare(`SELECT id, key FROM _migrations`).all() as {
+    id: number;
+    key: string | null;
+  }[];
+  const have = new Set(rows.map((r) => r.key ?? String(r.id)));
+  return {
+    known: migrations.length,
+    applied: migrations.filter((m) => have.has(migrationKey(m))).length,
+  };
+}
+
 // `upTo`: stop after this legacy id or timestamp key, inclusive (tests that
 // start from an older database).
 export function runMigrations(

package/lib/recipes/timer.ts

@@ -67,7 +67,9 @@ export function setTimer(
   if (!isTimezone(timezone)) throw new Error(`Unknown time zone "${timezone}"`);
   const bad = cronError(cron);
   if (bad) throw new Error(bad);
-  if (minGapMinutes(cron, timezone) < MIN_GAP_MINUTES)
+  if (
+    minGapMinutes(cron, timezone, Date.now(), MIN_GAP_MINUTES) < MIN_GAP_MINUTES
+  )
     throw new Error("A recipe runs at most once an hour");
   const enabled = input.enabled ?? true;
   if (!existing) {

package/lib/schedules/cron.ts

@@ -261,16 +261,25 @@ export const MIN_GAP_MINUTES = 60;
 // A message to a session, at most this often.
 export const MESSAGE_MIN_GAP_MINUTES = 10;
 
-// The shortest gap between runs over the next few weeks of them.
+// The shortest gap between runs over the next few weeks of them. With
+// `stopBelow`, it returns as soon as a gap under it turns up: "every minute"
+// then costs two searches, not two hundred.
 export function minGapMinutes(
   cron: string,
   timezone: string,
-  from = Date.now()
+  from = Date.now(),
+  stopBelow = 0
 ): number {
-  const runs = nextRuns(cron, from, 200, timezone);
+  const parsed = parseCron(cron);
   let min = Infinity;
-  for (let i = 1; i < runs.length; i++)
-    min = Math.min(min, (runs[i] - runs[i - 1]) / 60_000);
+  let prev = nextRun(parsed, from, timezone);
+  for (let i = 1; i < 200 && prev !== null; i++) {
+    const next = nextRun(parsed, prev, timezone);
+    if (next === null) break;
+    min = Math.min(min, (next - prev) / 60_000);
+    if (min < stopBelow) break;
+    prev = next;
+  }
   return min;
 }