@saadnvd1/agent-os 0.3.799 → 0.3.807

package/content/tips.json

@@ -18,9 +18,13 @@
         "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."
+      "media": {
+        "kind": "image",
+        "src": "/tips/chat-plan-mode.webp",
+        "srcDark": "/tips/chat-plan-mode-dark.webp",
+        "alt": "The chat composer with Plan switched on, the agent's plan shown above it.",
+        "width": 768,
+        "height": 481
       }
     },
     {
@@ -31,9 +35,14 @@
         "file": "chat"
       },
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "clip",
-        "shot": "A PDF dragged onto the composer; its chip appears; one more pasted; send."
+      "media": {
+        "kind": "video",
+        "src": "/tips/chat-attach-files.mp4",
+        "poster": "/tips/chat-attach-files-poster.webp",
+        "alt": "Two files, a PDF and a CSV, attached to the composer as chips before sending.",
+        "width": 768,
+        "height": 480,
+        "durationMs": 7300
       }
     },
     {
@@ -48,7 +57,7 @@
         "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.",
+        "alt": "Typing a slash in the composer opens a filtered list of commands and skills.",
         "width": 768,
         "height": 480,
         "durationMs": 6367
@@ -62,9 +71,14 @@
         "file": "chat"
       },
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "clip",
-        "shot": "Empty composer shows a grey suggested reply; Tab fills it in."
+      "media": {
+        "kind": "video",
+        "src": "/tips/chat-tab-suggestion.mp4",
+        "poster": "/tips/chat-tab-suggestion-poster.webp",
+        "alt": "A grey suggested next message appears in the composer and Tab accepts it.",
+        "width": 768,
+        "height": 480,
+        "durationMs": 5233
       }
     },
     {
@@ -75,9 +89,13 @@
         "file": "chat"
       },
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "crop",
-        "shot": "The access picker open, showing Ask first, Accept edits, Full access."
+      "media": {
+        "kind": "image",
+        "src": "/tips/chat-access-picker.webp",
+        "srcDark": "/tips/chat-access-picker-dark.webp",
+        "alt": "The access picker open in the composer, listing Ask first, Accept edits and Full access.",
+        "width": 768,
+        "height": 480
       }
     },
     {
@@ -88,9 +106,13 @@
         "file": "chat"
       },
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "crop",
-        "shot": "A user message with its Undo action visible on hover."
+      "media": {
+        "kind": "image",
+        "src": "/tips/chat-undo.webp",
+        "srcDark": "/tips/chat-undo-dark.webp",
+        "alt": "The undo button on a user message in a chat transcript.",
+        "width": 768,
+        "height": 480
       }
     },
     {
@@ -101,9 +123,14 @@
         "file": "chat"
       },
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "clip",
-        "shot": "Click Terminal in the Chat / Terminal switch; the same conversation resumes in the terminal."
+      "media": {
+        "kind": "video",
+        "src": "/tips/chat-terminal-handoff.mp4",
+        "poster": "/tips/chat-terminal-handoff-poster.webp",
+        "alt": "The Chat and Terminal switch flipping a session from the chat view to its terminal.",
+        "width": 768,
+        "height": 480,
+        "durationMs": 5967
       }
     },
     {
@@ -115,9 +142,13 @@
       },
       "when": ["no-bookmarks"],
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "crop",
-        "shot": "Chat header's star list open with three bookmarks."
+      "media": {
+        "kind": "image",
+        "src": "/tips/chat-bookmark.webp",
+        "srcDark": "/tips/chat-bookmark-dark.webp",
+        "alt": "A bookmarked message with the star filled in a chat transcript.",
+        "width": 768,
+        "height": 481
       }
     },
     {
@@ -128,9 +159,14 @@
         "file": "chat"
       },
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "clip",
-        "shot": "⌘K, type two words, matching chats appear, Tab switches to the full search."
+      "media": {
+        "kind": "video",
+        "src": "/tips/chat-search.mp4",
+        "poster": "/tips/chat-search-poster.webp",
+        "alt": "The command palette searching conversations for a phrase and listing matching sessions.",
+        "width": 768,
+        "height": 480,
+        "durationMs": 8000
       }
     },
     {
@@ -142,9 +178,14 @@
         "anchor": "new-sessions"
       },
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "clip",
-        "shot": "⌥N opens a draft with project, agent and worktree chips; type a line."
+      "media": {
+        "kind": "video",
+        "src": "/tips/sidebar-draft.mp4",
+        "poster": "/tips/sidebar-draft-poster.webp",
+        "alt": "A new draft session opened from the New menu with a prompt typed into its composer.",
+        "width": 768,
+        "height": 480,
+        "durationMs": 7667
       }
     },
     {
@@ -176,9 +217,13 @@
         "anchor": "the-sidebar"
       },
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "crop",
-        "shot": "A row's ⋯ menu open on Snooze with Tomorrow and Next week."
+      "media": {
+        "kind": "image",
+        "src": "/tips/sidebar-snooze.webp",
+        "srcDark": "/tips/sidebar-snooze-dark.webp",
+        "alt": "A session row's menu open with the snooze options in the sidebar.",
+        "width": 768,
+        "height": 480
       }
     },
     {
@@ -191,9 +236,13 @@
       },
       "when": ["no-groups"],
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "screenshot",
-        "shot": "Sidebar with a named group shelf holding three sessions."
+      "media": {
+        "kind": "image",
+        "src": "/tips/sidebar-groups.webp",
+        "srcDark": "/tips/sidebar-groups-dark.webp",
+        "alt": "The sidebar with sessions grouped under a named group header.",
+        "width": 768,
+        "height": 480
       }
     },
     {
@@ -205,9 +254,13 @@
         "anchor": "machine-load"
       },
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "crop",
-        "shot": "The machine load popover: the dot amber, the top CPU sessions listed."
+      "media": {
+        "kind": "image",
+        "src": "/tips/sidebar-load.webp",
+        "srcDark": "/tips/sidebar-load-dark.webp",
+        "alt": "The sidebar load indicator showing which sessions use the most CPU and memory.",
+        "width": 768,
+        "height": 480
       }
     },
     {
@@ -218,9 +271,13 @@
         "file": "tasks"
       },
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "crop",
-        "shot": "A task in review with CI green and the Sign off & merge button."
+      "media": {
+        "kind": "image",
+        "src": "/tips/tasks-sign-off.webp",
+        "srcDark": "/tips/tasks-sign-off-dark.webp",
+        "alt": "A task in review with checks passing and a Sign off action.",
+        "width": 768,
+        "height": 480
       }
     },
     {
@@ -250,9 +307,13 @@
         "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."
+      "media": {
+        "kind": "image",
+        "src": "/tips/tasks-plan-pieces.webp",
+        "srcDark": "/tips/tasks-plan-pieces-dark.webp",
+        "alt": "A task plan split into pieces awaiting approval.",
+        "width": 768,
+        "height": 480
       }
     },
     {
@@ -274,9 +335,13 @@
         "anchor": "stacks"
       },
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "screenshot",
-        "shot": "A stack of three tasks with their PR states and Land."
+      "media": {
+        "kind": "image",
+        "src": "/tips/tasks-stacks.webp",
+        "srcDark": "/tips/tasks-stacks-dark.webp",
+        "alt": "A stack of pull requests listed in order under one stack.",
+        "width": 768,
+        "height": 480
       }
     },
     {
@@ -289,9 +354,13 @@
       },
       "when": ["no-schedules"],
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "screenshot",
-        "shot": "The Schedules form filled in: daily at 9 AM, a prompt, a project."
+      "media": {
+        "kind": "image",
+        "src": "/tips/schedule-first.webp",
+        "srcDark": "/tips/schedule-first-dark.webp",
+        "alt": "The schedule form with a prompt, a repeat interval and a time zone.",
+        "width": 768,
+        "height": 480
       }
     },
     {
@@ -314,9 +383,13 @@
       },
       "when": ["no-recipes"],
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "crop",
-        "shot": "The recipe form prefilled from a finished session."
+      "media": {
+        "kind": "image",
+        "src": "/tips/recipe-save.webp",
+        "srcDark": "/tips/recipe-save-dark.webp",
+        "alt": "The menu action that saves a conversation as a recipe.",
+        "width": 768,
+        "height": 480
       }
     },
     {
@@ -346,9 +419,13 @@
         "file": "agent-network"
       },
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "screenshot",
-        "shot": "Messages with two sessions talking, one waiting on a reply."
+      "media": {
+        "kind": "image",
+        "src": "/tips/net-messages.webp",
+        "srcDark": "/tips/net-messages-dark.webp",
+        "alt": "A session sending and receiving messages from another session.",
+        "width": 768,
+        "height": 480
       }
     },
     {
@@ -394,9 +471,13 @@
       },
       "when": ["no-shares"],
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "screenshot",
-        "shot": "The Share dialog preview with masked values highlighted, before Create link."
+      "media": {
+        "kind": "image",
+        "src": "/tips/share-check.webp",
+        "srcDark": "/tips/share-check-dark.webp",
+        "alt": "The share dialog preview showing secrets, addresses and emails masked.",
+        "width": 768,
+        "height": 481
       }
     },
     {
@@ -417,9 +498,13 @@
         "file": "export"
       },
       "added": "2026-10-31",
