release(desktop): v0.1.1 with single-instance and tray UX fixes

Enforce single-instance startup, refresh tray menu before popup on Windows, and make the tray entry always show or focus the main window. Clear transient proxy/update status when leaving Settings, and bump the desktop shell to v0.1.1.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: joohw

electron/main.js

@@ -20,8 +20,14 @@ app.commandLine.appendSwitch("enable-features", "OverlayScrollbar,FluentOverlayS
 fs.mkdirSync(electronUserDataDir(), { recursive: true });
 app.setPath("userData", electronUserDataDir());
 
+const gotSingleInstanceLock = app.requestSingleInstanceLock();
+if (!gotSingleInstanceLock) {
+  app.quit();
+}
+
 let mainWindow = null;
 let tray = null;
+let trayContextMenu = null;
 let runningProcess = null;
 let quitting = false;
 const THEME_STORAGE_KEY = "clovapi-theme";
@@ -105,6 +111,7 @@ function showMainWindow(options = {}) {
   mainWindow.show();
   if (process.platform === "darwin") app.dock?.show();
   mainWindow.focus();
+  void updateTrayMenu();
   if (!eventPayload) return;
   const sendAppEvent = () => dispatchRendererEvent(eventPayload);
   if (created || mainWindow.webContents.isLoading()) {
@@ -117,14 +124,7 @@ function showMainWindow(options = {}) {
 function hideMainWindow() {
   if (!mainWindow || mainWindow.isDestroyed()) return;
   mainWindow.hide();
-}
-
-function toggleMainWindow() {
-  if (!mainWindow || mainWindow.isDestroyed() || !mainWindow.isVisible()) {
-    showMainWindow();
-    return;
-  }
-  hideMainWindow();
+  void updateTrayMenu();
 }
 
 async function readTrayProxyState() {
@@ -214,7 +214,6 @@ async function updateTrayMenu() {
   if (!tray) return;
   const [state, desktop] = await Promise.all([readTrayProxyState(), readTrayDesktopState()]);
   const model = buildTrayMenuModel({
-    visible: Boolean(mainWindow && !mainWindow.isDestroyed() && mainWindow.isVisible()),
     running: state.running,
     port: state.port,
     external: state.external,
@@ -227,7 +226,7 @@ async function updateTrayMenu() {
   const template = [
     {
       label: model.windowLabel,
-      click: () => toggleMainWindow(),
+      click: () => showMainWindow(),
     },
     {
       label: model.profilesLabel,
@@ -300,13 +299,29 @@ async function updateTrayMenu() {
       },
     },
   ];
-  tray.setContextMenu(Menu.buildFromTemplate(template));
+  trayContextMenu = Menu.buildFromTemplate(template);
+  if (process.platform === "darwin") {
+    tray.setContextMenu(trayContextMenu);
+  }
+}
+
+function openTrayContextMenu() {
+  if (!tray || !trayContextMenu) return;
+  tray.popUpContextMenu(trayContextMenu);
 }
 
 function createTray() {
   if (tray) return tray;
   tray = new Tray(createTrayImage());
-  tray.on("click", () => toggleMainWindow());
+  tray.on("click", () => showMainWindow());
+  if (process.platform !== "darwin") {
+    tray.on("right-click", () => {
+      void (async () => {
+        await updateTrayMenu();
+        openTrayContextMenu();
+      })();
+    });
+  }
   void updateTrayMenu();
   return tray;
 }
@@ -1019,25 +1034,31 @@ ipcMain.handle("cli:tool-status", async () => {
   return { ok: false, available: false, source: "none", path: "", error: "No bundled or system clovapi found" };
 });
 
-app.whenReady().then(async () => {
-  nativeTheme.themeSource = "light";
-  createWindow();
-  createTray();
-  watchCoreDevBinary();
-  try {
-    await proxyManager.autostartIfAllowed();
-  } catch {
-    // Non-fatal on startup
-  }
-  await updateTrayMenu();
+if (gotSingleInstanceLock) {
+  app.on("second-instance", () => {
+    showMainWindow();
+  });
 
-  app.on("activate", () => {
-    if (BrowserWindow.getAllWindows().length === 0) {
-      createWindow();
+  app.whenReady().then(async () => {
+    nativeTheme.themeSource = "light";
+    createWindow();
+    createTray();
+    watchCoreDevBinary();
+    try {
+      await proxyManager.autostartIfAllowed();
+    } catch {
+      // Non-fatal on startup
     }
-    showMainWindow();
+    await updateTrayMenu();
+
+    app.on("activate", () => {
+      if (BrowserWindow.getAllWindows().length === 0) {
+        createWindow();
+      }
+      showMainWindow();
+    });
   });
-});
+}
 
 app.on("before-quit", () => {
   quitting = true;

electron/package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "clovapi-desktop-minimal",
   "private": true,
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Minimal desktop CLI runner for ClovAPI",
   "main": "main.js",
   "type": "commonjs",

electron/package.json

@@ -166,13 +166,12 @@ function resolveActiveBindings(state = {}) {
 }
 
 function buildTrayMenuModel(state = {}) {
-  const visible = Boolean(state.visible);
   const running = Boolean(state.running);
   const port = Number(state.port) || 27483;
   const bindings = resolveActiveBindings(state);
 
   return {
-    windowLabel: visible ? "Hide ClovAPI Switcher" : "Show ClovAPI Switcher",
+    windowLabel: "Show ClovAPI Switcher",
     profilesLabel: "Open Profiles",
     settingsLabel: "Open Settings",
     logsLabel: "Open Call Logs",

electron/tray-menu.js

@@ -96,7 +96,6 @@ test("resolveActiveBindings maps active selections to vendor/model labels", () =
 
 test("buildTrayMenuModel exposes safe proxy actions and active models", () => {
   const running = buildTrayMenuModel({
-    visible: true,
     running: true,
     managed: true,
     port: 27483,
@@ -109,7 +108,7 @@ test("buildTrayMenuModel exposes safe proxy actions and active models", () => {
     ],
     active: { hermes: { provider_id: "custom-api", model_id: "gpt-4.1" } },
   });
-  assert.equal(running.windowLabel, "Hide ClovAPI Switcher");
+  assert.equal(running.windowLabel, "Show ClovAPI Switcher");
   assert.equal(running.canStartProxy, false);
   assert.equal(running.startProxyLabel, "Start Proxy on :27483");
   assert.match(running.statusLabel, /Proxy running/);
@@ -125,7 +124,7 @@ test("buildTrayMenuModel exposes safe proxy actions and active models", () => {
   ]);
   assert.equal("canStopProxy" in running, false);
 
-  const stopped = buildTrayMenuModel({ visible: false, running: false, port: 3000 });
+  const stopped = buildTrayMenuModel({ running: false, port: 3000 });
   assert.equal(stopped.windowLabel, "Show ClovAPI Switcher");
   assert.equal(stopped.canStartProxy, true);
   assert.equal(stopped.startProxyLabel, "Start Proxy on :3000");

electron/tray-menu.test.js

@@ -1,7 +1,6 @@
 <script lang="ts">
   import type { Snippet } from "svelte";
   import { cn } from "$lib/utils.js";
-  import { i18n, t } from "../lib/i18n";
   import type { ModelTestStatus } from "../global";
 
   let {
@@ -10,7 +9,6 @@
     showStatusDot = false,
     testStatus = "",
     testSummary = "",
-    testDetail = "",
     muted = false,
     indent = false,
     linesNowrap = false,
@@ -24,7 +22,6 @@
     showStatusDot?: boolean;
     testStatus?: "" | ModelTestStatus;
     testSummary?: string;
-    testDetail?: string;
     muted?: boolean;
     indent?: boolean;
     linesNowrap?: boolean;
@@ -53,10 +50,6 @@
       testStatus !== "pass" && testStatus !== "fail" && testStatus !== "testing" && "text-muted-foreground",
     ),
   );
-  const viewDetailsLabel = $derived.by(() => {
-    void i18n.locale;
-    return t("common.viewDetails");
-  });
 </script>
 
 {#snippet titleRow(clickable: boolean)}
@@ -121,16 +114,6 @@
           {line}
         </p>
       {/each}
-      {#if testDetail && (testStatus === "pass" || testStatus === "fail")}
-        <details class="group text-xs">
-          <summary class="cursor-pointer text-muted-foreground hover:text-foreground">{viewDetailsLabel}</summary>
-          <!-- svelte-ignore a11y_no_noninteractive_tabindex -->
-          <pre
-            class="mt-1.5 max-h-48 overflow-auto rounded-md border border-border bg-muted/40 p-2 font-mono text-[11px] leading-relaxed break-words whitespace-pre-wrap"
-            tabindex="0"
-          >{testDetail}</pre>
-        </details>
-      {/if}
     </div>
   </div>
   <div class="flex shrink-0 flex-wrap items-center gap-2 sm:justify-end">

electron/ui/src/components/ListRow.svelte

@@ -82,7 +82,6 @@
     lines={electronDev ? [copy.versionLine, copy.updateDisabledInDev] : [copy.versionLine]}
     testStatus={electronDev ? "" : rowTestStatus(coreUpdateCheck?.status)}
     testSummary={electronDev ? "" : coreUpdateCheck?.summary || ""}
-    testDetail={electronDev ? "" : coreUpdateCheck?.detail || ""}
   >
     {#snippet actions()}
       {#if !electronDev}

electron/ui/src/components/ProxyPanel.svelte

@@ -37,7 +37,6 @@ const en = {
     empty: "(empty)",
     noOutput: "(no output)",
     loading: "Loading…",
-    viewDetails: "View details",
   },
   vendor: {
     claudeSubscription: "Claude Subscription",
@@ -127,7 +126,6 @@ const en = {
     updateUpToDate: "Up to date",
     updateAvailable: "Update available · v{latest}",
     updateInstalled: "Updated to v{version}",
-    updateInstalledPath: "Installed at {path}",
     updateDisabledInDev: "Update checks are disabled in dev mode",
     pathHint: "/{providerId}/{modelId}/{apiStyle}",
   },

electron/ui/src/lib/i18n/locales/en.ts

@@ -39,7 +39,6 @@ const zh = {
     empty: "(空)",
     noOutput: "(无输出)",
     loading: "加载中…",
-    viewDetails: "查看详情",
   },
   vendor: {
     claudeSubscription: "Claude 订阅",
@@ -125,7 +124,6 @@ const zh = {
     updateUpToDate: "已是最新版本",
     updateAvailable: "有可用更新 · v{latest}",
     updateInstalled: "已更新至 v{version}",
-    updateInstalledPath: "安装路径 {path}",
     updateDisabledInDev: "开发模式不检查更新",
     pathHint: "/{providerId}/{modelId}/{apiStyle}",
   },

electron/ui/src/lib/i18n/locales/zh.ts

@@ -30,6 +30,10 @@ export function setActiveTab(tab: TabId) {
   if (store.activeTab === "system-logs" && tab !== "system-logs") {
     store.proxySystemLogSelectedId = null;
   }
+  if (store.activeTab === "settings" && tab !== "settings") {
+    store.coreUpdateCheck = null;
+    store.proxyHealthTest = null;
+  }
   store.activeTab = tab;
   if (tab === "profiles") {
     void (async () => {