@stevecastaneda/paseo-progress 1.3.1 → 1.5.0

package/OVERVIEW.md

@@ -2,7 +2,7 @@ Progress gives each worktree a live dashboard for long agent jobs. The agent rec
 
 The panel shows how much of the estimated work is done, what the agent is doing right now, and where each ticket stands. A ticket turns stuck when it's blocked or runs past its estimate without an update. Press a ticket to see its timeline, activity, questions and deliverables. Images, videos and text files the agent records open in a preview inside Paseo, and a folder opens as a list of its files. Videos play only in the desktop app. Any other file opens in an app on the computer running the Paseo daemon, and so does a previewed file when you press Open. Open is hidden when that computer can't open files, like a Linux server with no desktop. That's true from your phone too. The app opens on that computer, not on the phone.
 
-When the agent needs a decision, it asks a numbered question with lettered options and says which one it recommends. A pill above the message box counts open questions and stuck work. Each option has a Copy button. Paste the answer into the chat and the agent records it.
+When the agent needs a decision, it asks a numbered question with lettered options and says which one it recommends. A pill above the message box counts open questions and stuck work. Each option has a Copy button. Paste the answer into the chat and the agent records it. In Settings you choose what the agent does while it waits: stop, work around the question, or keep building on its recommendation.
 
 Nothing updates unless the agent runs the command, so agents need the plugin's skill. The panel has two setup buttons, and each one shows where it will write before you press it:
 

package/README.md

@@ -13,12 +13,14 @@ The dashboard shows:
 - percent of estimated work done, time done of time estimated (like "1h 30m of 2h"; once everything is done, how long it really took), and a bar with one segment per ticket
 - **Stuck:** blocked tickets, working tickets with no update for longer than their estimate, and blockers the agent flags
 - **Tickets:** estimate, status, and the working ticket's stage. A ticket that waits for another (`--waits-for T03`) shows "Waits for Ticket 03" under its title until that one is done; waiting is the order of work, so it never counts as stuck, even if the agent also marked it blocked. Press a ticket for its story in a dialog. A summary on top shows its status and stage, time worked against the estimate as a bar that turns red past it, the agent's latest status line while it's working, and the agent on it. Tabs below hold the rest, each only when it has something: the ticket's write-up when it has a `--source` file (the start of it, with the rest a press away), a timeline of its stages and statuses with how long each took, and the activity, questions and deliverables that belong to it. The agent on a ticket shows by its chat title; pressing it opens that chat. Items tagged with `--ticket` belong exactly; older, untagged ones are matched by when they happened and marked "by time"
-- **Questions:** each with a permanent reference (Q1, Q2, ...), lettered options, and the option the agent recommends. The agent builds nothing a question affects until you answer; it works on other things meanwhile, and stops when nothing else is left. Press a question to open it in a dialog, then press **Copy Q2 B** to copy `Q2 (title): B` for your reply. Files and links the agent attached (`--file`) open like deliverables: images, videos and text files preview in Paseo (with **Back** to the question), a folder lists its files there, links open in Paseo's browser, and other files open in their default app. From the pill's popover, the preview opens over the popover, which stays open so you can go back to it. Answers stay listed under the same reference.
+- **Questions:** each with a permanent reference (Q1, Q2, ...), lettered options, and the option the agent recommends. You pick what the agent does while you decide in Paseo's Settings (Settings, Plugins, Progress, Settings). **Stop**: it stops all work until you answer. **Work around**, the default: it holds what your answer affects and keeps working on the rest. **Keep building**: it builds its recommendation and changes course if you pick another, except for big questions, which wait. A question is big when building ahead would send something off your computer, when the answer sets something people or programs outside the repo rely on, or when most of the remaining work would be built on it. Each open question shows what the agent is doing: "Agent stopped until you answer", "Waiting for you" (with the reason when it's big), or "Building with B: <its label>". Press a question to open it in a dialog, then press **Copy Q2 B** to copy `Q2 (title): B` for your reply. Files and links the agent attached (`--file`) open like deliverables: images, videos and text files preview in Paseo (with **Back** to the question), a folder lists its files there, links open in Paseo's browser, and other files open in their default app. From the pill's popover, the preview opens over the popover, which stays open so you can go back to it. Answers stay listed under the same reference.
 - **Activity**, **Answered** questions and **Deliverables** (press one to open it), sharing one card with a tab for each; the panel remembers the tab you picked. Each shows the newest 10, with **Show 10 older** below
 
 <img src="images/2-ticket.png" alt="A ticket's story: its status, time against the estimate, the agent on it, and its timeline" width="400"> <img src="images/3-question.png" alt="A question waiting for an answer, with lettered options, the agent's recommendation and Copy buttons" width="400">
 
-The panel lives in Explorer, beside the agent chat, so you can watch both. Open it from Command Center with **Open Progress**. When questions are waiting or something is stuck, a pill above the message box says so, for example `3 questions`. With something stuck too, it shortens to `3Q · 1 stuck` to fit. Pressing it opens a popover with each open question, its choices and their Copy buttons, and what is stuck, so you can answer without leaving the chat. **Open Progress** at the bottom opens the panel in Explorer.
+<img src="images/5-settings.png" alt="The Questions setting in Paseo's Settings, set to Work around" width="600">
+
+The panel lives in Explorer, beside the agent chat, so you can watch both. Open it from Command Center with **Open Progress**. The cog at the top right of the panel opens the plugin's Settings. After an update, the panel shows what's new in that version once. When questions are waiting or something is stuck, a pill above the message box says so, for example `3 questions`. With something stuck too, it shortens to `3Q · 1 stuck` to fit. Pressing it opens a popover with each open question, its choices and their Copy buttons, and what is stuck, so you can answer without leaving the chat. **Open Progress** at the bottom opens the panel in Explorer.
 
 <img src="images/4-pill.png" alt="The pill above the message box, showing two questions waiting" width="600">
 