-      "mediaBrief": {
-        "kind": "crop",
-        "shot": "The Export for AI sheet: format, Compact selected, the size estimate."
+      "media": {
+        "kind": "image",
+        "src": "/tips/export-ai.webp",
+        "srcDark": "/tips/export-ai-dark.webp",
+        "alt": "The export menu with an option to copy the conversation for another AI.",
+        "width": 768,
+        "height": 481
       }
     },
     {

package/content/whats-new.json

@@ -1817,6 +1817,38 @@
       "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"
+    },
+    {
+      "id": 536,
+      "date": "2026-10-31",
+      "kind": "new",
+      "area": "AgentOS",
+      "text": "Tip of the Day now shows pictures and short clips that demonstrate each tip.",
+      "url": "https://github.com/saadnvd1/agent-os/pull/536"
+    },
+    {
+      "id": 537,
+      "date": "2026-10-31",
+      "kind": "new",
+      "area": "AgentOS",
+      "text": "Chats now reopen where you left off, with back and forward buttons, a quick chat switcher and a keyboard shortcuts list.",
+      "url": "https://github.com/saadnvd1/agent-os/pull/537"
+    },
+    {
+      "id": 539,
+      "date": "2026-10-31",
+      "kind": "fixed",
+      "area": "AgentOS",
+      "text": "Holding Shift with a letter no longer triggers the shortcut meant for that letter on its own.",
+      "url": "https://github.com/saadnvd1/agent-os/pull/539"
+    },
+    {
+      "id": 541,
+      "date": "2026-10-31",
+      "kind": "new",
+      "area": "Chat",
+      "text": "Pressing Esc now takes you out of the message box when there is nothing else for it to do.",
+      "url": "https://github.com/saadnvd1/agent-os/pull/541"
     }
   ]
 }

