viveworker 0.1.9 → 0.1.10

package/README.md

@@ -5,12 +5,12 @@
 [![npm version](https://badge.fury.io/js/viveworker.svg)](https://badge.fury.io/js/viveworker)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-`viveworker` brings Codex Desktop to your iPhone.
+`viveworker` brings Codex Desktop to your phone.
 
 When Codex needs an approval, asks whether to implement a plan, wants you to choose from options, or finishes a task while you are away from your desk, `viveworker` keeps all of that within reach on your phone. Instead of breaking your rhythm, it helps you keep vivecoding going from anywhere in your home or office.
 
 Think of it as a local companion for Codex on your Mac:
-your Mac keeps building, and your iPhone keeps you in the loop.
+your Mac keeps building, and your device keeps you in the loop.
 
 ## Why It Feels Good
 
@@ -29,13 +29,13 @@ keep Codex moving, keep context close, and keep your momentum.
 
 `viveworker` works best with:
 
-- Mac + iPhone
+- Mac + mobile device
 - the same Wi-Fi or LAN
 - a trusted local network
 - the Home Screen web app with Web Push enabled
 
 It gets even more fun with a Mac mini.
-Leave Codex running on a small always-on machine, and `viveworker` starts to feel like a local coding appliance: your Mac mini keeps building in the background while your iPhone handles approvals, plan checks, questions, and follow-up replies from anywhere in your home or office.
+Leave Codex running on a small always-on machine, and `viveworker` starts to feel like a local coding appliance: your Mac mini keeps building in the background while your device handles approvals, plan checks, questions, and follow-up replies from anywhere in your home or office.
 
 `viveworker` is designed for local use only.
 It is not intended for Internet exposure.
@@ -48,7 +48,7 @@ You can use it as:
 
 - an always-on Codex station that stays running in the background
 - a way to keep approvals and plan checks moving even when you are away from your desk
-- a lightweight monitor for long-running coding or research tasks, where your iPhone only surfaces what needs your attention
+- a lightweight monitor for long-running coding or research tasks, where your device only surfaces what needs your attention
 - a small local AI appliance for your home or office
 - a quick way to review a completion and send “do this next” back into the latest thread from your phone
 
@@ -79,10 +79,10 @@ npx viveworker setup --port 8820
 
 1. Run `npx viveworker setup --install-mkcert` on your Mac
 2. If macOS asks, allow the local CA install
-3. On your iPhone, open the printed `rootCA.pem` URL
-4. Install the certificate profile and trust it in iPhone certificate trust settings
-5. Open the printed pairing URL in Safari
-6. Pair your iPhone with the code if needed
+3. On your device, open the printed `rootCA.pem` URL
+4. If your device requires local CA trust, install the certificate profile and trust it
+5. Open the printed pairing URL on your device
+6. Pair your device with the code if needed
 7. Add `viveworker` to your Home Screen
 8. Open the Home Screen app
 9. In `Settings`, tap `Enable Notifications`
@@ -128,7 +128,7 @@ Useful options:
 
 `--pair` reissues only the short-lived pairing code and pairing URL.
 It does not change the main app URL, port, session secret, TLS, or Web Push settings.
-Use it only when you want to add another trusted iPhone or browser.
+Use it only when you want to add another trusted device or browser.
 
 ## Questions and Limits
 
@@ -156,7 +156,7 @@ If you later want a second wake-up notification path, you can add `ntfy` alongsi
 
 - If the `.local` URL does not open, use the printed IP-based URL
 - If pairing has expired, run `npx viveworker setup --pair`
-- If notifications do not appear, make sure you opened the Home Screen app, not just a Safari tab
+- If notifications do not appear, make sure you opened the Home Screen app, not just a browser tab
 - If Web Push is enabled, make sure you are opening the HTTPS URL
 - If you are stuck, run:
 
@@ -171,13 +171,13 @@ npx viveworker doctor
 - Web Push still depends on the browser/platform push service
 - `--install-mkcert` can automate the Mac-side `mkcert` install and `mkcert -install`
 - macOS may still show an administrator prompt while installing the local CA
-- iPhone trust is still manual: you need to trust the local CA profile on the device
+- On some devices, local CA trust is still manual before HTTPS works reliably
 - Web Push supports approvals, plans, multiple-choice questions, and completions
 
 ## Roadmap
 
 Planned next steps include:
 
-- Android support
 - Windows support
+- ✅ ~~Android support~~ (Apr 1, 2026)
 - ✅ ~~image attachment support from mobile~~ (Mar 26, 2026)

package/ntfy/server.yml.example

@@ -8,7 +8,7 @@ base-url: "http://YOUR-MAC-IP-OR-HOSTNAME:8080"
 # The container listens on port 80 internally; Docker maps 8080 -> 80.
 listen-http: ":80"
 
-# Persistent cache is required so iPhone can fetch message contents after a poll request.
+# Persistent cache is required so a paired device can fetch message contents after a poll request.
 cache-file: "/var/lib/ntfy/cache.db"
 
 # User, ACL, and token database. Created automatically if it does not exist.
@@ -19,7 +19,7 @@ auth-default-access: "deny-all"
 enable-login: true
 enable-signup: false
 
-# Needed for near-instant iPhone delivery on a self-hosted server.
+# Needed for near-instant mobile delivery on a self-hosted server.
 # Only a poll request is forwarded upstream, not your real message body.
 upstream-base-url: "https://ntfy.sh"
 

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "viveworker",
-  "version": "0.1.9",
-  "description": "Local iPhone companion for Codex Desktop approvals, plan checks, questions, and notifications on your LAN.",
+  "version": "0.1.10",
+  "description": "Local device companion for Codex Desktop approvals, plan checks, questions, and notifications on your LAN.",
   "author": "Yuta Hoshino <hoshino.lireneo@gmail.com>",
   "license": "MIT",
   "keywords": [
     "codex",
     "codex-desktop",
     "macos",
-    "iphone",
+    "mobile",
     "ios",
+    "android",
     "pwa",
     "web-push",
     "notifications",

package/scripts/viveworker-bridge.mjs

@@ -85,8 +85,16 @@ const state = await loadState(config.stateFile);
 const migratedPairedDevicesStateChanged = migratePairedDevicesState({ config, state });
 const restoredPendingPlanStateChanged = restorePendingPlanRequests({ config, runtime, state });
 const restoredPendingUserInputStateChanged = restorePendingUserInputRequests({ config, runtime, state });
-runtime.recentHistoryItems = normalizeHistoryItems(state.recentHistoryItems ?? [], config.maxHistoryItems);
-runtime.recentTimelineEntries = normalizeTimelineEntries(state.recentTimelineEntries ?? [], config.maxTimelineEntries);
+const initialHistoryItems = normalizeHistoryItems(state.recentHistoryItems ?? [], config.maxHistoryItems);
+const initialTimelineEntries = normalizeTimelineEntries(state.recentTimelineEntries ?? [], config.maxTimelineEntries);
+const normalizedHistoryStateChanged =
+  JSON.stringify(initialHistoryItems) !== JSON.stringify(Array.isArray(state.recentHistoryItems) ? state.recentHistoryItems : []);
+const normalizedTimelineStateChanged =
+  JSON.stringify(initialTimelineEntries) !== JSON.stringify(Array.isArray(state.recentTimelineEntries) ? state.recentTimelineEntries : []);
+runtime.recentHistoryItems = initialHistoryItems;
+runtime.recentTimelineEntries = initialTimelineEntries;
+state.recentHistoryItems = initialHistoryItems;
+state.recentTimelineEntries = initialTimelineEntries;
 const migratedRecentCodeEventsStateChanged = migrateRecentCodeEventsState({ config, runtime, state });
 const restoredTimelineImagePathsStateChanged = await backfillPersistedTimelineImagePaths({ config, runtime, state });
 runtime.historyFileState.offset = Number(state.historyFileOffset) || 0;
@@ -1791,7 +1799,11 @@ function normalizeHistoryItem(raw) {
 
   const stableId = cleanText(raw.stableId ?? raw.id ?? "");
   const kind = cleanText(raw.kind ?? "");
-  const title = cleanText(raw.title ?? "");
+  const threadId = cleanText(raw.threadId ?? extractConversationIdFromStableId(stableId) ?? "");
+  const rawThreadLabel = cleanText(raw.threadLabel ?? "");
+  const threadLabel = preferTitleOnlyJsonThreadLabel(rawThreadLabel, threadId, raw.messageText, raw.summary, raw.detailText, raw.message);
+  const title =
+    cleanText(raw.title ?? "") || (threadLabel ? formatTitle(kindTitle(DEFAULT_LOCALE, kind), threadLabel) : kindTitle(DEFAULT_LOCALE, kind));
   const messageText = normalizeTimelineMessageText(raw.messageText ?? "");
   const summary = normalizeNotificationText(raw.summary ?? "") || formatNotificationBody(messageText, 100) || "";
   const createdAtMs = Number(raw.createdAtMs) || Date.now();
@@ -1805,9 +1817,9 @@ function normalizeHistoryItem(raw) {
     stableId,
     token: cleanText(raw.token ?? "") || historyToken(stableId),
     kind,
-    threadId: cleanText(raw.threadId ?? extractConversationIdFromStableId(stableId) ?? ""),
+    threadId,
     title,
-    threadLabel: cleanText(raw.threadLabel ?? ""),
+    threadLabel,
     summary,
     messageText,
     imagePaths: normalizeTimelineImagePaths(raw.imagePaths ?? raw.localImagePaths ?? []),
@@ -1922,6 +1934,7 @@ function normalizeTimelineEntry(raw) {
     return null;
   }
 
+  const threadId = cleanText(raw.threadId ?? extractConversationIdFromStableId(stableId) ?? "");
   const messageText = normalizeTimelineMessageText(raw.messageText ?? "");
   const fileEventType = normalizeTimelineFileEventType(raw.fileEventType ?? "");
   const diffText = normalizeTimelineDiffText(raw.diffText ?? "");
@@ -1932,7 +1945,14 @@ function normalizeTimelineEntry(raw) {
     formatNotificationBody(messageText, 180) ||
     (kind === "file_event" ? "" : cleanText(raw.title ?? "")) ||
     "";
-  const threadLabel = cleanText(raw.threadLabel ?? "");
+  const threadLabel = preferTitleOnlyJsonThreadLabel(
+    cleanText(raw.threadLabel ?? ""),
+    threadId,
+    raw.messageText,
+    raw.summary,
+    raw.detailText,
+    raw.message
+  );
   const title =
     cleanText(raw.title ?? "") ||
     (kind === "file_event" ? fileEventTitle(DEFAULT_LOCALE, fileEventType) : "") ||
@@ -1944,7 +1964,7 @@ function normalizeTimelineEntry(raw) {
     stableId,
     token: cleanText(raw.token ?? "") || historyToken(stableId),
     kind,
-    threadId: cleanText(raw.threadId ?? extractConversationIdFromStableId(stableId) ?? ""),
+    threadId,
     threadLabel,
     title,
     summary,
@@ -12477,6 +12497,22 @@ function extractRolloutMessageText(content) {
   );
 }
 
+function extractTitleOnlyJsonTitleFromRolloutContent(content) {
+  if (!Array.isArray(content)) {
+    return "";
+  }
+  for (const entry of content) {
+    if (!isPlainObject(entry) || (entry.type !== "input_text" && entry.type !== "output_text")) {
+      continue;
+    }
+    const title = extractTitleOnlyJsonTitle(entry.text ?? "");
+    if (title) {
+      return title;
+    }
+  }
+  return "";
+}
+
 function rolloutContentHasImages(content) {
   if (!Array.isArray(content)) {
     return false;
@@ -12592,6 +12628,22 @@ async function extractRolloutThreadMetadata(filePath) {
             break;
           }
         }
+      } else if (!metadata.titleCandidate && entry.payload?.type === "message" && entry.payload?.role === "assistant") {
+        const titleCandidate = truncate(cleanText(extractTitleOnlyJsonTitleFromRolloutContent(entry.payload.content)), 90);
+        if (titleCandidate) {
+          metadata.titleCandidate = titleCandidate;
+          if (metadata.threadId) {
+            break;
+          }
+        }
+      } else if (!metadata.titleCandidate && entry.type === "event_msg" && entry.payload?.type === "task_complete") {
+        const titleCandidate = truncate(cleanText(extractTitleOnlyJsonTitle(entry.payload.last_agent_message ?? "")), 90);
+        if (titleCandidate) {
+          metadata.titleCandidate = titleCandidate;
+          if (metadata.threadId) {
+            break;
+          }
+        }
       }
     }
   } catch {
@@ -12768,11 +12820,12 @@ function refreshResolvedThreadLabels({ config, runtime, state }) {
       if (!conversationId) {
         return item;
       }
-      const threadLabel = getNativeThreadLabel({
+      const nativeThreadLabel = getNativeThreadLabel({
         runtime,
         conversationId,
         cwd: "",
       });
+      const threadLabel = preferTitleOnlyJsonThreadLabel(nativeThreadLabel, conversationId, item.messageText, item.summary);
       const title = formatTitle(kindTitle(config.defaultLocale, item.kind), threadLabel);
       if (threadLabel === item.threadLabel && title === item.title) {
         return item;
@@ -12802,11 +12855,12 @@ function refreshResolvedThreadLabels({ config, runtime, state }) {
       if (!threadId) {
         return entry;
       }
-      const threadLabel = getNativeThreadLabel({
+      const nativeThreadLabel = getNativeThreadLabel({
         runtime,
         conversationId: threadId,
         cwd: "",
       });
+      const threadLabel = preferTitleOnlyJsonThreadLabel(nativeThreadLabel, threadId, entry.messageText, entry.summary);
       const title = threadLabel || kindTitle(config.defaultLocale, entry.kind);
       if (threadLabel === entry.threadLabel && title === entry.title) {
         return entry;
@@ -12836,11 +12890,12 @@ function refreshResolvedThreadLabels({ config, runtime, state }) {
       if (!threadId) {
         return entry;
       }
-      const threadLabel = getNativeThreadLabel({
+      const nativeThreadLabel = getNativeThreadLabel({
         runtime,
         conversationId: threadId,
         cwd: "",
       });
+      const threadLabel = preferTitleOnlyJsonThreadLabel(nativeThreadLabel, threadId, entry.messageText, entry.summary);
       const title = threadLabel || kindTitle(config.defaultLocale, entry.kind);
       if (threadLabel === entry.threadLabel && title === entry.title) {
         return entry;
@@ -12902,6 +12957,10 @@ function summarizeNotificationText(value) {
 }
 
 function normalizeLongText(value) {
+  const titleOnlyJsonTitle = extractTitleOnlyJsonTitle(value);
+  if (titleOnlyJsonTitle) {
+    return titleOnlyJsonTitle;
+  }
   return String(stripEnvironmentContextBlocks(stripMarkdownLinks(value)) || "")
     .replace(/\r\n/gu, "\n")
     .replace(/[ \t]+\n/gu, "\n")
@@ -13013,6 +13072,53 @@ function cleanText(value) {
   return String(value || "").replace(/\s+/gu, " ").trim();
 }
 
+function extractTitleOnlyJsonTitle(value) {
+  const rawText = String(value ?? "").trim();
+  if (!rawText) {
+    return "";
+  }
+  const parsed = safeJsonParse(rawText);
+  if (!isPlainObject(parsed) || typeof parsed.title !== "string") {
+    return "";
+  }
+  const meaningfulExtraKeys = Object.entries(parsed).filter(([key, entryValue]) => {
+    if (key === "title") {
+      return false;
+    }
+    if (entryValue == null) {
+      return false;
+    }
+    if (typeof entryValue === "string" && cleanText(entryValue) === "") {
+      return false;
+    }
+    if (Array.isArray(entryValue) && entryValue.length === 0) {
+      return false;
+    }
+    if (isPlainObject(entryValue) && Object.keys(entryValue).length === 0) {
+      return false;
+    }
+    return true;
+  });
+  if (meaningfulExtraKeys.length > 0) {
+    return "";
+  }
+  return cleanText(parsed.title || "");
+}
+
+function preferTitleOnlyJsonThreadLabel(rawThreadLabel, conversationId, ...candidates) {
+  const preferredThreadLabel = sanitizeResolvedThreadLabel(rawThreadLabel, conversationId);
+  if (preferredThreadLabel) {
+    return preferredThreadLabel;
+  }
+  for (const candidate of candidates) {
+    const titleOnlyJsonTitle = truncate(cleanText(extractTitleOnlyJsonTitle(candidate)), 90);
+    if (titleOnlyJsonTitle) {
+      return titleOnlyJsonTitle;
+    }
+  }
+  return cleanText(rawThreadLabel || "");
+}
+
 function stripMarkdownLinks(value) {
   return String(value || "").replace(/\[([^\]]+)\]\(([^)]+)\)/gu, "$1");
 }
@@ -13227,6 +13333,8 @@ async function main() {
     }
 
     if (
+      normalizedHistoryStateChanged ||
+      normalizedTimelineStateChanged ||
       migratedPairedDevicesStateChanged ||
       restoredPendingPlanStateChanged ||
       restoredTimelineImagePathsStateChanged ||

package/scripts/viveworker.mjs

@@ -1336,10 +1336,24 @@ async function installMkcertForMac(progress, locale) {
   }
 
   progress?.update("cli.setup.progress.installMkcert");
-  await execCommand([brewPath, "install", "mkcert"], {
-    streamOutput: true,
-    beforeStreamOutput: () => progress?.clear(),
-  });
+  try {
+    await execCommand([brewPath, "install", "mkcert"], {
+      streamOutput: true,
+      beforeStreamOutput: () => progress?.clear(),
+    });
+  } catch (error) {
+    const rawMessage = String(error?.message || error || "");
+    const permissionIssue =
+      /not writable/iu.test(rawMessage) &&
+      (/homebrew/iu.test(rawMessage) || /\/opt\/homebrew/iu.test(rawMessage) || /\/usr\/local/iu.test(rawMessage));
+    throw new Error(
+      [
+        t(locale, permissionIssue ? "cli.setup.error.mkcertInstallPermission" : "cli.setup.error.mkcertInstallFailed"),
+        t(locale, "cli.setup.error.mkcertInstallNext"),
+        t(locale, "cli.setup.error.mkcertInstallExample"),
+      ].join("\n")
+    );
+  }
   const mkcertPath = await findExecutable("mkcert");
   if (!mkcertPath) {
     throw new Error("mkcert installation finished, but the mkcert executable is still not available.");

package/viveworker.env.example

@@ -74,15 +74,15 @@ NOTIFY_PLANS=1
 NATIVE_APPROVALS=1
 ENABLE_NTFY=0
 
-# Native codex.app approval pages for iPhone.
+# Native codex.app approval pages for mobile devices.
 # Use HTTPS for LAN access whenever possible. Plain HTTP over LAN requires
 # ALLOW_INSECURE_LAN_HTTP=1 and is not recommended.
-# Use a public LAN URL the iPhone can reach. This can be different from NTFY_PUBLISH_BASE_URL.
+# Use a public LAN URL the device can reach. This can be different from NTFY_PUBLISH_BASE_URL.
 NATIVE_APPROVAL_SERVER_PUBLIC_BASE_URL=
 NATIVE_APPROVAL_SERVER_HOST=127.0.0.1
 NATIVE_APPROVAL_SERVER_PORT=8810
 
-# App-server runner settings for interactive iPhone approvals.
+# App-server runner settings for interactive mobile approvals.
 # If empty, the runner derives the host from NTFY_BASE_URL.
 APPROVAL_SERVER_PUBLIC_BASE_URL=
 APPROVAL_SERVER_HOST=0.0.0.0

package/web/i18n.js

@@ -70,7 +70,7 @@ const translations = {
     "tab.code.title": "Code",
     "tab.code.label": "Code",
     "tab.code.eyebrow": "Current changes",
-    "tab.code.description": "Review the current unstaged file changes from Codex in a mobile-friendly diff view.",
+    "tab.code.description": "Review the current unstaged file changes from Codex in a mobile-friendly diff view on your device.",
     "tab.completed.title": "Completed",
     "tab.completed.label": "Completed",
     "tab.completed.eyebrow": "History",
@@ -80,34 +80,34 @@ const translations = {
     "tab.settings.eyebrow": "Device",
     "tab.settings.description": "Pairing, installation, and notification controls.",
     "pair.copy":
-      "Pair this iPhone with your local Codex desktop session and keep approvals, plans, choices, and completions within reach.",
+      "Pair this device with your local Codex desktop session and keep approvals, plans, choices, and completions within reach.",
     "pair.codeLabel": "Pairing code",
     "pair.codePlaceholder": "Enter the pairing code",
-    "pair.connect": "Connect this iPhone",
+    "pair.connect": "Connect this device",
     "pair.installFromHomeScreen":
       "This pairing link is being kept for the Home Screen app. Add viveworker to your Home Screen from Safari, then open the new icon to finish pairing there.",
     "pair.helperTitle": "Add to Home Screen",
     "pair.helperCopy": "Install viveworker for the best mobile layout and Web Push support.",
     "banner.install.title": "Add viveworker to your Home Screen",
     "banner.install.copy.safari":
-      "Install it from Safari for a cleaner iPhone layout and background notifications.",
+      "Install it from Safari for a cleaner mobile layout and background notifications.",
     "banner.install.copy.other": "Open this page in Safari to install viveworker to your Home Screen.",
     "banner.push.title": "Push notifications can help",
     "banner.push.copy.https": "Open viveworker over HTTPS to turn on push notifications.",
-    "banner.push.copy.standalone": "Add viveworker to your Home Screen to receive push notifications on iPhone.",
+    "banner.push.copy.standalone": "Add viveworker to your Home Screen to receive push notifications on this device.",
     "banner.push.copy.denied":
-      "Notifications are currently blocked for this app. You can re-enable them later from iPhone settings.",
+      "Notifications are currently blocked for this app. You can re-enable them later from your device settings.",
     "banner.push.copy.default":
       "Enable push notifications to catch approvals, plans, questions, and completions even when the app is in the background.",
     "install.guide.title": "Add to Home Screen",
     "install.guide.intro.safari":
-      "iPhone does not let websites trigger this directly, but you can add viveworker in a few taps.",
-    "install.guide.intro.other": "On iPhone, Home Screen installation works best from Safari.",
+      "This browser does not let websites trigger this directly, but you can add viveworker in a few taps.",
+    "install.guide.intro.other": "If Home Screen installation is unavailable here, try opening this page in Safari or another supported mobile browser.",
     "install.guide.step.openSafari": "Open this same URL in Safari.",
     "install.guide.step.tapShare": "Tap the Share button.",
     "install.guide.step.chooseAdd": "Choose Add to Home Screen.",
     "install.guide.step.tapAdd": "Tap Add, then open the new icon.",
-    "shell.subtitle.settings": "Pairing, notifications, and installation for this iPhone.",
+    "shell.subtitle.settings": "Pairing, notifications, and installation for this device.",
     "shell.subtitle.detail": "Review the selected item and act without leaving your current flow.",
     "empty.pending":
       "Nothing needs attention right now. New approvals, plans, and choices will appear here first.",
@@ -147,7 +147,7 @@ const translations = {
     "reply.imageAddMore": "Add more images",
     "reply.imageReplace": "Replace image",
     "reply.imageRemove": "Remove",
-    "reply.imageHint": "Attach up to {count} images from your iPhone and send them together with your message.",
+    "reply.imageHint": "Attach up to {count} images from your device and send them together with your message.",
     "reply.imageAttached": "Attached image",
     "reply.send": "Send to Codex",
     "reply.sendConfirm": "Send anyway",
@@ -225,34 +225,34 @@ const translations = {
     "diff.threadSummary": ({ count }) => `Changed ${count} ${count === 1 ? "file" : "files"}`,
     "diff.latestChange": "Latest change",
     "diff.latestChangeFallback": "Current unstaged changes are available in this thread.",
-    "settings.intro": "Check pairing, language, install status, and Web Push health for this iPhone.",
+    "settings.intro": "Check pairing, language, install status, and Web Push health for this device.",
     "settings.section.overview": "Quick setup",
     "settings.section.notifications": "Notifications",
     "settings.section.install": "Install",
-    "settings.section.device": "This iPhone",
+    "settings.section.device": "This device",
     "settings.group.general": "General",
-    "settings.group.device": "This iPhone",
+    "settings.group.device": "This device",
     "settings.group.values": "Current settings",
     "settings.group.advanced": "Advanced",
     "settings.group.actions": "Actions",
     "settings.overview.title": "At a glance",
-    "settings.overview.copy": "See what is ready, what still needs setup, and what to do next on this iPhone.",
+    "settings.overview.copy": "See what is ready, what still needs setup, and what to do next on this device.",
     "settings.summary.notifications": "Notifications",
     "settings.summary.install": "Home Screen",
     "settings.summary.pairing": "Pairing",
     "settings.nextStep.eyebrow": "Next step",
     "settings.nextStep.enableNotifications.title": "Turn on notifications",
-    "settings.nextStep.enableNotifications.copy": "Enable Web Push on this iPhone so approvals, plans, and questions can reach you in the background.",
+    "settings.nextStep.enableNotifications.copy": "Enable Web Push on this device so approvals, plans, and questions can reach you in the background.",
     "settings.nextStep.serverDisabled.title": "Server setup is still missing",
-    "settings.nextStep.serverDisabled.copy": "Web Push is not enabled on this viveworker server yet, so this iPhone cannot subscribe yet.",
+    "settings.nextStep.serverDisabled.copy": "Web Push is not enabled on this viveworker server yet, so this device cannot subscribe yet.",
     "settings.nextStep.openHttps.title": "Open the HTTPS version",
-    "settings.nextStep.openHttps.copy": "This page must be opened over HTTPS before iPhone can enable notifications.",
+    "settings.nextStep.openHttps.copy": "This page must be opened over HTTPS before this device can enable notifications.",
     "settings.nextStep.install.title": "Add viveworker to Home Screen",
-    "settings.nextStep.install.copy": "Install the app from Safari, then reopen it from the Home Screen before enabling notifications.",
+    "settings.nextStep.install.copy": "Add the app to your Home Screen, then reopen the installed app before enabling notifications.",
     "settings.nextStep.permissionBlocked.title": "Notifications are blocked",
-    "settings.nextStep.permissionBlocked.copy": "Re-enable notifications in iPhone settings, then return here to test again.",
+    "settings.nextStep.permissionBlocked.copy": "Re-enable notifications in your device settings, then return here to test again.",
     "settings.nextStep.test.title": "Everything is ready",
-    "settings.nextStep.test.copy": "Send a test notification to confirm this iPhone can receive pushes from viveworker.",
+    "settings.nextStep.test.copy": "Send a test notification to confirm this device can receive pushes from viveworker.",
     "settings.status.notAvailable": "Not available",
     "settings.status.unsupported": "Not supported",
     "settings.status.needsHttps": "Needs HTTPS",
@@ -270,7 +270,7 @@ const translations = {
     "settings.notifications.serverDisabled": "Web Push is not enabled on the server yet.",
     "settings.notifications.openHttps": "Open viveworker over HTTPS before enabling notifications.",
     "settings.notifications.openHomeScreen":
-      "Open the Home Screen app before enabling notifications on iPhone.",
+      "Open the installed Home Screen app before enabling notifications on this device.",
     "settings.action.enableNotifications": "Enable Notifications",
     "settings.action.disableNotifications": "Disable Notifications",
     "settings.action.sendTest": "Send Test Notification",
@@ -279,9 +279,9 @@ const translations = {
     "settings.action.removeThisDevice": "Remove this device",
     "settings.install.title": "Install to Home Screen",
     "settings.install.copy":
-      "For the best iPhone experience, install viveworker from Safari and open the Home Screen app.",
+      "For the best mobile experience, add viveworker to your Home Screen and open the installed app.",
     "settings.device.title": "Devices",
-    "settings.device.copy": "Manage trusted iPhones and browsers that can open this LAN viveworker app.",
+    "settings.device.copy": "Manage trusted devices and browsers that can open this LAN viveworker app.",
     "settings.device.count": ({ count }) => `${count} ${count === 1 ? "device" : "devices"}`,
     "settings.device.section.current": "This device",
     "settings.device.section.other": "Other trusted devices",
@@ -289,7 +289,7 @@ const translations = {
     "settings.device.emptyCurrent": "This device is not listed right now.",
     "settings.device.emptyOther": "No other trusted devices are active.",
     "settings.device.addAnother.title": "Add another device",
-    "settings.device.addAnother.heading": "Add a new iPhone or browser",
+    "settings.device.addAnother.heading": "Add a new device or browser",
     "settings.device.addAnother.copy":
       "Run this on your Mac only when you want to add another trusted device. Your main app URL stays the same.",
     "settings.device.addAnother.commandLabel": "Run on your Mac",
@@ -302,12 +302,12 @@ const translations = {
     "settings.device.mode.standalone": "Home Screen app",
     "settings.device.mode.browser": "Browser tab",
     "settings.language.title": "Language",
-    "settings.language.copy": "Choose how this iPhone should display viveworker.",
+    "settings.language.copy": "Choose how this device should display viveworker.",
     "settings.pairing.title": "Pairing",
-    "settings.pairing.copy": "This iPhone is paired with your local Codex desktop session.",
+    "settings.pairing.copy": "This device is paired with your local Codex desktop session.",
     "settings.pairing.connected": "Paired",
     "settings.technical.title": "Technical details",
-    "settings.technical.copy": "Connection and notification diagnostics for this iPhone.",
+    "settings.technical.copy": "Connection and notification diagnostics for this device.",
     "settings.technical.copyShort": "Connection and notification diagnostics.",
     "settings.row.deviceId": "Device ID",
     "settings.row.pairedAt": "Paired",
@@ -334,11 +334,11 @@ const translations = {
     "notice.loggedOutKeepTrusted": "Logged out. This device stays trusted, so you can come back without pairing again.",
     "notice.loggedOutDeviceRemoved": "Logged out and removed this device. Pair again before using viveworker here.",
     "error.networkHint":
-      "Try reopening the latest HTTPS URL in Safari, then re-add the Home Screen app if needed.",
+      "Try reopening the latest HTTPS URL in your browser, then re-add the Home Screen app if needed.",
     "error.webPushDisabled": "Web Push is not enabled on the server.",
     "error.notificationsRequireHttps": "Notifications require HTTPS.",
     "error.pushUnsupported": "This browser does not support Web Push.",
-    "error.openHomeScreen": "On iPhone, open viveworker from the Home Screen before enabling notifications.",
+    "error.openHomeScreen": "Open viveworker from the Home Screen before enabling notifications on this device.",
     "error.notificationPermission": ({ status }) => `Notification permission is ${status}.`,
     "error.pushServerNotReady": "The server is not ready for Web Push.",
     "error.serviceWorkerUnavailable": "Service Worker is not available.",
@@ -387,7 +387,7 @@ const translations = {
     "server.message.fileApprovalNeeded": "File changes need approval.",
     "server.message.commandPrefix": ({ command }) => `Command: ${command}`,
     "server.message.pathPrefix": ({ path }) => `Path: ${path}`,
-    "server.message.approveOnMac": "Approve on Mac only: this iPhone alert mirrors codex.app.",
+    "server.message.approveOnMac": "Approve on Mac only: this device alert mirrors codex.app.",
     "server.message.approvalNeededInCodex": "Approval needed in Codex.",
     "server.message.extraApprovals": ({ count }) => `Extra approvals: ${count}`,
     "server.message.taskFinished": "Task finished.",
@@ -405,7 +405,7 @@ const translations = {
     "server.confirm.approve": "This approval will be confirmed and Codex will continue.",
     "server.confirm.reject": "This action will be rejected and Codex will be told not to continue.",
     "server.pushTest.title": "viveworker test notification",
-    "server.pushTest.body": "Notifications are working on this iPhone.",
+    "server.pushTest.body": "Notifications are working on this device.",
     "server.page.notFoundTitle": "Not found",
     "server.page.notFoundBody": "This approval link does not exist.",
     "server.page.notFoundHint": "You can close this page safely.",
@@ -448,16 +448,16 @@ const translations = {
     "cli.setup.webPushEnabled": "Web Push: enabled (HTTPS)",
     "cli.setup.webPushDisabled": "Web Push: disabled",
     "cli.setup.completePending": "viveworker setup finished, but health has not responded yet.",
-    "cli.setup.caFlow.title": "Before opening viveworker on iPhone, install and trust the local root certificate:",
-    "cli.setup.caFlow.step1": "1. Open the CA download URL or scan the QR code below on your iPhone.",
-    "cli.setup.caFlow.step2": "2. Install the rootCA.pem profile, then enable trust for it in iPhone certificate trust settings.",
+    "cli.setup.caFlow.title": "Before opening viveworker on your device, install and trust the local root certificate if needed:",
+    "cli.setup.caFlow.step1": "1. Open the CA download URL or scan the QR code below on your device.",
+    "cli.setup.caFlow.step2": "2. Install the rootCA.pem profile, then enable trust for it if your device requires local CA trust.",
     "cli.setup.caFlow.step3": "3. After that, press Enter here to show the viveworker app URL and pairing QR.",
     "cli.setup.instructions.https":
-      "Open the HTTPS URL in Safari, trust your local CA on iPhone, then add the app to the Home Screen to enable notifications.",
+      "Open the HTTPS URL in your mobile browser, trust your local CA if needed, then add the app to the Home Screen to enable notifications.",
     "cli.setup.instructions.afterCa":
-      "Now open the pairing URL in Safari on your iPhone, pair it if needed, then add viveworker to the Home Screen.",
+      "Now open the pairing URL on your device, pair it if needed, then add viveworker to the Home Screen.",
     "cli.setup.instructions.insecureHttpLan":
-      "Open the HTTP URL in Safari only if you intentionally allowed insecure LAN access. This mode is not recommended on shared Wi-Fi.",
+      "Open the HTTP URL in a mobile browser only if you intentionally allowed insecure LAN access. This mode is not recommended on shared Wi-Fi.",
     "cli.setup.instructions.localOnlyHttp":
       "This setup is loopback-only HTTP for local development. Use the default HTTPS setup or --allow-insecure-http-lan if you explicitly need LAN access.",
     "logout.confirm.title": "Choose how to log out",
@@ -475,6 +475,12 @@ const translations = {
     "cli.setup.qrPairing": "Pairing QR:",
     "cli.setup.qrCaDownload": "rootCA.pem download QR (IP):",
     "cli.setup.prompt.continueToApp": "Press Enter to continue to the viveworker app URL.",
+    "cli.setup.error.mkcertInstallFailed": "viveworker could not install mkcert with Homebrew.",
+    "cli.setup.error.mkcertInstallPermission":
+      "Homebrew is installed, but its prefix is not writable by your current user, so viveworker could not auto-install mkcert.",
+    "cli.setup.error.mkcertInstallNext":
+      "Fix your Homebrew permissions, then rerun `npx viveworker setup --install-mkcert`, or install mkcert manually first.",
+    "cli.setup.error.mkcertInstallExample": "Example: brew install mkcert && mkcert -install",
     "cli.start.progress.prepare": "Loading saved viveworker config...",
     "cli.start.progress.refreshPairing": "Refreshing expired pairing credentials...",
     "cli.start.progress.launchd": "Starting the launchd service...",
@@ -583,11 +589,11 @@ const translations = {
     "tab.diff.title": "差分",
     "tab.diff.label": "差分",
     "tab.diff.eyebrow": "現在の変更",
-    "tab.diff.description": "Codex が残している現在の未ステージ変更を iPhone で確認します。",
+    "tab.diff.description": "Codex が残している現在の未ステージ変更を端末で確認します。",
     "tab.code.title": "コード",
     "tab.code.label": "コード",
     "tab.code.eyebrow": "現在の変更",
-    "tab.code.description": "Codex が残している現在の未ステージ変更を iPhone で確認します。",
+    "tab.code.description": "Codex が残している現在の未ステージ変更を端末で確認します。",
     "tab.completed.title": "完了",
     "tab.completed.label": "完了",
     "tab.completed.eyebrow": "履歴",
@@ -597,34 +603,34 @@ const translations = {
     "tab.settings.eyebrow": "端末",
     "tab.settings.description": "ペアリング、インストール、通知の設定です。",
     "pair.copy":
-      "この iPhone をローカルの Codex desktop session とペアリングして、承認、プラン、選択、完了をすぐ確認できるようにします。",
+      "この端末をローカルの Codex desktop session とペアリングして、承認、プラン、選択、完了をすぐ確認できるようにします。",
     "pair.codeLabel": "ペアリングコード",
     "pair.codePlaceholder": "ペアリングコードを入力",
-    "pair.connect": "この iPhone を接続",
+    "pair.connect": "この端末を接続",
     "pair.installFromHomeScreen":
       "この pairing link はホーム画面アプリ用に温存されています。Safari から viveworker をホーム画面に追加し、新しいアイコンを開いてそこで pairing を完了してください。",
     "pair.helperTitle": "ホーム画面に追加",
     "pair.helperCopy": "モバイル表示と Web Push を最適に使うには viveworker をインストールしてください。",
     "banner.install.title": "viveworker をホーム画面に追加",
     "banner.install.copy.safari":
-      "Safari からインストールすると、iPhone 向け表示とバックグラウンド通知が使いやすくなります。",
+      "Safari からインストールすると、モバイル向け表示とバックグラウンド通知が使いやすくなります。",
     "banner.install.copy.other": "Safari でこのページを開いて、viveworker をホーム画面に追加してください。",
     "banner.push.title": "プッシュ通知を有効にすると便利です",
     "banner.push.copy.https": "プッシュ通知を使うには HTTPS の viveworker を開いてください。",
-    "banner.push.copy.standalone": "iPhone でプッシュ通知を受けるには、viveworker をホーム画面に追加してください。",
+    "banner.push.copy.standalone": "この端末でプッシュ通知を受けるには、viveworker をホーム画面に追加してください。",
     "banner.push.copy.denied":
-      "このアプリの通知は現在ブロックされています。あとで iPhone の設定から再度有効にできます。",
+      "このアプリの通知は現在ブロックされています。あとで端末の設定から再度有効にできます。",
     "banner.push.copy.default":
       "バックグラウンドでも承認、プラン、質問、完了に気づけるよう、プッシュ通知を有効にしてください。",
     "install.guide.title": "ホーム画面に追加",
     "install.guide.intro.safari":
-      "iPhone ではサイト側から直接追加できませんが、数タップでホーム画面に追加できます。",
-    "install.guide.intro.other": "iPhone では Safari からホーム画面に追加するのが最適です。",
+      "このブラウザではサイト側から直接追加できませんが、数タップでホーム画面に追加できます。",
+    "install.guide.intro.other": "ここでホーム画面に追加できない場合は、Safari など対応ブラウザでこのページを開いてください。",
     "install.guide.step.openSafari": "この URL を Safari で開きます。",
     "install.guide.step.tapShare": "共有ボタンをタップします。",
     "install.guide.step.chooseAdd": "「ホーム画面に追加」を選びます。",
     "install.guide.step.tapAdd": "「追加」を押して、新しいアイコンを開きます。",
-    "shell.subtitle.settings": "この iPhone のペアリング、通知、インストール設定です。",
+    "shell.subtitle.settings": "この端末のペアリング、通知、インストール設定です。",
     "shell.subtitle.detail": "いまの流れを途切れさせずに、項目を確認して操作できます。",
     "empty.pending": "いま対応が必要な項目はありません。新しい承認、プラン、選択がここに表示されます。",
     "empty.timeline": "まだタイムライン項目はありません。新しい会話の更新がここに表示されます。",
@@ -662,7 +668,7 @@ const translations = {
     "reply.imageAddMore": "さらに画像を追加",
     "reply.imageReplace": "画像を差し替え",
     "reply.imageRemove": "削除",
-    "reply.imageHint": "iPhone の画像を最大 {count} 枚まで添付して、メッセージと一緒に送れます。",
+    "reply.imageHint": "この端末の画像を最大 {count} 枚まで添付して、メッセージと一緒に送れます。",
     "reply.imageAttached": "添付した画像",
     "reply.send": "Codex に送信",
     "reply.sendConfirm": "それでも送信",
@@ -740,34 +746,34 @@ const translations = {
     "diff.threadSummary": ({ count }) => `変更ファイル ${count}件`,
     "diff.latestChange": "最終変更",
     "diff.latestChangeFallback": "このスレッドに現在未ステージの変更があります。",
-    "settings.intro": "この iPhone のペアリング、言語、インストール状況、Web Push の状態を確認できます。",
+    "settings.intro": "この端末のペアリング、言語、インストール状況、Web Push の状態を確認できます。",
     "settings.section.overview": "クイック確認",
     "settings.section.notifications": "通知",
     "settings.section.install": "インストール",
-    "settings.section.device": "この iPhone",
+    "settings.section.device": "この端末",
     "settings.group.general": "一般",
-    "settings.group.device": "この iPhone",
+    "settings.group.device": "この端末",
     "settings.group.values": "設定値",
     "settings.group.advanced": "詳細設定",
     "settings.group.actions": "操作",
     "settings.overview.title": "ひと目で確認",
-    "settings.overview.copy": "この iPhone で準備できていること、まだ必要な設定、次にやることをまとめて確認できます。",
+    "settings.overview.copy": "この端末で準備できていること、まだ必要な設定、次にやることをまとめて確認できます。",
     "settings.summary.notifications": "通知",
     "settings.summary.install": "ホーム画面",
     "settings.summary.pairing": "ペアリング",
     "settings.nextStep.eyebrow": "次の一手",
     "settings.nextStep.enableNotifications.title": "通知を有効にする",
-    "settings.nextStep.enableNotifications.copy": "この iPhone で Web Push を有効にすると、承認や質問をバックグラウンドでも受け取れます。",
+    "settings.nextStep.enableNotifications.copy": "この端末で Web Push を有効にすると、承認や質問をバックグラウンドでも受け取れます。",
     "settings.nextStep.serverDisabled.title": "サーバー側の設定がまだ必要です",
-    "settings.nextStep.serverDisabled.copy": "この viveworker サーバーでは Web Push がまだ有効ではないため、この iPhone からは購読できません。",
+    "settings.nextStep.serverDisabled.copy": "この viveworker サーバーでは Web Push がまだ有効ではないため、この端末からは購読できません。",
     "settings.nextStep.openHttps.title": "HTTPS 版を開く",
-    "settings.nextStep.openHttps.copy": "iPhone で通知を有効にするには、このページを HTTPS で開く必要があります。",
+    "settings.nextStep.openHttps.copy": "この端末で通知を有効にするには、このページを HTTPS で開く必要があります。",
     "settings.nextStep.install.title": "ホーム画面に追加する",
-    "settings.nextStep.install.copy": "Safari からアプリを追加し、ホーム画面版を開き直してから通知を有効にしてください。",
+    "settings.nextStep.install.copy": "アプリをホーム画面に追加し、インストール版を開き直してから通知を有効にしてください。",
     "settings.nextStep.permissionBlocked.title": "通知がブロックされています",
-    "settings.nextStep.permissionBlocked.copy": "iPhone の設定で通知を再許可してから、ここへ戻ってもう一度確認してください。",
+    "settings.nextStep.permissionBlocked.copy": "端末の設定で通知を再許可してから、ここへ戻ってもう一度確認してください。",
     "settings.nextStep.test.title": "準備は完了です",
-    "settings.nextStep.test.copy": "テスト通知を送って、この iPhone が viveworker の push を受け取れるか確認できます。",
+    "settings.nextStep.test.copy": "テスト通知を送って、この端末が viveworker の push を受け取れるか確認できます。",
     "settings.status.notAvailable": "未対応",
     "settings.status.unsupported": "非対応",
     "settings.status.needsHttps": "HTTPS が必要",
@@ -785,7 +791,7 @@ const translations = {
     "settings.notifications.serverDisabled": "サーバー側で Web Push がまだ有効化されていません。",
     "settings.notifications.openHttps": "通知を有効にする前に、HTTPS の viveworker を開いてください。",
     "settings.notifications.openHomeScreen":
-      "iPhone では通知を有効にする前に、ホーム画面に追加したアプリを開いてください。",
+      "この端末で通知を有効にする前に、ホーム画面に追加したアプリを開いてください。",
     "settings.action.enableNotifications": "通知を有効化",
     "settings.action.disableNotifications": "通知を無効化",
     "settings.action.sendTest": "テスト通知を送信",
@@ -794,7 +800,7 @@ const translations = {
     "settings.action.removeThisDevice": "この端末を削除",
     "settings.install.title": "ホーム画面に追加",
     "settings.install.copy":
-      "iPhone で最も使いやすい体験にするには、Safari から viveworker をホーム画面に追加してください。",
+      "いちばん使いやすい体験にするには、viveworker をホーム画面に追加して、インストール版を開いてください。",
     "settings.device.title": "Devices",
     "settings.device.copy": "この LAN 上で viveworker を開ける信頼済み端末を管理します。",
     "settings.device.count": ({ count }) => `${count} 台の端末`,
@@ -804,7 +810,7 @@ const translations = {
     "settings.device.emptyCurrent": "この端末の情報はまだ表示できません。",
     "settings.device.emptyOther": "他に有効な信頼済み端末はありません。",
     "settings.device.addAnother.title": "端末を追加する",
-    "settings.device.addAnother.heading": "新しい iPhone / ブラウザを追加",
+    "settings.device.addAnother.heading": "新しい端末 / ブラウザを追加",
     "settings.device.addAnother.copy":
       "別の端末を追加したいときだけ、Mac で次のコマンドを実行します。通常の app URL は変わりません。",
     "settings.device.addAnother.commandLabel": "Mac で実行",
@@ -817,12 +823,12 @@ const translations = {
     "settings.device.mode.standalone": "ホーム画面アプリ",
     "settings.device.mode.browser": "ブラウザ",
     "settings.language.title": "言語",
-    "settings.language.copy": "この iPhone で viveworker を表示する言語を選びます。",
+    "settings.language.copy": "この端末で viveworker を表示する言語を選びます。",
     "settings.pairing.title": "ペアリング",
-    "settings.pairing.copy": "この iPhone はローカルの Codex desktop session とペアリングされています。",
+    "settings.pairing.copy": "この端末はローカルの Codex desktop session とペアリングされています。",
     "settings.pairing.connected": "ペアリング済み",
     "settings.technical.title": "技術情報",
-    "settings.technical.copy": "この iPhone の接続状態や通知状態を確認できます。",
+    "settings.technical.copy": "この端末の接続状態や通知状態を確認できます。",
     "settings.technical.copyShort": "接続や通知の診断情報です。",
     "settings.row.deviceId": "Device ID",
     "settings.row.pairedAt": "初回ペアリング",
@@ -849,11 +855,11 @@ const translations = {
     "notice.loggedOutKeepTrusted": "ログアウトしました。この端末の信頼は維持されるので、次回は再 pairing なしで戻れます。",
     "notice.loggedOutDeviceRemoved": "ログアウトし、この端末の信頼も削除しました。次回は再 pairing が必要です。",
     "error.networkHint":
-      "最新の HTTPS URL を Safari で開き直して、必要ならホーム画面アプリを追加し直してください。",
+      "最新の HTTPS URL をブラウザで開き直して、必要ならホーム画面アプリを追加し直してください。",
     "error.webPushDisabled": "サーバー側で Web Push が有効ではありません。",
     "error.notificationsRequireHttps": "通知には HTTPS が必要です。",
     "error.pushUnsupported": "このブラウザは Web Push に対応していません。",
-    "error.openHomeScreen": "iPhone では通知を有効にする前に、ホーム画面の viveworker を開いてください。",
+    "error.openHomeScreen": "この端末で通知を有効にする前に、ホーム画面の viveworker を開いてください。",
     "error.notificationPermission": ({ status }) => `通知権限は ${status} です。`,
     "error.pushServerNotReady": "サーバー側で Web Push の準備ができていません。",
     "error.serviceWorkerUnavailable": "Service Worker は利用できません。",
@@ -902,7 +908,7 @@ const translations = {
     "server.message.fileApprovalNeeded": "ファイル変更の承認が必要です。",
     "server.message.commandPrefix": ({ command }) => `Command: ${command}`,
     "server.message.pathPrefix": ({ path }) => `Path: ${path}`,
-    "server.message.approveOnMac": "Mac で承認してください: この iPhone 通知は codex.app の鏡像です。",
+    "server.message.approveOnMac": "Mac で承認してください: この端末の通知は codex.app の鏡像です。",
     "server.message.approvalNeededInCodex": "Codex で承認が必要です。",
     "server.message.extraApprovals": ({ count }) => `追加の承認: ${count}`,
     "server.message.taskFinished": "タスクが完了しました。",
@@ -920,7 +926,7 @@ const translations = {
     "server.confirm.approve": "この承認を確定して Codex を続行します。",
     "server.confirm.reject": "この操作を拒否して Codex に続行しないよう伝えます。",
     "server.pushTest.title": "viveworker テスト通知",
-    "server.pushTest.body": "この iPhone で通知が動作しています。",
+    "server.pushTest.body": "この端末で通知が動作しています。",
     "server.page.notFoundTitle": "見つかりません",
     "server.page.notFoundBody": "この承認リンクは存在しません。",
     "server.page.notFoundHint": "このページは閉じて大丈夫です。",
@@ -963,18 +969,18 @@ const translations = {
     "cli.setup.webPushEnabled": "Web Push: enabled (HTTPS)",
     "cli.setup.webPushDisabled": "Web Push: disabled",
     "cli.setup.completePending": "viveworker の setup は完了しましたが、まだ health 応答は確認できていません。",
-    "cli.setup.caFlow.title": "iPhone で viveworker を開く前に、まずローカルの証明書をインストールしてください:",
-    "cli.setup.caFlow.step1": "1. 下の CA download URL を開くか QR を読み取り、iPhone で rootCA.pem を取得します。",
-    "cli.setup.caFlow.step2": "2. rootCA.pem をインストールし、iPhone の証明書信頼設定でその証明書を信頼します。",
+    "cli.setup.caFlow.title": "端末で viveworker を開く前に、必要ならローカルの証明書をインストールしてください:",
+    "cli.setup.caFlow.step1": "1. 下の CA download URL を開くか QR を読み取り、端末で rootCA.pem を取得します。",
+    "cli.setup.caFlow.step2": "2. rootCA.pem をインストールし、必要なら端末側でその証明書を信頼します。",
     "cli.setup.caFlow.step3": "3. そのあと、このターミナルで Enter を押すと viveworker の接続先 URL と Pairing QR を表示します。",
     "cli.setup.instructions.https":
-      "Safari で HTTPS URL を開き、iPhone でローカル CA を信頼してから、ホーム画面に追加して通知を有効にしてください。",
+      "ブラウザで HTTPS URL を開き、必要ならローカル CA を信頼してから、ホーム画面に追加して通知を有効にしてください。",
     "cli.setup.instructions.afterCa":
-      "次に iPhone の Safari で Pairing URL を開き、必要ならペアリングしてから、viveworker をホーム画面に追加してください。",
+      "次に端末のブラウザで Pairing URL を開き、必要ならペアリングしてから、viveworker をホーム画面に追加してください。",
     "cli.setup.instructions.insecureHttpLan":
-      "HTTP URL は、LAN 上の平文アクセスを明示的に許可した場合だけ Safari で開いてください。共有 Wi-Fi では非推奨です。",
+      "HTTP URL は、LAN 上の平文アクセスを明示的に許可した場合だけブラウザで開いてください。共有 Wi-Fi では非推奨です。",
     "cli.setup.instructions.localOnlyHttp":
-      "この setup はローカル開発用の loopback-only HTTP です。iPhone から使うなら既定の HTTPS setup か --allow-insecure-http-lan を使ってください。",
+      "この setup はローカル開発用の loopback-only HTTP です。別の端末から使うなら既定の HTTPS setup か --allow-insecure-http-lan を使ってください。",
     "logout.confirm.title": "ログアウト方法を選んでください",
     "logout.confirm.copy": "session だけ終えることも、この端末の信頼ごと削除して次回 pairing 必須にすることもできます。",
     "logout.confirm.keepTrustedTitle": "ログアウトのみ",
@@ -990,6 +996,12 @@ const translations = {
     "cli.setup.qrPairing": "Pairing QR:",
     "cli.setup.qrCaDownload": "rootCA.pem download QR (IP):",
     "cli.setup.prompt.continueToApp": "viveworker の接続先 URL を表示するには Enter を押してください。",
+    "cli.setup.error.mkcertInstallFailed": "Homebrew で mkcert をインストールできませんでした。",
+    "cli.setup.error.mkcertInstallPermission":
+      "Homebrew は見つかりましたが、その prefix に現在のユーザーの書き込み権限がないため、viveworker が mkcert を自動インストールできませんでした。",
+    "cli.setup.error.mkcertInstallNext":
+      "`npx viveworker setup --install-mkcert` をやり直す前に Homebrew の権限を直すか、先に mkcert を手動でインストールしてください。",
+    "cli.setup.error.mkcertInstallExample": "例: brew install mkcert && mkcert -install",
     "cli.start.progress.prepare": "保存済みの viveworker 設定を読み込んでいます...",
     "cli.start.progress.refreshPairing": "期限切れの pairing 情報を更新しています...",
     "cli.start.progress.launchd": "launchd サービスを起動しています...",