@@ -56,6 +58,14 @@ The command, and **Install skill** in the panel, look for Paseo's own command in
 
 Setting `PASEO_PROGRESS_PLUGIN_DIR` to a plugin folder makes the command run that copy without asking Paseo. Use it only for testing, because an installed plugin's folder changes with every update.
 
+## Language
+
+Progress comes in English and Simplified Chinese. To pick one, open the cog in the Progress panel and choose **Display → Language**. **System** follows each device's language and falls back to English for anything other than Simplified Chinese, so Traditional Chinese stays in English for now.
+
+The choice is saved on the Paseo host, so every device connected to it shows the same language. Progress can't follow Paseo's own language setting, because Paseo doesn't share it with plugins. Open dialogs and pills switch as soon as you change it. The **Progress** name and its **Open Progress** and **Settings** entries stay in English.
+
+Progress translates its own labels, not what agents write. Titles, questions, choices, stages, notes, item labels like `Ticket`, file paths and release notes stay as written, and so do error messages from the host. The `paseo-progress` command and the reply you copy for an agent stay in English too.
+
 ## Where progress is kept
 
 Each worktree's progress lives outside the repo, in its own folder under `~/.local/state/paseo-progress/` on the daemon host. There's nothing to set up and nothing to hide: git never sees these files, and the plugin never edits a `.gitignore` or git's exclude file. The panel's empty state shows the exact path.