package/data/chat-views/index.ts

@@ -0,0 +1,2 @@
+export * from "./keys";
+export * from "./queries";

package/data/chat-views/keys.ts

@@ -0,0 +1,3 @@
+export const chatViewKeys = {
+  all: ["chat-views"] as const,
+};

package/data/chat-views/queries.ts

@@ -0,0 +1,34 @@
+import { useQuery } from "@tanstack/react-query";
+import type { ChatView, ChatViewInput } from "@/lib/chat-views/types";
+import { chatViewKeys } from "./keys";
+
+export type { ChatView } from "@/lib/chat-views/types";
+
+/** Where each chat was last read and when, newest first. Another device's
+ * reading shows up when this tab is focused again. */
+export function useChatViews() {
+  return useQuery({
+    queryKey: chatViewKeys.all,
+    queryFn: async (): Promise<ChatView[]> => {
+      const res = await fetch("/api/chat-views");
+      if (!res.ok) throw new Error("Failed to fetch chat views");
+      return (await res.json()).views;
+    },
+    staleTime: 30_000,
+    refetchOnWindowFocus: true,
+  });
+}
+
+/** Saves where the reader is, or (null) that they just opened the chat.
+ * keepalive lets it finish while the page unloads. */
+export function saveChatView(
+  sessionId: string,
+  input: (Omit<ChatViewInput, "advance"> & { advance?: boolean }) | null
+): void {
+  void fetch(`/api/chat-views/${encodeURIComponent(sessionId)}`, {
+    method: "PUT",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(input ?? { viewed: true }),
+    keepalive: true,
+  }).catch(() => {});
+}

package/data/sessions/pin.ts

@@ -1,5 +1,4 @@
 import { useMutation, useQueryClient } from "@tanstack/react-query";
