thursday-agent 0.8.0 → 0.9.0

package/README.md

@@ -4,13 +4,13 @@
 
 ### Everyone wanted Friday. This is Thursday.
 
-**An open-source voice assistant that runs on your computer, with a team of AI bots behind it.**<br>
-You talk. Bots take the slow work to a real browser, a shell and your files. The conversation never stops.
+**An open-source voice assistant on GPT-Live 1 that runs on your computer, with a team of AI bots behind it.**<br>
+You talk. Bots take the slow work to a real browser, a shell and your files, and she keeps talking while they work.
 
 [![npm](https://img.shields.io/npm/v/thursday-agent?style=flat-square&color=111&label=npm)](https://www.npmjs.com/package/thursday-agent)
 [![CI](https://img.shields.io/github/actions/workflow/status/cgoinglove/thursday/ci.yml?style=flat-square&label=ci)](https://github.com/cgoinglove/thursday/actions/workflows/ci.yml)
 [![MIT](https://img.shields.io/badge/license-MIT-111?style=flat-square)](LICENSE)
-[![stars](https://img.shields.io/github/stars/cgoinglove/thursday?style=flat-square&color=111)](https://github.com/cgoinglove/thursday/stargazers)
+[![node](https://img.shields.io/node/v/thursday-agent?style=flat-square&color=111)](https://nodejs.org)
 
 [English](README.md) · [한국어](README.ko.md)
 
@@ -22,41 +22,58 @@ You talk. Bots take the slow work to a real browser, a shell and your files. The
 npx thursday-agent
 ```
 
-Paste an OpenAI API key, pick your starter bots, and say **“hey thursday.”** No account, no `.env`.
+Needs Node.js 22.18+ and one OpenAI API key, pasted into the first screen. Pick your starter bots and **tap her face**. No account, no `.env`. The voice costs about $0.05 a minute on that key.
+
+![The first run: a key, the starter bots, and one button that places the first call](docs/images/first-run.png)
+
+## Try saying
+
+- “Find me a coat under two hundred dollars and put the options on one page.”
+- “Every weekday at nine, go through my mail and draft the replies.”
+- “Remember my sister's birthday is March third.”
+- “Where is that coat job?”, while it is still running.
 
 ## Talk while it works
 
-Most agents make you type and wait. Thursday is a real-time voice call you can interrupt. Anything that takes more than a few seconds goes to a bot in the background, so the call never goes quiet, and she tells you when it's back.
+A speech model that opens a browser goes silent for a minute, and a silent call is a dead call. So Thursday splits the call in two: GPT-Live 1 holds the conversation, and anything slower than a few seconds goes to a bot in the background. Interrupt her, change the subject, or ask how the job is going.
 
-![A voice call with Thursday while a bot looks for hotels in the background](docs/images/call.png)
+![Asked how a job is going, she answers with the step the bot is on, while the call goes on](docs/images/call.png)
 
 ## One sentence, a whole team
 
 Bots hand parts of a job to each other, check what comes back, and ask you only when a decision is yours. Every handoff is saved: open the thread to see who did what, or step in.
 
-![A planner bot splits a trip request between two bots and one asks the user a question](docs/images/room.png)
+![Bots split a request, trade findings, ask the user one question, and each message becomes part of the finished page](docs/images/team.png)
 
 ## Errands, in a real browser
 
-Orders, bookings, forms, the inbox. Bots use their own browser or the Chrome you're already signed into, and ask before using a login you gave them. A purchase stops at the Pay button, left open on your screen.
+Orders, bookings, forms, the inbox. Bots use their own browser or the Chrome you're already signed into. When a site needs you, the bot opens a window, you sign in yourself, and the app keeps that sign-in for the bots you allow. A purchase stops at the Pay button, left open on your screen.
 
-![A checkout a bot filled in and left open, with the Pay button for the user to press](docs/images/errands.png)
+![A checkout a bot filled in and left open, with the Pay button left for the user to press](docs/images/errands.png)
 
 ## Results you can keep
 
 Pages, charts, videos, slides, docs and scripts, saved as files on your machine. A finished one shows up in the corner of your screen, and “show me” opens it.
 
-![Files made by six different bots: a rent chart, a short video, a carousel, a trip page, launch copy, and a script](docs/images/artifacts.png)
+![A finished page waiting in the corner of the screen while she says the job is back](docs/images/results.png)
 
 ## Your crew
 
 Pick starter bots on the first run, or make your own with a name and one sentence about what it's for. Give each its own model and tools.
 
-![A lineup of bots, each with its own face and job, plus a slot to make your own](docs/images/bots.png)
+![Picking the starter bots on the first run, each with its own face and job](docs/images/bots.png)
+
+## From your phone
+
+Write to her from Telegram, Discord or Slack while the app runs at home. A bot's question arrives as buttons, and the files she names come with her answer. Nothing on your computer is opened to the internet.
+
+![A chat with Thursday on a phone: a page sent back, and a bot's question as two buttons](docs/images/phone.png)
 
 ## And also
 
-- **Hang up, it keeps going.** Jobs run on your machine, and Thursday tells you when they finish, or calls you if you turn that on.
+- **Hang up, it keeps going.** Jobs run on your machine, and Thursday tells you when they finish, or rings your screen if you turn that on.
+- **Type instead.** Press `/` and write to her: the same memory and bots, no microphone, nothing billed by the minute.
+- **Routines.** “Every weekday at nine, go through my mail”: a bot, a job and a time, set up by saying it.
 - **Memory you can read.** What she knows about you is plain notes. Open, edit, or delete any line.
 - **Skills and MCP.** Teach bots new methods with Agent Skills, and connect any MCP server.
 - **Any model.** OpenAI, Anthropic, Google, xAI, Vercel AI Gateway, or your ChatGPT sign-in, per bot.
@@ -78,7 +95,7 @@ Thursday is free and MIT-licensed. You bring the keys: OpenAI bills the voice at
 <details>
 <summary><b>Where does my data go?</b></summary>
 
-What you say on a call and what bots work on go to the model providers you set up and the services you connect. “Hey thursday” uses your browser's speech recognition, which in Chrome sends microphone audio to Google while the app is open and no call is; switch it off in Settings › Thursday and start calls with a tap or `alt+shift+T`. The app listens only on `127.0.0.1`, and your calls, memory and files live in `~/.thursday` (or the checkout, when you run from source).
+What you say on a call and what bots work on go to the model providers you set up and the services you connect. The “hey thursday” wake phrase is off until you switch it on: it uses your browser's speech recognition, which in Chrome sends microphone audio to Google while the tab is open. A tap on her face or `alt+shift+T` starts a call without it. The app listens only on `127.0.0.1`, and your calls, memory and files live in `~/.thursday` (or the checkout, when you run from source).
 
 </details>
 
@@ -109,6 +126,6 @@ Requires pnpm 10+.
 
 **[How it works](docs/how-it-works.md)** · [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md) · [MIT](LICENSE)
 
-If you'd rather say it than type it, [star Thursday](https://github.com/cgoinglove/thursday).
+If you'd rather say it than type it, [star Thursday](https://github.com/cgoinglove/thursday). Ran it? [Tell me where it stopped](https://github.com/cgoinglove/thursday/issues/new): that list is the roadmap.
 
 </div>

package/bin/port.mjs

@@ -6,8 +6,13 @@ import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { createServer } from "node:net";
 import { join } from "node:path";
 
-/** The port when none is asked for. */
-const DEFAULT_PORT = 3000;
+/**
+ * The port when none is asked for, and so the address a first run makes home. Not 3000,
+ * the most occupied port on a developer's machine: the browser keeps the installed app,
+ * her settings and the microphone permission per address, so home is best a port nothing
+ * else comes to want later.
+ */
+const DEFAULT_PORT = 4747;
 /** How far past it to look before giving up. */
 const SEARCH = 20;
 
@@ -15,7 +20,7 @@ const SEARCH = 20;
  * Every address a holder of the port may have bound. No single probe sees them
  * all: on macOS a socket on 127.0.0.1 does not block `::`, and one on `::` does
  * not block 127.0.0.1 — yet `localhost` reaches whichever answers first, so two
- * servers "on 3000" each serve some of the page. Probed one at a time, since
+ * servers "on one port" each serve some of the page. Probed one at a time, since
  * `0.0.0.0` and `::` block each other.
  */
 const ADDRESSES = ["127.0.0.1", "::1", "0.0.0.0", "::"];
@@ -66,10 +71,9 @@ const keepPort = (home, port) => {
 };
 
 /**
- * 3000 is the most occupied port on a developer's machine. A port nobody asked
- * for is ours to move; a port that was asked for (`--port`, `PORT`) is not, and
- * saying so is more use than moving it quietly. Exits with the reason when no
- * port will do.
+ * A port nobody asked for is ours to move; a port that was asked for (`--port`,
+ * `PORT`) is not, and saying so is more use than moving it quietly. Exits with
+ * the reason when no port will do.
  */
 export async function freePort(asked, home) {
   const port = await pickPort(asked, home);

package/bin/thursday.mjs

@@ -35,7 +35,7 @@ if (has("-h", "--help")) {
     $ thursday [options]
 
   Options
-    --port <n>     Port to serve on (default 3000, or the next free one)
+    --port <n>     Port to serve on (default 4747, or the next free one)
     --home <dir>   Where your data lives (default ~/.thursday)
     --no-open      Do not open a browser
     -v, --version  Print the version

package/components/ui/radio-group.tsx

@@ -19,7 +19,7 @@ function RadioGroupItem({ className, ...props }: RadioPrimitive.Root.Props) {
     <RadioPrimitive.Root
       data-slot="radio-group-item"
       className={cn(
-        "group/radio-group-item peer relative flex aspect-square size-4 shrink-0 rounded-full border border-input outline-none group-has-[:focus-visible]/field-label:ring-0 group-has-[:focus-visible]/field-label:not-data-checked:border-input after:absolute after:-inset-x-3 after:-inset-y-2 focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 aria-invalid:aria-checked:border-brand dark:bg-input/30 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 data-checked:border-brand data-checked:bg-brand data-checked:text-brand-foreground group-has-[:focus-visible]/field-label:data-checked:border-brand dark:data-checked:bg-brand",
+        "group/radio-group-item peer relative flex aspect-square size-4 shrink-0 rounded-full border border-input outline-none group-has-[:focus-visible]/field-label:ring-0 group-has-[:focus-visible]/field-label:not-data-checked:border-input after:absolute after:-inset-x-3 after:-inset-y-2 focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 aria-invalid:aria-checked:border-primary dark:bg-input/30 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 data-checked:border-primary data-checked:bg-primary data-checked:text-primary-foreground group-has-[:focus-visible]/field-label:data-checked:border-primary dark:data-checked:bg-primary",
         className,
       )}
       {...props}
@@ -28,7 +28,7 @@ function RadioGroupItem({ className, ...props }: RadioPrimitive.Root.Props) {
         data-slot="radio-group-indicator"
         className="flex size-4 items-center justify-center"
       >
-        <span className="absolute top-1/2 left-1/2 size-2 -translate-x-1/2 -translate-y-1/2 rounded-full bg-brand-foreground" />
+        <span className="absolute top-1/2 left-1/2 size-2 -translate-x-1/2 -translate-y-1/2 rounded-full bg-primary-foreground" />
       </RadioPrimitive.Indicator>
     </RadioPrimitive.Root>
   );

package/components/ui/shiny-text.tsx

@@ -1,20 +1,18 @@
 import type { CSSProperties } from "react";
-import { cn, WAITING_INK } from "@/lib/utils";
+import { cn } from "@/lib/utils";
 
 /**
- * The resting ink, the ink under a passing band, and the band. On a light page
+ * The ink under a passing band, and the band. On a light page
  * the band moves toward the ink: a lighter band on light ground reads as the
  * words fading out. A dark band over the full muted ink barely shows there, so
  * the words under it rest lighter on a light page than they do still.
  */
 const TONES = {
   muted: {
-    rest: "text-muted-foreground",
     under: "text-muted-foreground/60 dark:text-muted-foreground",
     band: "via-foreground",
   },
   waiting: {
-    rest: WAITING_INK,
     under: "text-amber-700/60 dark:text-amber-400",
     band: "via-amber-950 dark:via-amber-100",
   },
@@ -34,33 +32,16 @@ export type ShinyTone = keyof typeof TONES;
 export function ShinyText({
   text,
   tone = "muted",
-  motion = "shine",
   speed = 2.4,
   className,
 }: {
   text: string;
   tone?: ShinyTone;
-  /** How it says it is still moving: a band crossing the words, or the words easing out and back. */
-  motion?: "shine" | "pulse";
   /** Seconds for the band to cross once. */
   speed?: number;
   className?: string;
 }) {
-  const { rest, under, band } = TONES[tone];
-  if (motion === "pulse") {
-    return (
-      <span
-        data-slot="shiny-text"
-        className={cn(
-          "inline-block max-w-full animate-pulse motion-reduce:animate-none",
-          rest,
-          className,
-        )}
-      >
-        {text}
-      </span>
-    );
-  }
+  const { under, band } = TONES[tone];
   return (
     <span
       data-slot="shiny-text"

package/docs/how-it-works.md

@@ -12,10 +12,15 @@ A call runs on two models: **GPT-Live 1** holds the conversation, and a Response
 - **Everything else goes to a bot.** She hands it over and keeps talking. A speech model that ran a browser itself would go silent for minutes.
 - **When a job comes back,** she tells you in a sentence. A file it made shows up in the corner of your screen, and a question it asks shows up as buttons.
 
-Settings › Thursday picks the voice, the backend model and its reasoning, web search, the wake word and hotkey, and whether she calls you when a job ends.
+Settings › Thursday picks the voice, the backend model and its reasoning, web search, the wake word (off until you switch it on) and hotkey, and whether she rings your screen when a job ends.
 
 The voice is billed per active minute, silence included; the backend is billed per token. Both use your OpenAI API key, not a ChatGPT subscription.
 
+## Without your voice
+
+- **Writing.** Press `/`, or the + on the pill, and type: a call in writing, with the same memory, tools and bots, no microphone, and nothing billed by the minute. It runs on a ChatGPT sign-in when you have one, else on your OpenAI key, and you can pick another model for it.
+- **From your phone.** Connect Telegram, Discord or Slack in Settings › Phone and write to her there while the app runs on your computer. The app connects out to the chat service; nothing on your computer is opened to the internet. One person is let in per service, and you allow them on the computer's screen.
+
 ## Bots
 
 ![A bot gets a shell, a real browser, skills, MCP servers, a studio and its own memory](images/machine.png)
@@ -30,9 +35,11 @@ A bot is a text model from any provider you added, with:
 - a **studio** for images, video, speech, and transcription
 - **each other**, to hand off part of a job
 
+![A thread open over the call: a planner hands work to another bot, its steps fold into tiles, and a question waits for you](images/room.png)
+
 The first run lets you pick a few starter bots; more are ready in Settings › Bots, or make your own with a name and one sentence about what it is for. That sentence is how Thursday decides who gets a job. Switch a bot off without deleting it.
 
-A job ends in the thing you asked for and a short report. Anything longer than a few lines is a file in `artifacts/`. When only you can do something — sign in, choose between two real options — the bot sets it up, asks, and waits. It never presses Pay: a purchase stops on the last screen, left open for you.
+A job ends in the thing you asked for and a short report. Anything longer than a few lines is a file in `artifacts/`. When only you can do something — sign in, choose between two real options — the bot sets it up, asks, and waits. It is told never to press Pay: a purchase stops on the last screen, left open for you. That is an instruction the model follows, not a lock ([SECURITY.md](../SECURITY.md)).
 
 Each bot keeps its own memory as files you can open from its page.
 
@@ -56,10 +63,11 @@ Open any note in Settings › Memory to see exactly what she knows. To change it
 ```text
 ~/.thursday
 ├── local.db          calls, memory, bots, jobs, keys
+├── .sign-ins/        the sites you signed in to, one file a site
 └── .ai-workspace
     ├── artifacts/    finished work, a folder per bot
     ├── projects/     code and longer-lived projects
-    ├── bots/         each bot's memory and saved sessions
+    ├── bots/         each bot's memory and its own kit
     └── .agents/      skills you installed
 ```
 

package/features/ai/components/model-browser.tsx

@@ -293,7 +293,7 @@ function ModelRow({
           <span className={cn("truncate text-[13px]", picked && "font-medium")}>
             {model.label}
           </span>
-          {picked && <Check className="size-3.5 shrink-0 text-brand" />}
+          {picked && <Check className="size-3.5 shrink-0" />}
           {model.retiring && (
             <span className="shrink-0 font-mono text-[10px] text-muted-foreground">
               retiring

package/features/ai/components/model-picker.tsx

@@ -237,7 +237,7 @@ export function ModelPicker({
                         {entry.id}
                       </span>
                     </span>
-                    {on && <Check className="size-3.5 shrink-0 text-brand" />}
+                    {on && <Check className="size-3.5 shrink-0" />}
                   </button>
                 );
               })}

package/features/ai/guide.ts

@@ -6,11 +6,12 @@ import { APP_DIR, APP_NAME, DATA_DIR, PATHS } from "@/config";
 /**
  * The app's guide for the person using it (`guide/`), which Thursday reads when an
  * answer depends on how the app works. Everything the code knows about it is in this
- * file. Four places reach it and nothing else may: boot installs it
+ * file. Five places reach it and nothing else may: boot installs it
  * (instrumentation-node), the call's backend prompt carries `guideLine`
- * (prompts/thursday.prompt), scripts/pack ships the folder, and one assertion in
- * scripts/live-session.test checks the line. Removing the feature is this file, those
- * four, the folder, and its lines in AGENTS.md.
+ * (prompts/thursday.prompt), a bot's carries `botGuideLine` (prompts/bot.prompt),
+ * scripts/pack ships the folder, and one assertion in scripts/live-session.test checks
+ * the line. Removing the feature is this file, those five, the folder, and its lines in
+ * AGENTS.md.
  */
 
 /** Ships with the app. */
@@ -37,3 +38,7 @@ export async function installGuide(): Promise<void> {
 /** What the call's backend is told about it, under its This computer chapter. */
 export const guideLine = (): string =>
   `How ${APP_NAME} works for the person using it — its screens, its settings, what it connects to, what to do when something stops — is written under \`${FOLDER}/\` here, \`index.md\` first. Read it whenever an answer depends on how the app works: what can be asked for, where something is changed, a wish that needs a setting switched on, something that stopped or was refused. Answer from it rather than from what you assume.`;
+
+/** What a bot is told about it: that it is there, for the rare job that is about the app. */
+export const botGuideLine = (): string =>
+  `How ${APP_NAME} itself works for the user — its screens and settings — is written under \`${FOLDER}/\` here, \`index.md\` first; read it only when the job is about the app.`;

package/features/ai/prompts/bot.prompt.ts

@@ -7,6 +7,7 @@ import {
   PROMPT_LINE,
   WORKSPACE_KEEP,
 } from "@/config";
+import { botGuideLine } from "@/features/ai/guide";
 import { TOOL_NAMES } from "@/features/ai/tools/tool-name";
 import { botMemoryFolder, listBotMemory } from "@/features/bot/bot.memory";
 import { listJobBots, readBotMemoryOn } from "@/features/bot/bot.query";
@@ -297,7 +298,9 @@ Your workspace, where \`${TOOL_NAMES.bash}\` runs. Everything you write goes in
 - \`${folders?.scratch ?? PATHS.scratch}/\` — this job's working material, shared by every bot on it; cleared ${Math.round(WORKSPACE_KEEP.forMs / 86_400_000)} days after the job ends.
 - \`${folders?.own ?? PATHS.bots}/\` — yours across every job you run here: what you keep for next time.
 
-Inside the workspace, set up whatever the job needs yourself; installing anything machine-wide waits for the user's yes. Never the directory above the workspace — it is the app's, not the user's; outside the workspace, only where the user pointed you.`;
+Inside the workspace, set up whatever the job needs yourself; installing anything machine-wide waits for the user's yes. Never the directory above the workspace — it is the app's, not the user's; outside the workspace, only where the user pointed you.
+
+${botGuideLine()}`;
 
 /** The other bots, used the other way from the call's roster: which part of a held job is someone else's. */
 function roster(peers: JobBot[]): string {

package/features/ai/tools/routine.tool.ts

@@ -22,7 +22,7 @@ import { isPublicError } from "@/lib/public-error";
 import { clip } from "@/lib/utils";
 
 const routineSpec = {
-  description: `Routines: work that starts by itself, each one a bot, the work and a time. List them, make one, change one, or delete one. Every start opens a thread like one started by hand; its result reaches the conversation the same way. At most ${ROUTINE.max} exist.`,
+  description: `Routines: work that starts by itself, each one a bot, the work and a time — once at a moment, a time of day on chosen days, or every few hours. List them, make one, change one, or delete one. Every start opens a thread like one started by hand; its result reaches the conversation the same way. At most ${ROUTINE.max} exist.`,
   parameters: z.object({
     action: z.enum(["list", "create", "change", "delete"]),
     routine: z
@@ -47,11 +47,17 @@ const routineSpec = {
       .describe(
         "With create: the whole of the work, handed to the bot as written every time it starts. Nobody is there then to fill in what is missing, so everything it needs goes here, in the user's own language and words. Their request, never your reading of it.",
       ),
+    at: z
+      .string()
+      .nullish()
+      .describe(
+        'Starts once, at this moment, "YYYY-MM-DD HH:MM" in the user\'s own time, then switches itself off. Count "in an hour" or "tomorrow at eight" from **Now**. Give one of `at`, `time` or `everyHours`.',
+      ),
     time: z
       .string()
       .nullish()
       .describe(
-        'Starts at this time of day, 24-hour "HH:MM" in the user\'s own time, on `days`. Give this or `everyHours`, never both.',
+        'Starts at this time of day, 24-hour "HH:MM" in the user\'s own time, on `days`. Give one of `at`, `time` or `everyHours`.',
       ),
     days: z
       .array(z.number().int().min(1).max(7))
@@ -64,7 +70,7 @@ const routineSpec = {
       .int()
       .nullish()
       .describe(
-        `Starts again this many hours after it last started, ${ROUTINE.minHours} at least. Give this or \`time\`, never both.`,
+        `Starts again this many hours after it last started, ${ROUTINE.minHours} at least. Give one of \`at\`, \`time\` or \`everyHours\`.`,
       ),
     enabled: z
       .boolean()
@@ -79,17 +85,19 @@ type Args = z.infer<typeof routineSpec.parameters>;
 
 /** The schedule the arguments spell, none when they say nothing about time, or the line that says what is wrong. */
 function scheduleOf(args: Args): RoutineSchedule | string | null {
-  if (args.time && args.everyHours)
-    return "Give `time` or `everyHours`, not both.";
-  const spelled = args.time
-    ? {
-        kind: "daily",
-        time: args.time,
-        days: args.days?.length ? args.days : [1, 2, 3, 4, 5, 6, 7],
-      }
-    : args.everyHours
-      ? { kind: "every", hours: args.everyHours }
-      : null;
+  if ([args.at, args.time, args.everyHours].filter(Boolean).length > 1)
+    return "Give one of `at`, `time` or `everyHours`, not two.";
+  const spelled = args.at
+    ? { kind: "once", at: args.at }
+    : args.time
+      ? {
+          kind: "daily",
+          time: args.time,
+          days: args.days?.length ? args.days : [1, 2, 3, 4, 5, 6, 7],
+        }
+      : args.everyHours
+        ? { kind: "every", hours: args.everyHours }
+        : null;
   if (!spelled) return null;
   const parsed = RoutineScheduleSchema.safeParse(spelled);
   return parsed.success ? parsed.data : parsed.error.issues[0].message;
@@ -148,7 +156,7 @@ export function createRoutineTools() {
 
         if (args.action === "create") {
           if (!schedule)
-            return "Say when it starts: `time` (with `days`), or `everyHours`.";
+            return "Say when it starts: `at`, `time` (with `days`), or `everyHours`.";
           const input = RoutineInputSchema.safeParse({
             bot: args.bot ?? "",
             label: args.label ?? "",
@@ -170,9 +178,13 @@ export function createRoutineTools() {
           const held = (await readKeepWorkingOn())
             ? ""
             : " As things are set, it starts only while the app is open in a tab: a time that passes with it closed starts once when it is opened again. Settings › Routines has the switch that lets work go on with the app closed.";
+          const first = whenOf(toDate(made.nextRunAt));
           return {
             ...told(made),
-            note: `${made.bot} starts "${made.label}" by itself, ${scheduleText(made.schedule)}, first ${whenOf(toDate(made.nextRunAt))}. Each start is a thread of its own, and its result reaches the conversation like any thread's.${held}`,
+            note:
+              made.schedule.kind === "once"
+                ? `${made.bot} starts "${made.label}" once, ${first}, and the routine then switches itself off. The start is a thread of its own, and its result reaches the conversation like any thread's.${held}`
+                : `${made.bot} starts "${made.label}" by itself, ${scheduleText(made.schedule)}, first ${first}. Each start is a thread of its own, and its result reaches the conversation like any thread's.${held}`,
           };
         }
 

package/features/bot/bot.runner.ts

@@ -252,7 +252,9 @@ async function drive(work: RoomWork, signal: AbortSignal) {
   await finishRoomWork(work, final.text);
   const thread = await findThread(work.threadId);
   if (thread?.status === "done") {
-    if (!(await isAnyCallLive()))
+    // With a page open the page tells it (artifact-view): a notification it shows brings
+    // Thursday forward when pressed, where the OS one opens the script runner behind it
+    if (!presence.watching && !(await isAnyCallLive()))
       desktopNotify(thread.label, thread.outcome ?? "");
     const files = await filesOnDisk(pathsIn(thread.outcome ?? ""), null);
     // A page to read leads the notice; the rest follow in the order they were written.

package/features/bot/components/bot-mark.tsx

@@ -2,6 +2,7 @@
 
 import { useEffect, useId, useMemo, useRef } from "react";
 import { createVoiceFollower, SPECTRUM_BANDS } from "@/lib/live/live.tap";
+import { cn } from "@/lib/utils";
 import {
   MARK_PAINTS,
   type MarkPaint,
@@ -17,6 +18,9 @@ const BOX = 240;
 const CENTER = BOX / 2;
 const R = 112;
 const PAD = 18; // headroom so squash/stretch and the notify ring can bleed out
+/** The waiting dot pops in rather than blinking on, the ring it cuts growing with it. */
+const NOTIFY_POP =
+  "origin-center animate-in duration-300 zoom-in-0 [transform-box:fill-box]";
 const VIEW_BOX = `${-PAD} ${-PAD} ${BOX + PAD * 2} ${BOX + PAD * 2}`;
 /** Every silhouette is resampled to this many polar points, so blending two is a plain lerp. */
 const MARK_RESOLUTION = 128;
@@ -1464,6 +1468,7 @@ export function BotMark({
                 cy={f(CENTER + Math.sin(nAngle) * cfg.notifyDist)}
                 r={cfg.notifyR + cfg.notifyRing}
                 fill="#000"
+                className={NOTIFY_POP}
               />
             )}
           </mask>
@@ -1568,7 +1573,7 @@ export function BotMark({
             cx={f(CENTER + Math.cos(nAngle) * cfg.notifyDist)}
             cy={f(CENTER + Math.sin(nAngle) * cfg.notifyDist)}
             r={cfg.notifyR}
-            className="fill-amber-600 dark:fill-amber-400"
+            className={cn("fill-amber-600 dark:fill-amber-400", NOTIFY_POP)}
           />
         )}
       </g>

package/features/bot/components/bot-setting.tsx

@@ -472,7 +472,7 @@ function SeedRows({
                 className={cn(
                   "grid size-5 shrink-0 place-items-center rounded-full transition-colors",
                   on
-                    ? "bg-brand text-brand-foreground"
+                    ? "bg-foreground text-background"
                     : "ring-1 ring-border/60 ring-inset",
                 )}
               >
@@ -1487,9 +1487,7 @@ function ToolPicker({
                         <span className="min-w-0 flex-1 truncate font-mono text-xs">
                           {tool.name}
                         </span>
-                        {isPicked && (
-                          <Check className="size-3.5 shrink-0 text-brand" />
-                        )}
+                        {isPicked && <Check className="size-3.5 shrink-0" />}
                       </CommandItem>
                     );
                   })}

package/features/bot/components/bot-tool.tsx

@@ -30,6 +30,7 @@ import type { ResultPart } from "@/features/bot/bot.schema";
 import { imagePathsIn } from "@/features/bot/components/attachments";
 import { McpMark } from "@/features/connectors/components/mcp-mark";
 import { MemoryMark } from "@/features/memory/components/memory-mark";
+import { RoutineMark } from "@/features/routine/components/routine-mark";
 import { SkillsMark } from "@/features/skills/components/skills-mark";
 import { FileLink } from "@/features/workspace/components/file-view";
 import { useServerRoute } from "@/lib/protocol/use-server-route";
@@ -83,6 +84,7 @@ const TOOL_ICONS: Partial<Record<string, LucideIcon>> = {
   [TOOL_NAMES.sign_in_use]: KeyRound,
   [TOOL_NAMES.sign_in_keep]: KeyRound,
   [TOOL_NAMES.end_call]: PhoneOff,
+  [TOOL_NAMES.routine]: RoutineMark,
 };
 
 export const toolIcon = (name: string): LucideIcon =>

package/features/bot/components/room-list.tsx

@@ -366,7 +366,13 @@ export function ThreadRow({
 
         <span className="min-w-0 flex-1">
           {(attention || isUnread(thread)) && (
-            <span className="block text-[10px] font-medium text-foreground">
+            <span
+              className={cn(
+                "block font-mono text-[10px] tracking-wide",
+                // a result is what arrived; a question keeps the muted label, its words carry the amber
+                attention ? "text-muted-foreground" : "text-brand",
+              )}
+            >
               {thread.room.questions.length
                 ? `${thread.room.questions.length === 1 ? "Question" : `${thread.room.questions.length} questions`} · ${[...new Set(thread.room.questions.map((question) => question.bot))].join(", ")}`
                 : thread.status === "waiting"
@@ -381,6 +387,8 @@ export function ThreadRow({
               className={cn(
                 "min-w-0 truncate text-[14px] leading-5 tracking-[-0.15px]",
                 attention ? "text-foreground" : "text-foreground/80",
+                // the rows that need you or are new stand out by weight, not by a heavier label
+                (attention || isUnread(thread)) && "font-medium",
               )}
             >
               {thread.label}
@@ -440,10 +448,11 @@ export function ThreadRow({
                 await answer(thread, option);
                 setSending(null);
               }}
-              className="h-7 gap-1.5 rounded-full border-border bg-background px-3 text-[12px]"
+              // what moves the job on, so blue; outlined, so a list of them does not outweigh the call
+              className="h-7 gap-1.5 rounded-full border-brand bg-background px-3 text-[12px] text-brand hover:bg-brand/8 hover:text-brand dark:border-brand dark:bg-transparent dark:hover:bg-brand/12"
             >
               {option === THREAD_CONTINUE && (
-                <ChevronsRight className="size-3.5 text-muted-foreground" />
+                <ChevronsRight className="size-3.5" />
               )}
               {option}
             </Button>