@@ -72,7 +82,7 @@ Earlier versions kept progress in `.scratch/` in each worktree, hidden by a `.sc
 
 ## Agent skill
 
-The plugin ships an agent skill, `paseo-progress`, that tells agents when to run each command during a multi-ticket job: set up the run, move tickets through their stages, ask questions without stopping, flag stuck work, and finish. Press **Install skill** in the Progress panel. It links `paseo-progress` into `~/.agents/skills`, `~/.claude/skills`, and `~/.codex/skills` (the folders Paseo installs its own skills into), pointing at the copy of the plugin Paseo runs, so plugin updates reach agents. On Windows the links are junctions, which don't need admin rights or Developer Mode. If Paseo later runs the plugin from somewhere else, the button changes to **Update skill**. It never replaces a skill it didn't link; that folder is skipped.
+The plugin ships an agent skill, `paseo-progress`, that tells agents when to run each command during a multi-ticket job: set up the run, move tickets through their stages, ask questions, and finish. It stays short and leaves the details to `paseo-progress --help`. Press **Install skill** in the Progress panel. It links `paseo-progress` into `~/.agents/skills`, `~/.claude/skills`, and `~/.codex/skills` (the folders Paseo installs its own skills into), pointing at the copy of the plugin Paseo runs, so plugin updates reach agents. On Windows the links are junctions, which don't need admin rights or Developer Mode. If Paseo later runs the plugin from somewhere else, the button changes to **Update skill**. It never replaces a skill it didn't link; that folder is skipped.
 
 From a terminal instead:
 
@@ -108,7 +118,8 @@ paseo-progress finish "Snapshots ship for all four tables"
 - Statuses are `not_started`, `working`, `blocked`, `done`, and `skipped`. Skipped tickets leave the totals.
 - `ticket add` and `ticket update` take an optional `--source <path or link>[=<label>]`: where the ticket is written up, like its spec file or issue. It shows under the ticket's status in its dialog and opens like a deliverable. `--source ""` clears it. Tickets without one are fine.
 - A working ticket is stuck once it goes longer than its estimate without an update, timed from its last status, stage or note change, or activity tagged to it. The ticket's dialog still shows total time worked against the estimate.
-- `question ask` needs `--recommend`, the agent's pick. The question dialog tags that option "Recommended".
+- `question ask` needs `--recommend`, the agent's pick. The question dialog tags that option "Recommended". Its output tells the agent the question mode and what to do until the answer. `--big "<why>"` marks a big question, which waits for the answer even in Keep building. `start` and `show` also print the mode.
+- Paseo keeps the question mode in its own settings, which only the plugin's server can read, so the server copies it to `~/.local/state/paseo-progress/settings.json` for the command. Without that file, for example while the plugin is off, the command uses Work around.
 - Deliverable paths are stored relative to the worktree root. Web links open in Paseo's browser. Pressing an image (PNG, JPEG, GIF, WebP, up to 10 MB) or text deliverable (Markdown, text, logs, JSON, YAML, CSV; the first 256 KB) previews it in a dialog inside Paseo, which also works from a phone; **Open** there opens the file in its default app. **Open** shows only when the computer running Paseo can open files. A Linux server with no desktop can't, so there a file Paseo can't preview copies its path and says why. A video (MP4, MOV, WebM, up to 200 MB) plays in the same dialog in the desktop app. When there are several files, **Previous** and **Next** step through them, and so do the left and right arrow keys. Pressing a folder lists its files in the same dialog. Press a file to preview it, or a folder inside to list that one, and **Back** returns to the list. Pressing any other local deliverable opens it with its default app on the machine running the Paseo daemon (for example HTML in your browser). On macOS, **Open** sends text files to your default browser. Only recorded deliverables inside the worktree open this way; otherwise the path is copied. The copy icon on each row copies the path.
 - Several agents can share one run. When another session adds a ticket, each agent sees it at the end of its next command's output (and in `show`), and the skill has it work that ticket in order after its current one. An agent only hears about tickets added since its own last update in the run, and only once.
 - Subagents record their own progress. Since Paseo 0.11, an agent waiting on background subagents shows as idle, so only the subagents' updates show the work is still going. The skill has the agent give each subagent the worktree path and ticket id, and the subagent records its stages and a ticker line on that worktree's dashboard.
@@ -134,6 +145,19 @@ The progress file, `progress.jsonl`, holds one JSON event per line, each with a
 
 ## Changelog
 
+### 1.5.0
+
+- [New] **Simplified Chinese.** Progress now comes in English and Simplified Chinese. Pick one under Display in Progress settings, or let it follow each device's language. Thanks to @xzthemeofsss for the translation.
+
+### 1.4.0
+
+- [New] **Choose what agents do while a question waits.** Open Settings with the cog at the top right of the Progress panel. **Stop** halts all work until you answer. **Work around**, the default, holds only what your answer affects, which is how questions already worked. **Keep building** builds the agent's pick and changes course if you choose another.
+- [New] **Big questions always wait.** In Keep building, the agent still waits when building ahead would send something off your computer, set something people outside the repo rely on, or carry most of the remaining work. The question says which.
+- [Improved] **Every open question shows what the agent is doing.** It reads "Agent stopped until you answer", "Waiting for you", or "Building with B" and the name of option B.
+- [Improved] **A shorter agent skill.** It's about half as long, and agents get the rule for your mode each time they ask.
+- [New] **What's new, once per update.** After an update, a banner in the panel shows that version's changes. Closing it hides it until the next version.
+- [Fixed] **Bold text in ticket write-ups.** Words marked bold in a ticket's write-up used to show as plain text.
+
 ### 1.3.1
 
 - Progress works on Windows (#84). Before, `paseo-progress` stopped with "The progress plugin is not installed in Paseo", and **Install skill** couldn't find the plugin. On Windows, Paseo's command is `paseo.cmd`, and Node can start a `.cmd` file only through cmd. Both now go through cmd on Windows, and both also check where Paseo installs its command.

package/client/attachments.tsx

@@ -6,6 +6,7 @@ import { type Attachment, attachmentIcon, canPreview, shortName } from "../share
 import { errorText } from "./errors";
 import { PressableRow } from "./row";
 import { openDeliverable } from "../shared/rpc";
+import { useProgressLanguage } from "./language";
 
 export { type Attachment, attachmentIcon, deliverableAttachment, questionAttachments, shortName, ticketSourceAttachment } from "../shared/attachments";
 
@@ -31,22 +32,23 @@ export function useAttachmentOpener({ workspaceId, workspaceDirectory, navigatio
   navigation?: Navigation;
   onPreview?(attachment: Attachment): void;
 }) {
+  const { messages: m } = useProgressLanguage();
   const toast = useToast();
   const openOnHostRpc = useRpc(openDeliverable);
   async function copyPath(attachment: Attachment, prefix = "") {
     try {
       await copyText(absolutePath(attachment.path!, workspaceDirectory));
-      toast.show(`${prefix}Copied path`, { variant: prefix ? "warning" : "success" });
+      toast.show(`${prefix}${m.copyPathDone}`, { variant: prefix ? "warning" : "success" });
     } catch {
-      toast.error("Could not copy. Select the path and use Copy.");
+      toast.error(m.copyPathFailure);
     }
   }
   async function openOnHost(attachment: Attachment) {
     try {
       await openOnHostRpc({ workspaceId, workspaceDirectory, ref: attachment.ref });
-      toast.show(`Opened ${attachment.title}`, { variant: "success" });
+      toast.show(m.opened(attachment.title), { variant: "success" });
     } catch (error) {
-      await copyPath(attachment, `${errorText(error, "Could not open it")}. `);
+      await copyPath(attachment, `${errorText(error, m.openFailure)}. `);
     }
   }
   async function open(attachment: Attachment) {
@@ -55,7 +57,7 @@ export function useAttachmentOpener({ workspaceId, workspaceDirectory, navigatio
         if (navigation?.openBrowser) navigation.openBrowser({ url: attachment.url, workspaceId });
         else await openExternalUrl(attachment.url);
       } catch {
-        toast.error("Could not open this link.");
+        toast.error(m.linkFailure);
       }
       return;
     }
@@ -74,11 +76,12 @@ export const ATTACHMENT_ROW = { gap: 2, paddingVertical: 3, lineHeight: 17 };
 // Drawn in dialogs and the popover (surface1) unless `onSurface1` is false.
 // `onOpen` also gets the whole list, so a preview can step through its siblings.
 export function AttachmentList({ colors, attachments, onOpen, onSurface1 = true }: { colors: Colors; attachments: Attachment[]; onOpen(attachment: Attachment, group: Attachment[]): void; onSurface1?: boolean }) {
+  const { messages: m } = useProgressLanguage();
   if (!attachments.length) return null;
   return (
     <View style={{ gap: ATTACHMENT_ROW.gap }}>
       {attachments.map((attachment) => (
-        <PressableRow key={attachment.ref} colors={colors} onSurface1={onSurface1} accessibilityRole={attachment.url ? "link" : "button"} accessibilityLabel={`Open ${attachment.title}`}
+        <PressableRow key={attachment.ref} colors={colors} onSurface1={onSurface1} accessibilityRole={attachment.url ? "link" : "button"} accessibilityLabel={m.openItem(attachment.title)}
           onPress={() => onOpen(attachment, attachments)}
           style={{ flexDirection: "row", gap: 6, alignItems: "center", paddingVertical: ATTACHMENT_ROW.paddingVertical, paddingHorizontal: 4, marginHorizontal: -4, borderRadius: 4 }}>
           {/* A 14px slot, like a section icon, so the title lines up with the heading above. */}

package/client/deliverables.tsx

@@ -4,12 +4,13 @@ import React, { useState } from "react";
 import { Text, View } from "react-native";
 import type { Deliverable } from "../shared/dashboard";
 import { type Attachment, attachmentIcon, deliverableAttachment, shortName, useAttachmentOpener } from "./attachments";
-import { formatAgo } from "../shared/format";
+import { formatClientAgo } from "./i18n";
 import { PressScale } from "./motion";
 import { StackedDialog } from "./dialog-stack";
 import { galleryFiles } from "./preview";
 import { PressableRow } from "./row";
 import { ShowMoreRow, usePaged } from "./show-more";
+import { useProgressLanguage } from "./language";
 
 export { absolutePath } from "./attachments";
 
@@ -25,6 +26,7 @@ export function DeliverablesList({ colors, deliverables, now, workspaceId, works
   workspaceDirectory: string;
   navigation: Navigation;
 }) {
+  const { messages: m, locale } = useProgressLanguage();
   const [previewing, setPreviewing] = useState<Attachment | null>(null);
   const { open, copyPath } = useAttachmentOpener({ workspaceId, workspaceDirectory, navigation, onPreview: setPreviewing });
   const paged = usePaged(deliverables);
@@ -32,7 +34,7 @@ export function DeliverablesList({ colors, deliverables, now, workspaceId, works
     <View>
       {paged.shown.map((deliverable, index) => (
         <PressableRow key={deliverable.id} colors={colors} accessibilityRole={deliverable.url ? "link" : "button"}
-          accessibilityLabel={`Open ${deliverable.title}`}
+          accessibilityLabel={m.openItem(deliverable.title)}
           onPress={() => void open(deliverableAttachment(deliverable))}
           style={{ flexDirection: "row", gap: 8, paddingHorizontal: 10, paddingVertical: 8, borderTopWidth: index ? 1 : 0, borderTopColor: colors.border }}>
           {/* Optical: centers the 14px icon on the 18px title line. */}
@@ -42,12 +44,12 @@ export function DeliverablesList({ colors, deliverables, now, workspaceId, works
             <Text numberOfLines={3} style={{ color: colors.foreground, fontSize: 13, lineHeight: 18 }}>{deliverable.title}</Text>
             {/* Just the name, ticket and age. The full path is one press of Copy away. */}
             <Text numberOfLines={1} style={{ color: colors.foregroundMuted, fontSize: 12, lineHeight: 17 }}>
-              {[shortName(deliverableAttachment(deliverable)), deliverable.ticketLabel ?? deliverable.ticketId, formatAgo(deliverable.addedAt, now)].filter(Boolean).join(" · ")}
+              {[shortName(deliverableAttachment(deliverable)), deliverable.ticketLabel ?? deliverable.ticketId, formatClientAgo(locale, deliverable.addedAt, now)].filter(Boolean).join(" · ")}
             </Text>
           </View>
           {deliverable.path ? (
             // Optical: the 22px button centers on the 18px title line.
-            <PressScale accessibilityRole="button" accessibilityLabel={`Copy the path of ${deliverable.title}`} hitSlop={6} outerStyle={{ marginTop: -2 }}
+            <PressScale accessibilityRole="button" accessibilityLabel={m.copyItemPath(deliverable.title)} hitSlop={6} outerStyle={{ marginTop: -2 }}
               onPress={() => void copyPath(deliverableAttachment(deliverable))}
               // A step above the row's own hover tint (surface1), so it reads as its own target.
               style={({ pressed, hovered }) => ({ padding: 4, borderRadius: 4, backgroundColor: pressed ? colors.border : hovered ? colors.surface2 : "transparent" })}>

package/client/dialog-stack.tsx

@@ -7,6 +7,7 @@ import { NarrowProvider } from "./narrow";
 import { BackButton, galleryFiles, PreviewContent } from "./preview";
 import { QuestionView, useCopy } from "./questions";
 import { TicketStoryView } from "./ticket-dialog";
+import { ProgressLanguageProvider } from "./language";
 
 type Colors = PluginWorkspacePanelProps["theme"]["colors"];
 type AttachmentContext = { workspaceId: string; workspaceDirectory: string; navigation?: PluginWorkspacePanelProps["navigation"] };
@@ -76,6 +77,7 @@ export function StackedDialog({ colors, root, onClose, questions = [], dashboard
       open={Boolean(root)} onOpenChange={(next) => { if (!next) onClose(); }}>
       {/* One Modal.Content for every step: replacing it would re-present the sheet on phones. */}
       <Modal.Content scrollable={!(preview && previewLong)}>
+      <ProgressLanguageProvider>
       {/* A dialog has room for clock times, however narrow the panel that opened it. */}
       <NarrowProvider value={false}>
       {preview ? (
@@ -100,6 +102,7 @@ export function StackedDialog({ colors, root, onClose, questions = [], dashboard
         </>
       )}
       </NarrowProvider>
+      </ProgressLanguageProvider>
       </Modal.Content>
     </Modal>
   );

package/client/history.tsx

@@ -7,6 +7,7 @@ import { PressScale } from "./motion";
 import { PressableRow } from "./row";
 import { listFolders, setHistoryFolder } from "../shared/rpc";
 import { errorText } from "./errors";
+import { ProgressLanguageProvider, useProgressLanguage } from "./language";
 
 type Colors = PluginWorkspacePanelProps["theme"]["colors"];
 
@@ -18,6 +19,7 @@ export function HistoryRow({ colors, workspaceId, directory, savedTo }: {
   directory: string;
   savedTo: string | null;
 }) {
+  const { messages: m } = useProgressLanguage();
   const [picking, setPicking] = useState(false);
   const set = useRpc(setHistoryFolder);
   const queryClient = useQueryClient();
@@ -26,22 +28,22 @@ export function HistoryRow({ colors, workspaceId, directory, savedTo }: {
     mutationFn: (folder: string | null) => set({ workspaceId, workspaceDirectory: directory, folder }),
     onSuccess: ({ savedTo: next }) => {
       queryClient.invalidateQueries({ queryKey: ["progress", "dashboard"] });
-      toast.show(next ? `Each run will be saved to ${next}.` : "Runs will stay on this computer. Files already saved stay in the repo.", { variant: "success" });
+      toast.show(next ? m.historySaved(next) : m.historyStopped, { variant: "success" });
     },
-    onError: (error) => toast.error(errorText(error, "Could not change where runs are saved.")),
+    onError: (error) => toast.error(errorText(error, m.historyFailure)),
   });
   // While saving, the button that started it says so.
   const busy = mutation.isPending ? (mutation.variables === null ? "stop" : "pick") : null;
   const actions: { label: string; busyLabel: string; kind: "pick" | "stop"; onPress(): void }[] = savedTo
-    ? [{ label: "Change…", busyLabel: "Saving…", kind: "pick", onPress: () => setPicking(true) }, { label: "Stop saving", busyLabel: "Stopping…", kind: "stop", onPress: () => mutation.mutate(null) }]
-    : [{ label: "Save to repo…", busyLabel: "Saving…", kind: "pick", onPress: () => setPicking(true) }];
+    ? [{ label: m.changeFolder, busyLabel: m.saving, kind: "pick", onPress: () => setPicking(true) }, { label: m.stopSaving, busyLabel: m.stopping, kind: "stop", onPress: () => mutation.mutate(null) }]
+    : [{ label: m.saveToRepo, busyLabel: m.saving, kind: "pick", onPress: () => setPicking(true) }];
 
   return (
     <View style={{ flexDirection: "row", flexWrap: "wrap", alignItems: "center", columnGap: 8, rowGap: 4, marginHorizontal: 12, marginTop: 16 }}>
       <View style={{ flexDirection: "row", alignItems: "flex-start", gap: 6, flex: 1, minWidth: 180 }}>
         <View style={{ paddingTop: 2 }}><Icon name="History" size={13} color={colors.foregroundMuted} /></View>
         <Text style={{ flex: 1, color: colors.foregroundMuted, fontSize: 12, lineHeight: 17 }}>
-          {savedTo ? <>Each run is saved to <Text style={{ color: colors.foreground }}>{savedTo}</Text> in this repo.</> : "Run history stays on this computer."}
+          {savedTo ? <>{m.historyInRepo[0]}<Text style={{ color: colors.foreground }}>{savedTo}</Text>{m.historyInRepo[1]}</> : m.localHistory}
         </Text>
       </View>
       <View style={{ flexDirection: "row", gap: 4 }}>
@@ -71,6 +73,7 @@ function FolderPicker({ colors, workspaceId, directory, open, start, onClose, on
   onClose(): void;
   onPick(folder: string): void;
 }) {
+  const { messages: m } = useProgressLanguage();
   const parentOf = (path: string) => path.split("/").slice(0, -1).join("/");
   const [at, setAt] = useState(() => parentOf(start));
   const [naming, setNaming] = useState<string | null>(null);
@@ -86,15 +89,16 @@ function FolderPicker({ colors, workspaceId, directory, open, start, onClose, on
   const newName = naming?.trim().replace(/\/+$/, "") ?? "";
 
   return (
-    <Modal title="Save run history to a folder" icon={<Icon name="FolderOpen" size={16} color={colors.foregroundMuted} />} open={open} onOpenChange={(next) => { if (!next) close(); }}>
+    <Modal title={m.historyFolderTitle} icon={<Icon name="FolderOpen" size={16} color={colors.foregroundMuted} />} open={open} onOpenChange={(next) => { if (!next) close(); }}>
       {/* Paseo sizes a non-scrolling dialog to 85% of the window, so let it size to
           its content; the list's own height cap keeps the buttons in view. */}
       <Modal.Content>
+      <ProgressLanguageProvider>
         <Text style={{ color: colors.foregroundMuted, fontSize: 12, lineHeight: 17 }}>
-          Each run becomes its own file in this folder, in every worktree of this repo. Commit them like any other file.
+          {m.historyFolderHint}
         </Text>
         <View style={{ flexDirection: "row", flexWrap: "wrap", alignItems: "center", gap: 2, paddingHorizontal: 4 }}>
-          {["Top of the repo", ...crumbs].map((crumb, index) => (
+          {[m.repoTop, ...crumbs].map((crumb, index) => (
             <React.Fragment key={index}>
               {index ? <Icon name="ChevronRight" size={12} color={colors.foregroundMuted} /> : null}
               <PressScale accessibilityRole="button" disabled={index === crumbs.length} onPress={() => { setNaming(null); setAt(crumbs.slice(0, index).join("/")); }}
@@ -108,9 +112,9 @@ function FolderPicker({ colors, workspaceId, directory, open, start, onClose, on
 
         {/* Only the list scrolls, so Use and Cancel stay in view in a big repo. */}
         <ScrollView style={{ maxHeight: 320, flexGrow: 0 }} contentContainerStyle={{ gap: 2 }}>
-          {listed.isPending ? <ActivityIndicator color={colors.foregroundMuted} accessibilityLabel="Loading folders" style={{ alignSelf: "flex-start", padding: 8 }} /> : null}
+          {listed.isPending ? <ActivityIndicator color={colors.foregroundMuted} accessibilityLabel={m.loadingFolders} style={{ alignSelf: "flex-start", padding: 8 }} /> : null}
           {listed.data?.folders.map((name) => (
-            <PressableRow key={name} colors={colors} accessibilityRole="button" accessibilityLabel={`Open ${name}`} onPress={() => { setNaming(null); setAt(join(name)); }}
+            <PressableRow key={name} colors={colors} accessibilityRole="button" accessibilityLabel={m.openItem(name)} onPress={() => { setNaming(null); setAt(join(name)); }}
               style={{ flexDirection: "row", alignItems: "center", gap: 8, paddingHorizontal: 8, paddingVertical: 6, borderRadius: 6 }}>
               <Icon name="Folder" size={14} color={colors.foregroundMuted} />
               <Text numberOfLines={1} ellipsizeMode="middle" style={{ flex: 1, color: colors.foreground, fontSize: 12, lineHeight: 16 }}>{name}</Text>
@@ -118,40 +122,41 @@ function FolderPicker({ colors, workspaceId, directory, open, start, onClose, on
             </PressableRow>
           ))}
           {listed.data && !listed.data.folders.length ? (
-            <Text style={{ color: colors.foregroundMuted, fontSize: 12, lineHeight: 16, paddingHorizontal: 8, paddingVertical: 6 }}>No folders in here.</Text>
+            <Text style={{ color: colors.foregroundMuted, fontSize: 12, lineHeight: 16, paddingHorizontal: 8, paddingVertical: 6 }}>{m.noFolders}</Text>
           ) : null}
-          {listed.error ? <Text accessibilityRole="alert" style={{ color: colors.statusDanger, fontSize: 12, lineHeight: 17, paddingHorizontal: 8 }}>{errorText(listed.error, "Could not list the folders.")}</Text> : null}
+          {listed.error ? <Text accessibilityRole="alert" style={{ color: colors.statusDanger, fontSize: 12, lineHeight: 17, paddingHorizontal: 8 }}>{errorText(listed.error, m.listFoldersFailure)}</Text> : null}
         </ScrollView>
 
         {naming === null ? (
           <PressScale accessibilityRole="button" onPress={() => setNaming("")}
             style={({ pressed, hovered }) => ({ alignSelf: "flex-start", flexDirection: "row", alignItems: "center", gap: 6, paddingHorizontal: 8, paddingVertical: 5, borderRadius: 6, backgroundColor: pressed ? colors.border : hovered ? colors.surface2 : "transparent" })}>
             <Icon name="FolderPlus" size={14} color={colors.foreground} />
-            <Text style={{ color: colors.foreground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>New folder</Text>
+            <Text style={{ color: colors.foreground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>{m.newFolder}</Text>
           </PressScale>
         ) : (
           <View style={{ flexDirection: "row", alignItems: "center", gap: 6 }}>
             <TextInput autoFocus value={naming} onChangeText={setNaming} onSubmitEditing={() => { if (newName) onPick(join(newName)); }}
-              autoCapitalize="none" autoCorrect={false} spellCheck={false} accessibilityLabel="New folder name" placeholder="progress-history" placeholderTextColor={colors.foregroundMuted}
+              autoCapitalize="none" autoCorrect={false} spellCheck={false} accessibilityLabel={m.newFolderName} placeholder="progress-history" placeholderTextColor={colors.foregroundMuted}
               style={{ flex: 1, color: colors.foreground, fontSize: 12, lineHeight: 16, paddingHorizontal: 8, paddingVertical: 6, borderRadius: 6, borderWidth: 1, borderColor: colors.border, backgroundColor: colors.surface1 }} />
             <PressScale accessibilityRole="button" disabled={!newName} onPress={() => onPick(join(newName))}
               style={({ pressed, hovered }) => ({ paddingHorizontal: 10, paddingVertical: 6, borderRadius: 6, backgroundColor: colors.accent, opacity: !newName ? 0.5 : pressed ? 0.7 : hovered ? 0.85 : 1 })}>
-              <Text style={{ color: colors.accentForeground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>Use new folder</Text>
+              <Text style={{ color: colors.accentForeground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>{m.useNewFolder}</Text>
             </PressScale>
           </View>
         )}
 
         <View style={{ flexDirection: "row", flexWrap: "wrap", alignItems: "center", justifyContent: "flex-end", gap: 8 }}>
-          {at ? null : <Text style={{ flex: 1, minWidth: 140, color: colors.foregroundMuted, fontSize: 12, lineHeight: 17 }}>Open a folder to use it, or make a new one.</Text>}
+          {at ? null : <Text style={{ flex: 1, minWidth: 140, color: colors.foregroundMuted, fontSize: 12, lineHeight: 17 }}>{m.pickFolderHint}</Text>}
           <PressScale accessibilityRole="button" onPress={close}
             style={({ pressed, hovered }) => ({ paddingHorizontal: 12, paddingVertical: 6, borderRadius: 6, backgroundColor: pressed ? colors.border : hovered ? colors.surface2 : "transparent" })}>
-            <Text style={{ color: colors.foreground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>Cancel</Text>
+            <Text style={{ color: colors.foreground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>{m.cancel}</Text>
           </PressScale>
           <PressScale accessibilityRole="button" disabled={!at} onPress={() => onPick(at)} outerStyle={{ flexShrink: 1 }}
             style={({ pressed, hovered }) => ({ paddingHorizontal: 12, paddingVertical: 6, borderRadius: 6, backgroundColor: colors.accent, opacity: !at ? 0.5 : pressed ? 0.7 : hovered ? 0.85 : 1 })}>
-            <Text numberOfLines={1} ellipsizeMode="middle" style={{ color: colors.accentForeground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>{at ? `Use ${crumbs[crumbs.length - 1]}` : "Use folder"}</Text>
+            <Text numberOfLines={1} ellipsizeMode="middle" style={{ color: colors.accentForeground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>{at ? m.useNamedFolder(crumbs[crumbs.length - 1]) : m.useFolder}</Text>
           </PressScale>
         </View>
+      </ProgressLanguageProvider>
       </Modal.Content>
     </Modal>
   );

package/client/i18n.ts

@@ -0,0 +1,86 @@
+import type { Dashboard, HeadlinePart } from "../shared/dashboard";
+import type { LanguagePreference } from "../shared/settings";
+import type { TimelineLabel } from "../shared/ticket-story";
+import type { ProgressMessages } from "./messages";
+import { messages as en } from "./locales/en";
+import { messages as zhCN } from "./locales/zh-CN";
+
+export type { ProgressMessages } from "./messages";
+export type ProgressLocale = "en" | "zh-CN";
+
+export function systemLocale(): string {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().locale;
+  } catch {
+    return "en";
+  }
+}
+
+export function resolveLocale(preference: LanguagePreference, system = systemLocale()): ProgressLocale {
+  if (preference !== "system") return preference;
+  const [language, ...rest] = system.replaceAll("_", "-").toLowerCase().split("-");
+  // Extensions like "-u-nu-hanidec" say nothing about the script.
+  const singleton = rest.findIndex((part) => part.length === 1);
+  const subtags = singleton === -1 ? rest : rest.slice(0, singleton);
+  if (language !== "zh") return "en";
+  // A script tag beats the region: zh-Hans-HK is Simplified.
+  if (subtags.includes("hans")) return "zh-CN";
+  if (subtags.includes("hant")) return "en";
+  return subtags.length === 0 || subtags.some((part) => ["cn", "sg"].includes(part)) ? "zh-CN" : "en";
+}
+
+export function messagesFor(locale: ProgressLocale): ProgressMessages {
+  return locale === "zh-CN" ? zhCN : en;
+}
+
+export function formatClientMinutes(locale: ProgressLocale, totalMin: number): string {
+  const m = messagesFor(locale);
+  const whole = Math.max(0, Math.floor(totalMin));
+  if (whole < 1) return m.lessThanMinute;
+  const hours = Math.floor(whole / 60);
+  const minutes = whole % 60;
+  return !hours ? m.minutes(minutes) : minutes ? m.hoursMinutes(hours, minutes) : m.hours(hours);
+}
+
+export function formatClientWorkDone(locale: ProgressLocale, doneMin: number, totalMin: number, tookMin?: number): string {
+  if (tookMin !== undefined) return formatClientMinutes(locale, tookMin);
+  const m = messagesFor(locale);
+  return m.workDone(doneMin < 1 ? m.zeroMinutes : formatClientMinutes(locale, doneMin), formatClientMinutes(locale, totalMin));
+}
+
+export function formatClientClock(locale: ProgressLocale, iso: string): string {
+  return new Intl.DateTimeFormat(locale, { month: "short", day: "numeric", hour: "numeric", minute: "2-digit" }).format(new Date(iso));
+}
+
+export function formatClientTimeOfDay(locale: ProgressLocale, iso: string, nowMs: number): string {
+  const date = new Date(iso);
+  const now = new Date(nowMs);
+  const sameDay = date.getFullYear() === now.getFullYear() && date.getMonth() === now.getMonth() && date.getDate() === now.getDate();
+  return sameDay ? new Intl.DateTimeFormat(locale, { hour: "numeric", minute: "2-digit" }).format(date) : formatClientClock(locale, iso);
+}
+
+export function formatClientAgo(locale: ProgressLocale, iso: string, nowMs: number): string {
+  const m = messagesFor(locale);
+  const minutes = (nowMs - Date.parse(iso)) / 60_000;
+  return minutes < 1 ? m.justNow : m.ago(formatClientMinutes(locale, minutes));
+}
+
+export function clientHeadline(locale: ProgressLocale, dashboard: Dashboard): HeadlinePart[] {
+  const m = messagesFor(locale);
+  const counted = dashboard.tickets.filter((ticket) => ticket.status !== "skipped");
+  const done = counted.filter((ticket) => ticket.status === "done").length;
+  const parts: HeadlinePart[] = [{ text: m.headlineDone(done, counted.length, dashboard.run?.itemLabel ?? "Ticket"), tone: "normal" }];
+  if (dashboard.questions.open.length) parts.push({ text: m.questionsWaiting(dashboard.questions.open.length), tone: "normal" });
+  if (dashboard.stuck.length) parts.push({ text: m.stuckCount(dashboard.stuck.length), tone: "danger" });
+  return parts;
+}
+
+export function timelineLabel(m: ProgressMessages, label: TimelineLabel): string {
+  switch (label.kind) {
+    case "added": return m.added;
+    case "reset": return m.resetStatus;
+    case "stage": return m.stageLabel(label.stage);
+    case "status": return m.status[label.status];
+    case "waiting": return m.waitingForTicket(label.id);
+  }
+}

package/client/language.tsx

@@ -0,0 +1,23 @@
+import { useSettings } from "@getpaseo/plugin/client";
+import React, { createContext, useContext } from "react";
+import { displaySettings } from "../shared/settings";
+import { messagesFor, resolveLocale } from "./i18n";
+
+function useLanguageSettings() {
+  const settings = useSettings(displaySettings);
+  const locale = resolveLocale(settings.status === "ready" ? settings.values.language : "system");
+  return { locale, messages: messagesFor(locale), settings };
+}
+
+const LanguageContext = createContext<ReturnType<typeof useLanguageSettings> | null>(null);
+
+export function ProgressLanguageProvider({ children }: { children: React.ReactNode }) {
+  const language = useLanguageSettings();
+  return <LanguageContext.Provider value={language}>{children}</LanguageContext.Provider>;
+}
+
+export function useProgressLanguage() {
+  const language = useContext(LanguageContext);
+  if (!language) throw new Error("ProgressLanguageProvider is missing");
+  return language;
+}

package/client/launcher.tsx

@@ -6,7 +6,9 @@ import { Text, View } from "react-native";
 import { PressScale, Presence } from "./motion";
 import { raised } from "./surfaces";
 import { getLauncherStatus, getSkillStatus, installLauncher, installSkill, type LauncherStatus, type SkillStatus } from "../shared/rpc";
+import { messagesFor, type ProgressMessages } from "./i18n";
 import { errorText } from "./errors";
+import { useProgressLanguage } from "./language";
 
 type Colors = PluginWorkspacePanelProps["theme"]["colors"];
 
@@ -19,30 +21,30 @@ export function skillQueryKey(hostId: string) {
 }
 
 // What the banner says, or null when agents can already run the command.
-export function launcherNotice(status: LauncherStatus): { text: string; action?: string } | null {
+export function launcherNotice(status: LauncherStatus, m: ProgressMessages = messagesFor("en")): { text: string; action?: string } | null {
   switch (status.state) {
     case "missing":
-      return { text: `Agents record progress with the paseo-progress command, which isn't installed yet. Installing adds it at ${status.path}`, action: "Install command" };
+      return { text: m.launcherMissing(status.path), action: m.installCommand };
     case "outdated":