-import type { Session } from "@/lib/db";
 import { sessionKeys } from "./keys";
 import type { SessionsResponse } from "./queries";
 

package/hooks/useChatViewsSync.ts

@@ -0,0 +1,12 @@
+import { useEffect } from "react";
+import { useChatViews } from "@/data/chat-views";
+import { chatPositionsActions } from "@/stores/chatPositions";
+
+/** Hands the server's reading positions to the page; chats wait for them to open where they were left. */
+export function useChatViewsSync(): void {
+  const { data, isError } = useChatViews();
+  useEffect(() => {
+    if (data) chatPositionsActions.hydrate(data);
+    else if (isError) chatPositionsActions.giveUp();
+  }, [data, isError]);
+}

package/hooks/useNavActions.ts

@@ -0,0 +1,104 @@
+"use client";
+
+import { Keyboard, MessageSquare, Repeat } from "lucide-react";
+import type { Session } from "@/lib/db";
+import { chordHint } from "@/lib/keybindings/chord";
+import { keysOf } from "@/lib/keybindings/keymap";
+import { previousChatId } from "@/lib/nav/recent";
+import { useNavKeys, useSingleKeys } from "@/hooks/useNavKeys";
+import { usePaletteCommands } from "@/hooks/usePaletteCommands";
+import { bookmarksUiActions } from "@/stores/bookmarksUi";
+import { chatOpened } from "@/stores/chatPositions";
+import { newDraft } from "@/stores/drafts";
+import { inboxUiActions } from "@/stores/inboxUi";
+import { paletteActions, paletteUi } from "@/stores/palette";
+import { settingsUiActions } from "@/stores/settingsUi";
+import { shortcutsUiActions } from "@/stores/shortcutsUi";
+
+/** The chats ⌘P, O C and the like switch between, as the palette's Sessions tab. */
+function openSwitcher() {
+  if (paletteUi.open && paletteUi.tab === "sessions")
+    return paletteActions.setOpen(false);
+  paletteActions.open();
+  paletteActions.setTab("sessions");
+}
+
+/**
+ * What each shortcut in keymap.ts does, and the palette commands that go
+ * with them. Opening a chat goes through `select`, so history, position and
+ * the address follow as they do for a click.
+ */
+export function useNavActions({
+  sessions,
+  activeSessionId,
+  select,
+}: {
+  sessions: Session[];
+  activeSessionId: string | null | undefined;
+  select: (session: Session) => void;
+}) {
+  const [singles, setSingles] = useSingleKeys();
+  const previous = () => {
+    const open = sessions.filter((s) => !s.archived_at);
+    const id = previousChatId(
+      open.map((s) => s.id),
+      chatOpened,
+      activeSessionId
+    );
+    const session = open.find((s) => s.id === id);
+    if (session) select(session);
+  };
+  const actions = {
+    "palette.open": () =>
+      paletteUi.open ? paletteActions.setOpen(false) : paletteActions.open(),
+    "switcher.open": openSwitcher,
+    "chat.open": openSwitcher,
+    "chat.previous": previous,
+    "chat.new": () => newDraft({ kind: "current" }),
+    "go.inbox": () => inboxUiActions.open(),
+    "go.messages": () => inboxUiActions.open("messages"),
+    "go.bookmarks": () => bookmarksUiActions.open(activeSessionId ?? null),
+    "go.settings": () => settingsUiActions.open(),
+    "help.open": shortcutsUiActions.open,
+  };
+  useNavKeys(actions);
+  usePaletteCommands("nav", [
+    {
+      id: "nav.switch",
+      title: "Switch chat",
+      group: "Go to",
+      hint: chordHint(keysOf("switcher.open")),
+      keywords: ["recent", "open chat", "session", "switcher"],
+      icon: MessageSquare,
+      run: openSwitcher,
+    },
+    {
+      id: "nav.previous",
+      title: "Previous chat",
+      group: "Go to",
+      hint: "G P",
+      keywords: ["flip", "alternate", "last", "back"],
+      icon: Repeat,
+      run: previous,
+    },
+    {
+      id: "nav.shortcuts",
+      title: "Keyboard shortcuts",
+      group: "Go to",
+      hint: "?",
+      keywords: ["keys", "help", "hotkeys"],
+      icon: Keyboard,
+      run: shortcutsUiActions.open,
+    },
+    {
+      id: "nav.single-keys",
+      title: singles
+        ? "Turn off single-key shortcuts"
+        : "Turn on single-key shortcuts",
+      group: "Settings",
+      keywords: ["keyboard", "letters", "vim", "linear"],
+      icon: Keyboard,
+      run: () => setSingles(!singles),
+    },
+  ]);
+}

