@saadnvd1/agent-os 0.3.794 → 0.3.807

package/content/tips.json

@@ -0,0 +1,541 @@
+{
+  "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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 filtered list of commands and skills.",
+        "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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",
+      "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
+      }
+    },
+    {
+      "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,62 @@
       "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"
+    },
+    {
+      "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";