-      return { text: `An older paseo-progress command is installed at ${status.path}.`, action: "Update command" };
+      return { text: m.launcherOutdated(status.path), action: m.updateCommand };
     case "foreign":
-      return { text: `Something else already exists at ${status.path}, so the plugin won't install there. The README shows how to install it elsewhere.` };
+      return { text: m.launcherForeign(status.path) };
     case "current":
-      return status.onPath ? null : { text: `paseo-progress is installed, but its folder isn't on the PATH Paseo uses, so agents need the full path: ${status.path}` };
+      return status.onPath ? null : { text: m.launcherOffPath(status.path) };
   }
 }
 
 // What the skill banner says, or null when every agent folder has the skill.
-export function skillNotice(status: SkillStatus): { text: string; action?: string } | null {
+export function skillNotice(status: SkillStatus, m: ProgressMessages = messagesFor("en")): { text: string; action?: string } | null {
   const folders = (state: string) => status.targets.filter((target) => target.state === state).map((target) => target.path.replace(/[\\/]paseo-progress$/, ""));
-  const skipped = folders("foreign").length ? ` Something else is already at ${folders("foreign").join(", ")}, so the plugin leaves it alone.` : "";
+  const skipped = folders("foreign").length ? m.skillSkipped(folders("foreign").join(m.listSeparator)) : "";
   switch (status.state) {
     case "missing":
-      return { text: `Agents learn when to record progress from the paseo-progress skill, which isn't installed yet. Installing adds a link in ${folders("missing").join(", ")}.${skipped}`, action: "Install skill" };
+      return { text: m.skillMissing(folders("missing").join(m.listSeparator), skipped), action: m.installSkill };
     case "outdated":
-      return { text: `The paseo-progress skill in ${folders("outdated").join(", ")} points to a copy of the plugin Paseo no longer runs.${skipped}`, action: "Update skill" };
+      return { text: m.skillOutdated(folders("outdated").join(m.listSeparator), skipped), action: m.updateSkill };
     case "foreign":
-      return { text: `Something else already exists at every paseo-progress skill path, so the plugin won't install the skill.` };
+      return { text: m.skillForeign };
     case "current":
       return null;
   }
@@ -50,6 +52,7 @@ export function skillNotice(status: SkillStatus): { text: string; action?: strin
 
 // Nothing is written until the user presses the button.
 export function LauncherBanner({ colors, host }: { colors: Colors; host: PluginWorkspacePanelProps["host"] }) {
+  const { messages: m } = useProgressLanguage();
   const fetchStatus = useRpc(getLauncherStatus);
   const install = useRpc(installLauncher);
   const queryClient = useQueryClient();
@@ -59,15 +62,16 @@ export function LauncherBanner({ colors, host }: { colors: Colors; host: PluginW
     mutationFn: () => install({}),
     onSuccess: (next) => {
       queryClient.setQueryData(launcherQueryKey(host.id), next);
-      toast.show(`Installed paseo-progress at ${next.path}`, { variant: "success" });
+      toast.show(m.launcherInstalled(next.path), { variant: "success" });
     },
-    onError: (error) => toast.error(errorText(error, "Could not install the command.")),
+    onError: (error) => toast.error(errorText(error, m.installCommandFailure)),
   });
-  const notice = status.data ? launcherNotice(status.data) : null;
+  const notice = status.data ? launcherNotice(status.data, m) : null;
   return <SetupBanner colors={colors} icon="Terminal" notice={notice} pending={mutation.isPending} onPress={() => mutation.mutate()} />;
 }
 
 export function SkillBanner({ colors, host }: { colors: Colors; host: PluginWorkspacePanelProps["host"] }) {
+  const { messages: m } = useProgressLanguage();
   const fetchStatus = useRpc(getSkillStatus);
   const install = useRpc(installSkill);
   const queryClient = useQueryClient();
@@ -77,11 +81,11 @@ export function SkillBanner({ colors, host }: { colors: Colors; host: PluginWork
     mutationFn: () => install({}),
     onSuccess: (next) => {
       queryClient.setQueryData(skillQueryKey(host.id), next);
-      toast.show("Installed the paseo-progress skill. New agent sessions will use it.", { variant: "success" });
+      toast.show(m.skillInstalled, { variant: "success" });
     },
-    onError: (error) => toast.error(errorText(error, "Could not install the skill.")),
+    onError: (error) => toast.error(errorText(error, m.installSkillFailure)),
   });
-  const notice = status.data ? skillNotice(status.data) : null;
+  const notice = status.data ? skillNotice(status.data, m) : null;
   return <SetupBanner colors={colors} icon="Sparkles" notice={notice} pending={mutation.isPending} onPress={() => mutation.mutate()} />;
 }
 
@@ -92,6 +96,7 @@ function SetupBanner({ colors, icon, notice, pending, onPress }: {
   pending: boolean;
   onPress(): void;
 }) {
+  const { messages: m } = useProgressLanguage();
   return (
     <Presence show={Boolean(notice)}>{notice ? (
     <View style={{ flexDirection: "row", alignItems: "center", flexWrap: "wrap", gap: 10, margin: 12, marginBottom: 0, padding: 8, borderRadius: 12, ...raised(colors), backgroundColor: colors.surface1 }}>
@@ -102,7 +107,7 @@ function SetupBanner({ colors, icon, notice, pending, onPress }: {
         <PressScale accessibilityRole="button" disabled={pending} onPress={onPress}
           style={({ pressed, hovered }) => ({ paddingHorizontal: 10, paddingVertical: 5, borderRadius: 4, backgroundColor: colors.accent, opacity: pressed || pending ? 0.7 : hovered ? 0.85 : 1 })}>
           <Text style={{ color: colors.accentForeground, fontSize: 12, lineHeight: 16, fontWeight: "600" }}>
-            {pending ? "Installing…" : notice.action}
+            {pending ? m.installing : notice.action}
           </Text>
         </PressScale>
       ) : null}