package/hooks/useNavKeys.ts

@@ -0,0 +1,105 @@
+"use client";
+
+import { useEffect, useRef } from "react";
+import { useKeybindings } from "@/hooks/useKeybindings";
+import { useStoredFlag } from "@/hooks/useStoredFlag";
+import { isFreeTarget } from "@/lib/keybindings/focus";
+import { KEYMAP, isSequence, keysOf } from "@/lib/keybindings/keymap";
+import {
+  SEQUENCE_MS,
+  SequenceMatcher,
+  plainKey,
+} from "@/lib/keybindings/sequence";
+import { shortcutsUiActions } from "@/stores/shortcutsUi";
+
+export const SINGLE_KEYS_FLAG = "agentos-single-key-shortcuts";
+
+/** The single-key shortcuts' on/off switch, kept per browser. */
+export const useSingleKeys = () => useStoredFlag(SINGLE_KEYS_FLAG, true);
+
+export type NavActions = Record<string, () => void>;
+
+const SEQUENCES = Object.fromEntries(
+  KEYMAP.filter((k) => k.single && isSequence(k.keys)).map((k) => [
+    k.keys,
+    k.id,
+  ])
+);
+const BARE = Object.fromEntries(
+  KEYMAP.filter((k) => k.single && !isSequence(k.keys)).map((k) => [
+    k.keys,
+    k.id,
+  ])
+);
+
+const CHORD_IDS = ["switcher.open", "palette.open"];
+
+const dialogOpen = () =>
+  !!document.querySelector('[role="dialog"][data-state="open"]');
+
+/**
+ * The app's keys by id (see keymap.ts): chords through the registry, bare
+ * keys and two-key sequences here, only while nothing is being typed into
+ * and the single-key switch is on.
+ */
+export function useNavKeys(actions: NavActions) {
+  const latest = useRef(actions);
+  useEffect(() => {
+    latest.current = actions;
+  });
+  const run = (id: string) => latest.current[id]?.();
+  const [singles] = useSingleKeys();
+  const singlesOn = useRef(singles);
+  useEffect(() => {
+    singlesOn.current = singles;
+  });
+
+  // The sidebar's ⌘↑/⌘↓ are bound by useSessionSwitching, from the same table.
+  useKeybindings(
+    "nav",
+    CHORD_IDS.map((id) => ({ id, keys: keysOf(id), run: () => run(id) }))
+  );
+
+  useEffect(() => {
+    const matcher = new SequenceMatcher(SEQUENCES);
+    let timer: ReturnType<typeof setTimeout> | undefined;
+    const clear = () => {
+      clearTimeout(timer);
+      matcher.reset();
+      shortcutsUiActions.setPending(null);
+    };
+    const onKey = (e: KeyboardEvent) => {
+      if (!singlesOn.current) return clear();
+      if (e.metaKey || e.ctrlKey || e.altKey || e.isComposing) return clear();
+      if (!isFreeTarget(e.target) || dialogOpen()) return clear();
+      if (e.key === "Escape") return clear();
+      if (e.key === "Shift") return;
+      const bare = plainKey(e.key, e.shiftKey);
+      if (bare === null) return clear();
+      const waiting = matcher.pending() !== null;
+      const step = matcher.feed(bare);
+      if (step.kind === "match") {
+        e.preventDefault();
+        clear();
+        run(step.id);
+      } else if (step.kind === "pending") {
+        e.preventDefault();
+        shortcutsUiActions.setPending(step.first);
+        clearTimeout(timer);
+        timer = setTimeout(clear, SEQUENCE_MS);
+      } else {
+        clear();
+        const id = BARE[bare.toLowerCase()];
+        if (id && !waiting && !e.repeat) {
+          e.preventDefault();
+          run(id);
+        }
+      }
+    };
+    window.addEventListener("keydown", onKey, true);
+    return () => {
+      window.removeEventListener("keydown", onKey, true);
+      clear();
+    };
+  }, []);
+}