@vibeapi/api-helper 0.0.148 → 0.0.149

package/dist/lib/tools/desktop-process.d.ts

@@ -13,13 +13,16 @@ export declare const WINDOWS_PACKAGE_FAMILIES: string[];
 declare let run: (command: string, args: string[], timeout?: number) => {
     status: number | null;
     stdout: string;
+    stderr?: string;
 };
 /** Tests replace the process runner. */
 export declare function setDesktopProcessRunnerForTests(fake: typeof run): void;
 export declare function isDesktopRunning(): boolean;
 /** Whether this platform supports `restartDesktop()`. */
 export declare function canRestartDesktop(): boolean;
-/** Quit (gracefully, then forcibly); true when no instance is left. */
+/** The last `quitDesktop()` was turned down by the app (a confirmation open, work running); it is still running. */
+export declare function desktopQuitRefused(): boolean;
+/** Quit (gracefully, then forcibly); true when no instance is left. A quit the app turns down on macOS is left alone (see `quitChatgpt`). */
 export declare function quitDesktop(): boolean;
 /** Start the installed app; true when it is running afterwards. */
 export declare function launchDesktop(): boolean;

package/dist/lib/tools/desktop-process.js

@@ -1 +1 @@
-import{spawnSync as e}from"child_process";import{logger as t}from"../../utils/logger.js";import{powerShellEnv as r}from"../powershell-env.js";export const WINDOWS_PACKAGE_FAMILIES=["Claude_pzs8sxrjxfjjc","AnthropicPBC.Claude_fnn82j28hfe8t"];const o="Get-Process -Name claude -ErrorAction SilentlyContinue | Where-Object { $_.Path -and ($_.Path -like '*\\AnthropicClaude\\*' -or $_.Path -like '*\\Programs\\Claude\\*' -or $_.Path -like '*\\WindowsApps\\*Claude*') }";let s=(o,s,n=3e4)=>{const i=e(o,s,{encoding:"utf-8",timeout:n,windowsHide:!0,stdio:["ignore","pipe","pipe"],env:r()});return i.error&&t.logError(`desktop-process: ${o}`,i.error),{status:i.status,stdout:`${i.stdout??""}`}};export function setDesktopProcessRunnerForTests(e){s=e}function n(e,t){return s("powershell.exe",["-NoProfile","-NonInteractive","-Command",e],t)}function i(e){Atomics.wait(new Int32Array(new SharedArrayBuffer(4)),0,0,e)}export function isDesktopRunning(){return"darwin"===process.platform?0===s("pgrep",["-x","Claude"]).status:"win32"===process.platform&&Number(n(`@(${o}).Count`).stdout.trim())>0}export function canRestartDesktop(){return"darwin"===process.platform||"win32"===process.platform}export function quitDesktop(){if("darwin"===process.platform){s("osascript",["-e",'quit app "Claude"']);for(let e=0;e<30&&isDesktopRunning();e++)i(500);isDesktopRunning()&&s("pkill",["-x","Claude"]),i(1e3)}else{if("win32"!==process.platform)return!1;n([`$p = @(${o})`,"$p | ForEach-Object { [void]$_.CloseMainWindow() }","Start-Sleep -Seconds 3","$p | Where-Object { -not $_.HasExited } | Stop-Process -Force -ErrorAction SilentlyContinue","Start-Sleep -Seconds 1"].join("\n"),6e4)}return!isDesktopRunning()}export function launchDesktop(){if("darwin"===process.platform)s("open",["-a","Claude"]);else{if("win32"!==process.platform)return!1;n(["$squirrel = Join-Path $env:LOCALAPPDATA 'AnthropicClaude\\claude.exe'","$programs = Join-Path $env:LOCALAPPDATA 'Programs\\Claude\\Claude.exe'","if (Test-Path $squirrel) { Start-Process $squirrel }","elseif (Test-Path $programs) { Start-Process $programs }",`else { $pkg = Get-AppxPackage | Where-Object { @(${WINDOWS_PACKAGE_FAMILIES.map(e=>`'${e}'`).join(",")}) -contains $_.PackageFamilyName } | Select-Object -First 1`,"  if ($pkg) { $id = (Get-AppxPackageManifest $pkg).Package.Applications.Application.Id | Select-Object -First 1",'    Start-Process "shell:AppsFolder\\$($pkg.PackageFamilyName)!$id" } }'].join("\n"),6e4)}for(let e=0;e<20;e++){if(isDesktopRunning())return!0;i(500)}return!1}export function restartDesktop(){return!!canRestartDesktop()&&(quitDesktop(),launchDesktop())}
+import{spawnSync as e}from"child_process";import{logger as t}from"../../utils/logger.js";import{powerShellEnv as r}from"../powershell-env.js";export const WINDOWS_PACKAGE_FAMILIES=["Claude_pzs8sxrjxfjjc","AnthropicPBC.Claude_fnn82j28hfe8t"];const o="Get-Process -Name claude -ErrorAction SilentlyContinue | Where-Object { $_.Path -and ($_.Path -like '*\\AnthropicClaude\\*' -or $_.Path -like '*\\Programs\\Claude\\*' -or $_.Path -like '*\\WindowsApps\\*Claude*') }";let s=(o,s,n=3e4)=>{const i=e(o,s,{encoding:"utf-8",timeout:n,windowsHide:!0,stdio:["ignore","pipe","pipe"],env:r()});return i.error&&t.logError(`desktop-process: ${o}`,i.error),{status:i.status,stdout:`${i.stdout??""}`,stderr:`${i.stderr??""}`}};export function setDesktopProcessRunnerForTests(e){s=e}function n(e,t){return s("powershell.exe",["-NoProfile","-NonInteractive","-Command",e],t)}function i(e){Atomics.wait(new Int32Array(new SharedArrayBuffer(4)),0,0,e)}export function isDesktopRunning(){return"darwin"===process.platform?0===s("pgrep",["-x","Claude"]).status:"win32"===process.platform&&Number(n(`@(${o}).Count`).stdout.trim())>0}export function canRestartDesktop(){return"darwin"===process.platform||"win32"===process.platform}let a=!1;export function desktopQuitRefused(){return a}export function quitDesktop(){if(a=!1,"darwin"===process.platform){const e=s("osascript",["-e",'quit app "Claude"']);if((null===e.status||/\(-128\)|-1712/.test(e.stderr??""))&&isDesktopRunning())return a=!0,!1;for(let e=0;e<30&&isDesktopRunning();e++)i(500);isDesktopRunning()&&s("pkill",["-x","Claude"]),i(1e3)}else{if("win32"!==process.platform)return!1;n([`$p = @(${o})`,"$p | ForEach-Object { [void]$_.CloseMainWindow() }","Start-Sleep -Seconds 3","$p | Where-Object { -not $_.HasExited } | Stop-Process -Force -ErrorAction SilentlyContinue","Start-Sleep -Seconds 1"].join("\n"),6e4)}return!isDesktopRunning()}export function launchDesktop(){if("darwin"===process.platform)s("open",["-a","Claude"]);else{if("win32"!==process.platform)return!1;n(["$squirrel = Join-Path $env:LOCALAPPDATA 'AnthropicClaude\\claude.exe'","$programs = Join-Path $env:LOCALAPPDATA 'Programs\\Claude\\Claude.exe'","if (Test-Path $squirrel) { Start-Process $squirrel }","elseif (Test-Path $programs) { Start-Process $programs }",`else { $pkg = Get-AppxPackage | Where-Object { @(${WINDOWS_PACKAGE_FAMILIES.map(e=>`'${e}'`).join(",")}) -contains $_.PackageFamilyName } | Select-Object -First 1`,"  if ($pkg) { $id = (Get-AppxPackageManifest $pkg).Package.Applications.Application.Id | Select-Object -First 1",'    Start-Process "shell:AppsFolder\\$($pkg.PackageFamilyName)!$id" } }'].join("\n"),6e4)}for(let e=0;e<20;e++){if(isDesktopRunning())return!0;i(500)}return!1}export function restartDesktop(){return!!canRestartDesktop()&&!(!quitDesktop()&&a)&&launchDesktop()}

package/dist/lib/tools/tool-installs.d.ts

@@ -77,3 +77,11 @@ export declare function setVersionRunnerForTests(fake: (path: string) => string)
 export declare function forgetInstalls(): void;
 /** In PATH order (the first one is what the command starts), one entry per real file. Probed once per run. */
 export declare function findInstalls(spec: ToolInstallSpec): ToolInstall[];
+/**
+ * Like `findInstalls`, plus the vendor's native launcher when it exists but isn't on this process's PATH (just
+ * installed by the mirror script into ~/.local/bin, which a fresh shell profile only adds in new terminals).
+ * Such a copy comes last; `onPath` tells the caller to say "open a new terminal".
+ */
+export declare function findInstallsIncludingNative(spec: ToolInstallSpec): Array<ToolInstall & {
+    onPath: boolean;
+}>;

package/dist/lib/tools/tool-installs.js

@@ -1 +1 @@
-import{spawnSync as t}from"child_process";import{existsSync as r,realpathSync as n,statSync as e}from"fs";import{delimiter as o,dirname as s,isAbsolute as i,join as a}from"path";import{i18n as c}from"../i18n.js";import{toolHome as p}from"./types.js";import{brand as m}from"../brand.js";export const NPM_MIRROR="https://registry.npmmirror.com";export function brandInstallScripts(t){const r=m().installMirror?.scripts;return r?{sh:`${r}/${t}.sh`,ps1:`${r}/${t}.ps1`}:void 0}export function npmMirrorInstallCommand(t,r="latest"){return`npm install -g ${t.npmPackage}@${r} --registry=${NPM_MIRROR}`}const l=/^(\d+)\.(\d+)\.(\d+)$/;function u(t,r){const n=l.exec(t).slice(1).map(Number),e=l.exec(r).slice(1).map(Number);for(let o=0;o<3;o++)if(n[o]!==e[o])return n[o]>e[o]?t:r;return t}async function f(t,r,n){const e=await fetch(t,{signal:AbortSignal.timeout(r),headers:n});if(!e.ok)throw new Error(`HTTP ${e.status}`);return e.json()}export async function npmMirrorVersion(t){if(!t.npmPackage||!t.npmMirrorTagStale)return"latest";let r=d.get(t.npmPackage);return r||d.set(t.npmPackage,r=async function(t){try{const{version:r}=await f(`https://registry.npmjs.org/${t}/latest`,1e4);if("string"==typeof r&&l.test(r))return r}catch{}try{const r=await f(`${NPM_MIRROR}/${t}`,2e4,{accept:"application/vnd.npm.install-v1+json"}),n=Object.keys(r.versions??{}).filter(t=>l.test(t));if(n.length)return n.reduce(u)}catch{}return"latest"}(t.npmPackage)),r}const d=new Map;export function mirrorInstallCommand(t){return t.mirrorScript?"win32"===process.platform?`powershell -NoProfile -ExecutionPolicy Bypass -Command "irm ${t.mirrorScript.ps1} | iex"`:`curl -fsSL ${t.mirrorScript.sh} | sh`:t.npmPackage?npmMirrorInstallCommand(t):""}export function npmUninstallCommand(t){return`npm uninstall -g ${t.npmPackage}`}export function installLabel(t){return c.t("upgrade.install_label",{kind:c.t(`upgrade.kind.${t.kind}`),version:t.version??"?",path:t.path})}let g=r=>{const n={encoding:"utf-8",timeout:1e4,windowsHide:!0,stdio:["ignore","pipe","pipe"]};return`${(/\.cmd$/i.test(r)?t(`"${r}" --version`,{...n,shell:!0}):t(r,["--version"],n)).stdout??""}`};const h=new Map;export function setVersionRunnerForTests(t){g=t,h.clear(),d.clear()}export function forgetInstalls(){h.clear()}function $(t){try{return e(t).isFile()}catch{return!1}}function w(t,e){if(t.native&&(o=s(e),i=a(p(),...t.native.binDir),"win32"===process.platform?o.toLowerCase()===i.toLowerCase():o===i))return"native";var o,i;const c=t.npmPackage?a("node_modules",...t.npmPackage.split("/")):null;if(c&&r(a(s(e),c)))return"npm";let m=e;try{m=n(e)}catch{return"other"}return c&&m.includes(c)?"npm":/[\\/](Cellar|Caskroom)[\\/]/.test(m)?"brew":"other"}export function findInstalls(t){const r=h.get(t.command);if(r)return r;const e="win32"===process.platform?[`${t.command}.exe`,`${t.command}.cmd`]:[t.command],s=new Set,c=[];for(const r of(process.env.PATH??"").split(o))if(r&&i(r))for(const o of e){const e=a(r,o);if(!$(e))continue;let i=e;try{i=n(e)}catch{}const p="win32"===process.platform?i.toLowerCase():i;if(s.has(p))continue;s.add(p);const m=g(e).match(/(\d+)\.(\d+)\.(\d+)/);c.push({path:e,kind:w(t,e),version:m?m[0]:null})}return h.set(t.command,c),c}
+import{spawnSync as t}from"child_process";import{existsSync as n,realpathSync as r,statSync as e}from"fs";import{delimiter as o,dirname as s,isAbsolute as i,join as a}from"path";import{i18n as c}from"../i18n.js";import{toolHome as p}from"./types.js";import{brand as m}from"../brand.js";export const NPM_MIRROR="https://registry.npmmirror.com";export function brandInstallScripts(t){const n=m().installMirror?.scripts;return n?{sh:`${n}/${t}.sh`,ps1:`${n}/${t}.ps1`}:void 0}export function npmMirrorInstallCommand(t,n="latest"){return`npm install -g ${t.npmPackage}@${n} --registry=${NPM_MIRROR}`}const l=/^(\d+)\.(\d+)\.(\d+)$/;function u(t,n){const r=l.exec(t).slice(1).map(Number),e=l.exec(n).slice(1).map(Number);for(let o=0;o<3;o++)if(r[o]!==e[o])return r[o]>e[o]?t:n;return t}async function f(t,n,r){const e=await fetch(t,{signal:AbortSignal.timeout(n),headers:r});if(!e.ok)throw new Error(`HTTP ${e.status}`);return e.json()}export async function npmMirrorVersion(t){if(!t.npmPackage||!t.npmMirrorTagStale)return"latest";let n=d.get(t.npmPackage);return n||d.set(t.npmPackage,n=async function(t){try{const{version:n}=await f(`https://registry.npmjs.org/${t}/latest`,1e4);if("string"==typeof n&&l.test(n))return n}catch{}try{const n=await f(`${NPM_MIRROR}/${t}`,2e4,{accept:"application/vnd.npm.install-v1+json"}),r=Object.keys(n.versions??{}).filter(t=>l.test(t));if(r.length)return r.reduce(u)}catch{}return"latest"}(t.npmPackage)),n}const d=new Map;export function mirrorInstallCommand(t){return t.mirrorScript?"win32"===process.platform?`powershell -NoProfile -ExecutionPolicy Bypass -Command "irm ${t.mirrorScript.ps1} | iex"`:`curl -fsSL ${t.mirrorScript.sh} | sh`:t.npmPackage?npmMirrorInstallCommand(t):""}export function npmUninstallCommand(t){return`npm uninstall -g ${t.npmPackage}`}export function installLabel(t){return c.t("upgrade.install_label",{kind:c.t(`upgrade.kind.${t.kind}`),version:t.version??"?",path:t.path})}let h=n=>{const r={encoding:"utf-8",timeout:1e4,windowsHide:!0,stdio:["ignore","pipe","pipe"]};return`${(/\.cmd$/i.test(n)?t(`"${n}" --version`,{...r,shell:!0}):t(n,["--version"],r)).stdout??""}`};const g=new Map;export function setVersionRunnerForTests(t){h=t,g.clear(),d.clear()}export function forgetInstalls(){g.clear()}function $(t,n){return"win32"===process.platform?t.toLowerCase()===n.toLowerCase():t===n}function w(t){try{return e(t).isFile()}catch{return!1}}function v(t,e){if(t.native&&$(s(e),a(p(),...t.native.binDir)))return"native";const o=t.npmPackage?a("node_modules",...t.npmPackage.split("/")):null;if(o&&n(a(s(e),o)))return"npm";let i=e;try{i=r(e)}catch{return"other"}return o&&i.includes(o)?"npm":/[\\/](Cellar|Caskroom)[\\/]/.test(i)?"brew":"other"}export function findInstalls(t){const n=g.get(t.command);if(n)return n;const e="win32"===process.platform?[`${t.command}.exe`,`${t.command}.cmd`]:[t.command],s=new Set,c=[];for(const n of(process.env.PATH??"").split(o))if(n&&i(n))for(const o of e){const e=a(n,o);if(!w(e))continue;let i=e;try{i=r(e)}catch{}const p="win32"===process.platform?i.toLowerCase():i;if(s.has(p))continue;s.add(p);const m=h(e).match(/(\d+)\.(\d+)\.(\d+)/);c.push({path:e,kind:v(t,e),version:m?m[0]:null})}return g.set(t.command,c),c}export function findInstallsIncludingNative(t){const n=findInstalls(t).map(t=>({...t,onPath:!0}));if(!t.native)return n;const r=a(p(),...t.native.binDir),e="win32"===process.platform?[`${t.command}.exe`]:[t.command];for(const t of e){const e=a(r,t);if(!w(e)||n.some(t=>$(t.path,e)))continue;const o=h(e).match(/(\d+)\.(\d+)\.(\d+)/);n.push({path:e,kind:"native",version:o?o[0]:null,onPath:!1})}return n}

package/dist/lib/tools/types.d.ts

@@ -108,11 +108,18 @@ export interface CompanionApp {
     displayName: string;
     appInstaller: AppInstaller;
     installedVersion(): string | null;
-    runningApp?: {
-        isRunning(): boolean;
-        quit?(): boolean;
-        launch?(): boolean;
-    };
+    runningApp?: RunningApp;
+}
+/**
+ * A running desktop app vibecli may quit (after the user agreed) and start again. `quitRefused()`: the last
+ * `quit()` was turned down by the app itself (macOS: a task running or a confirmation open), so it is still
+ * running and the user has to confirm the quit in the app; it is never killed then.
+ */
+export interface RunningApp {
+    isRunning(): boolean;
+    quit?(): boolean;
+    quitRefused?(): boolean;
+    launch?(): boolean;
 }
 export interface ToolAdapter {
     /** Stable id used on the CLI and as the config key (e.g. `codex`). */
@@ -162,11 +169,8 @@ export interface ToolAdapter {
      * GUI apps that only read their config at start: setup and the wizard offer
      * to restart a running app after writing it.
      */
-    runningApp?: {
-        isRunning(): boolean;
+    runningApp?: RunningApp & {
         restart(): boolean;
-        quit?(): boolean;
-        launch?(): boolean;
     };
     /** The app itself can be installed and upgraded by vibecli; see {@link AppInstaller}. */
     appInstaller?: AppInstaller;

package/dist/locales/en_US.json

@@ -462,6 +462,83 @@
     "native_mirror_failed": "Couldn't replace from the mirror: {{reason}}",
     "install_label": "{{kind}} {{version}} ({{path}})"
   },
+  "components": {
+    "category": {
+      "runtime": "Runtimes",
+      "cli": "Command-line tools",
+      "app": "Desktop apps"
+    },
+    "col": {
+      "name": "Component",
+      "current": "Installed",
+      "latest": "Latest",
+      "managed": "Installed by",
+      "state": "State"
+    },
+    "by": {
+      "fnm": "fnm",
+      "brew": "Homebrew",
+      "nvm": "nvm",
+      "volta": "Volta",
+      "scoop": "Scoop",
+      "asdf": "asdf",
+      "mise": "mise",
+      "system": "system",
+      "standalone": "standalone",
+      "pipx": "pipx",
+      "pip": "pip",
+      "winget": "winget",
+      "git-for-windows-user": "Git for Windows (this user)",
+      "git-for-windows": "Git for Windows",
+      "xcode": "Apple Command Line Tools",
+      "native": "native",
+      "npm": "npm",
+      "app": "app",
+      "other": "other"
+    },
+    "state": {
+      "unsupported": "not available on this system",
+      "missing": "not installed: {{command}}",
+      "outdated_auto": "upgrade available: {{command}}",
+      "outdated_manual": "upgrade available: {{how}}",
+      "latest": "up to date",
+      "unknown_latest": "installed"
+    },
+    "source": "Source: {{source}}",
+    "latest_unknown": "Couldn't check the latest version of: {{tools}} (try {{cli}} list --refresh later)",
+    "unknown": "Unknown component: {{names}}",
+    "known": "Components: {{ids}}",
+    "unsupported_platform": "{{tool}} isn't available on this system",
+    "blocked_sudo": "Don't install {{tool}} with sudo: it would go into root's home directory and belong to root. Run it again without sudo",
+    "blocked_system": "This is the SYSTEM account; {{tool}} would go into the system profile. Run it again signed in as the person who uses it",
+    "blocked_unsupported_platform": "{{tool}} isn't available on this system",
+    "reason_sudo": "not with sudo",
+    "reason_system": "SYSTEM account",
+    "reason_unsupported_platform": "not available on this system",
+    "no_mirror": "Can't install {{tool}}: no install script location is configured",
+    "already_installed": "{{tool}} {{current}} is installed",
+    "up_to_date": "{{tool}} {{current}} is up to date",
+    "force_hint": "To reinstall it, run {{command}}",
+    "outdated_auto": "{{tool}} {{current}} can be upgraded to {{latest}}: run {{command}}",
+    "outdated_manual": "{{tool}} {{current}} can be upgraded to {{latest}}. It was installed with {{by}}, which {{cli}} leaves alone: run {{how}}; to add a copy {{cli}} manages, run {{command}}",
+    "no_latest": "{{tool}} {{current}} is managed by the system, {{cli}} doesn't upgrade it: {{how}}",
+    "how_system": "upgrade it the way it was installed (system package manager or the official installer), or add --force for a copy {{cli}} manages",
+    "how_xcode": "update the Command Line Tools in System Settings → General → Software Update",
+    "how_other": "upgrade it the way it was installed",
+    "force_beside": "{{tool}} is already at {{path}} (installed with {{by}}); --force adds a copy {{cli}} manages",
+    "installing": "Installing {{tool}} {{latest}} ({{source}})…",
+    "upgrading": "Upgrading {{tool}} to {{latest}} ({{source}})…",
+    "script_failed": "{{tool}} wasn't installed; see above. Then run {{command}}",
+    "installed": "Installed {{tool}} {{version}}",
+    "upgraded": "Upgraded {{tool}} from {{from}} to {{to}}",
+    "reinstalled": "Reinstalled {{tool}} {{version}}",
+    "reinstalling": "Reinstalling {{tool}} (--force; now {{current}})",
+    "path_shadowed": "Your terminal finds {{active}} first, not the {{tool}} {{version}} just installed ({{path}}): put the latter's directory earlier on PATH, or remove the former",
+    "capped": "{{tool}} {{latest}} doesn't run on this computer; the install script put in the newest one that does ({{version}}). Upgrades are offered again once a newer version is out",
+    "new_terminal": "Open a new terminal window to use it",
+    "migrating_globals": "The new Node doesn't have the packages installed globally before; installing the same versions: {{packages}}",
+    "migrate_failed": "Not all global packages made it to the new Node; run: {{command}}"
+  },
   "install": {
     "permission_unix": "npm probably cannot write its global directory. Either ① sudo {{command}}; or ② run npm config set prefix ~/.npm-global, add export PATH=~/.npm-global/bin:$PATH to ~/.zshrc or ~/.bashrc, open a new terminal and run {{command}}",
     "permission_windows": "Probably missing permissions or a file in use: close the tool if it is running, open an elevated terminal and run {{command}}",
@@ -851,18 +928,58 @@
         "doctor": "Check the common problems first"
       }
     },
+    "list": {
+      "summary": "List the runtimes, command-line tools and desktop apps {{cli}} can install, and which versions are installed",
+      "description": "Lists Node.js, Git, uv, Claude Code, Codex, Grok Build, Antigravity CLI, Claude Desktop and ChatGPT: installed or not, the installed and the latest version, how it was installed and where it comes from. Latest versions are cached for an hour; --refresh checks again now.",
+      "when": "To see which tools this computer has and which can be upgraded.",
+      "alt": {
+        "doctor": "Check the API key and each tool's config"
+      },
+      "opt": {
+        "refresh": "Check the latest versions again instead of using the cache"
+      },
+      "ex": {
+        "all": "List every component",
+        "refresh": "Check the latest versions again",
+        "json": "JSON output for scripts"
+      }
+    },
+    "install": {
+      "summary": "Install runtimes (Node.js, Git, uv), command-line tools or desktop apps",
+      "description": "Installs missing components from China-reachable mirrors, checking checksums (and, for desktop apps, the vendor's signature). One that is already installed is left as it is: its version is shown, with the upgrade command when it is behind; --force reinstalls it.\nNode.js, Git and uv are installed into your own user directory by {{brand}}'s install scripts, no administrator needed; don't use sudo. Several components can be given; what they depend on is installed first.",
+      "arg": {
+        "components": "node, git, uv, claude-code, codex, grok, agy, claude-desktop, chatgpt; several allowed"
+      },
+      "opt": {
+        "force": "Reinstall even when it is already installed"
+      },
+      "when": "To add a tool to this computer; other apps' install scripts can call it too (npx {{package}} install …).",
+      "needs": "Node.js on this computer ({{cli}} itself runs on Node); without Node, use the one-line installer first",
+      "alt": {
+        "upgrade": "Upgrade components that are installed",
+        "setup": "Then save your API key and configure the tools"
+      },
+      "ex": {
+        "runtimes": "Install Node.js and uv",
+        "clis": "Install Claude Code and Codex",
+        "app": "Install the ChatGPT desktop app (contains Codex)",
+        "force": "Reinstall uv",
+        "json": "Install from a script, JSON output"
+      }
+    },
     "upgrade": {
-      "summary": "Upgrade Claude Code, Codex, Claude Desktop, ChatGPT and other coding tools",
-      "description": "Upgrades each copy the way it was installed: native installs use the tool's own updater, npm installs are reinstalled from the China mirror (npmmirror), Homebrew installs use brew upgrade; if a native or Homebrew upgrade doesn't work, {{brand}}'s install script is used (programs from the China mirror). A named tool that is not installed yet is installed with that script.\nClaude Desktop and ChatGPT (with Codex inside; macOS / Windows) older than the download site's build are upgraded from the official installer there, after checking its checksum and the vendor's (Anthropic / OpenAI) signature; their own auto-update stays on, {{cli}} only steps in when they fall behind. A running app is only closed after a yes at a terminal; with --yes or without a terminal it is left running and only a hint is printed. Add --force to reinstall one that is already the latest. ChatGPT for Mac needs Apple silicon.\nWith no tool named, upgrades every installed one.\nTo update {{product}} itself, use {{cli}} update.",
+      "summary": "Upgrade coding tools, desktop apps and runtimes (Node.js, Git, uv)",
+      "description": "Upgrades each copy the way it was installed: native installs use the tool's own updater, npm installs are reinstalled from the China mirror (npmmirror), Homebrew installs use brew upgrade; if a native or Homebrew upgrade doesn't work, {{brand}}'s install script is used (programs from the China mirror). A named tool that is not installed yet is installed with that script.\nClaude Desktop and ChatGPT (with Codex inside; macOS / Windows) older than the download site's build are upgraded from the official installer there, after checking its checksum and the vendor's (Anthropic / OpenAI) signature; their own auto-update stays on, {{cli}} only steps in when they fall behind. A running app is only closed after a yes at a terminal; with --yes or without a terminal it is left running and only a hint is printed. Add --force to reinstall one that is already the latest. ChatGPT for Mac needs Apple silicon.\nNode.js, Git and uv are only upgraded where {{brand}}'s install scripts manage them (Node under fnm, uv in ~/.local/bin, Git for Windows installed for the current user); a copy from Homebrew, nvm, a system package manager … is left alone and the command that upgrades it is shown; --force adds a copy {{cli}} manages. After fnm's Node is upgraded, the npm packages installed globally before are installed into the new one at the same versions.\nWith nothing named, upgrades every installed coding tool and desktop app, and points out runtimes that are behind.\nTo update {{product}} itself, use {{cli}} update.",
       "arg": {
-        "tools": "claude-code, codex, grok, agy, claude-desktop, chatgpt; one or more"
+        "tools": "claude-code, codex, grok, agy, claude-desktop, chatgpt, node, git, uv; one or more"
       },
       "ex": {
         "all": "Upgrade every installed tool",
         "one": "Upgrade only Claude Code",
         "many": "Upgrade Codex and Antigravity CLI",
         "desktop": "Install Claude Desktop, or upgrade it to the download site's latest build",
-        "force": "Reinstall ChatGPT even though it is the latest (when the app is broken)"
+        "force": "Reinstall ChatGPT even though it is the latest (when the app is broken)",
+        "runtime": "Upgrade Node.js (fnm-managed; otherwise the command that upgrades it)"
       },
       "when": "When {{cli}} doctor reports an old version, or the tool's own updater doesn't finish.",
       "needs": "Without tool names, only installed tools are upgraded",
@@ -870,7 +987,7 @@
         "update": "Update {{product}} itself"
       },
       "opt": {
-        "force": "Download and reinstall desktop apps (claude-desktop, chatgpt) even when already the latest"
+        "force": "Reinstall desktop apps and runtimes that are already the latest; for a runtime installed another way, add a copy {{cli}} manages"
       }
     },
     "refresh": {
@@ -1074,6 +1191,8 @@
     "offer_quit": "Quit {{tool}} and upgrade to {{latest}}?",
     "declined_hint": "Not upgraded. Run {{command}} later",
     "quit_failed": "Couldn't quit {{tool}}, so it wasn't upgraded: quit it yourself, then run {{command}}",
+    "quit_confirm_in_app": "{{tool}} didn't quit: it may have a task running or be asking you to confirm. Switch to {{tool}} and confirm the quit there (or quit it once the task is done); the upgrade goes on here (waiting up to {{seconds}} s)…",
+    "quit_refused": "{{tool}} didn't quit, so it wasn't upgraded: it has a task running or is waiting for you to confirm. Confirm the quit in {{tool}} (or quit it once the task is done), then run {{command}}",
     "upgraded": "Upgraded {{tool}} from {{from}} to {{to}}",
     "installed": "Installed {{tool}} {{version}}",
     "upgrade_failed": "Couldn't upgrade {{tool}}: {{reason}}. {{current}} still works; fix the cause, then run {{command}}",

package/dist/locales/zh_CN.json

@@ -462,6 +462,83 @@
     "native_mirror_failed": "无法从国内镜像替换：{{reason}}",
     "install_label": "{{kind}} {{version}}（{{path}}）"
   },
+  "components": {
+    "category": {
+      "runtime": "运行环境",
+      "cli": "命令行工具",
+      "app": "桌面应用"
+    },
+    "col": {
+      "name": "组件",
+      "current": "已装",
+      "latest": "最新",
+      "managed": "安装方式",
+      "state": "状态"
+    },
+    "by": {
+      "fnm": "fnm",
+      "brew": "Homebrew",
+      "nvm": "nvm",
+      "volta": "Volta",
+      "scoop": "Scoop",
+      "asdf": "asdf",
+      "mise": "mise",
+      "system": "系统自带",
+      "standalone": "独立安装",
+      "pipx": "pipx",
+      "pip": "pip",
+      "winget": "winget",
+      "git-for-windows-user": "Git for Windows（当前用户）",
+      "git-for-windows": "Git for Windows",
+      "xcode": "苹果命令行工具",
+      "native": "原生安装",
+      "npm": "npm",
+      "app": "应用",
+      "other": "其他"
+    },
+    "state": {
+      "unsupported": "这个系统不提供",
+      "missing": "未安装：{{command}}",
+      "outdated_auto": "可升级：{{command}}",
+      "outdated_manual": "可升级：{{how}}",
+      "latest": "已是最新",
+      "unknown_latest": "已安装"
+    },
+    "source": "来源：{{source}}",
+    "latest_unknown": "暂时查不到最新版本：{{tools}}（稍后运行 {{cli}} list --refresh 再查）",
+    "unknown": "不认识的组件：{{names}}",
+    "known": "可以安装的组件：{{ids}}",
+    "unsupported_platform": "这个系统不提供 {{tool}}",
+    "blocked_sudo": "不要用 sudo 安装 {{tool}}：会装进 root 的用户目录，归 root 所有。去掉 sudo，用平常的账号再运行一次",
+    "blocked_system": "当前是系统账号（SYSTEM），{{tool}} 会装进系统配置目录：登录要用它的账号后再运行",
+    "blocked_unsupported_platform": "这个系统不提供 {{tool}}",
+    "reason_sudo": "不能用 sudo 安装",
+    "reason_system": "当前是系统账号（SYSTEM）",
+    "reason_unsupported_platform": "这个系统不提供",
+    "no_mirror": "无法安装 {{tool}}：没有配置安装脚本的下载地址",
+    "already_installed": "已安装 {{tool}} {{current}}",
+    "up_to_date": "{{tool}} {{current}} 已是最新",
+    "force_hint": "要重新安装就运行 {{command}}",
+    "outdated_auto": "{{tool}} 当前 {{current}}，可升到 {{latest}}：运行 {{command}}",
+    "outdated_manual": "{{tool}} 当前 {{current}}，可升到 {{latest}}。这份是用 {{by}} 安装的，{{cli}} 不改动它：运行 {{how}} 升级；要另装一份由 {{cli}} 管理的，运行 {{command}}",
+    "no_latest": "{{tool}} {{current}} 由系统管理，{{cli}} 不升级它：{{how}}",
+    "how_system": "用安装它的方式升级（系统包管理器或官方安装包），或加 --force 另装一份由 {{cli}} 管理的",
+    "how_xcode": "在「系统设置 → 通用 → 软件更新」里更新苹果命令行工具",
+    "how_other": "用安装它的方式升级",
+    "force_beside": "{{tool}} 已有一份（{{path}}，{{by}} 安装），按 --force 另装一份由 {{cli}} 管理的",
+    "installing": "正在安装 {{tool}} {{latest}}（{{source}}）…",
+    "upgrading": "正在升级 {{tool}} 到 {{latest}}（{{source}}）…",
+    "script_failed": "{{tool}} 没有装好，原因见上方。排除原因后运行 {{command}}",
+    "installed": "已安装 {{tool}} {{version}}",
+    "upgraded": "已把 {{tool}} 从 {{from}} 升到 {{to}}",
+    "reinstalled": "已重新安装 {{tool}} {{version}}",
+    "reinstalling": "按 --force 重新安装 {{tool}}（当前 {{current}}）",
+    "path_shadowed": "终端里先找到的是 {{active}}，不是刚装好的 {{tool}} {{version}}（{{path}}）：把后者所在目录放到 PATH 前面，或删掉前者",
+    "capped": "{{tool}} {{latest}} 不能在这台电脑上运行，安装脚本装的是能运行的最新版 {{version}}；有更新的版本时再提示升级",
+    "new_terminal": "新开一个终端窗口后可以直接使用",
+    "migrating_globals": "新版 Node 里还没有原来全局安装的这些包，正在装上同一版本：{{packages}}",
+    "migrate_failed": "原来全局安装的包没有全部装到新版 Node 里，可以手动运行：{{command}}"
+  },
   "install": {
     "permission_unix": "多半是 npm 没有权限写入全局目录。可以任选一种：① sudo {{command}}；② 运行 npm config set prefix ~/.npm-global，把 export PATH=~/.npm-global/bin:$PATH 加入 ~/.zshrc 或 ~/.bashrc，重新打开终端后再运行 {{command}}",
     "permission_windows": "多半是权限不足或文件被占用：请关闭正在运行的这个工具，以管理员身份打开终端，再运行 {{command}}",
@@ -851,18 +928,58 @@
         "doctor": "先自行检查常见问题"
       }
     },
+    "list": {
+      "summary": "列出 {{cli}} 能装的运行环境、命令行工具和桌面应用，以及装了哪个版本",
+      "description": "列出 Node.js、Git、uv、Claude Code、Codex、Grok Build、Antigravity CLI、Claude Desktop、ChatGPT：装了没有、当前版本、最新版本、用什么方式装的、从哪下载。最新版本缓存一小时，加 --refresh 立即重新查。",
+      "when": "想知道这台电脑上装了哪些工具、哪些可以升级时。",
+      "alt": {
+        "doctor": "检查令牌和各工具的配置"
+      },
+      "opt": {
+        "refresh": "不用缓存，重新查最新版本"
+      },
+      "ex": {
+        "all": "列出全部组件",
+        "refresh": "重新查最新版本",
+        "json": "输出 JSON，给脚本用"
+      }
+    },
+    "install": {
+      "summary": "安装运行环境（Node.js、Git、uv）、命令行工具或桌面应用",
+      "description": "从国内镜像安装缺少的组件，下载后核对校验值（桌面应用还核对厂商签名）。已经装过的不覆盖：只显示当前版本，落后时给出升级命令；加 --force 重新安装。\nNode.js、Git、uv 用 {{brand}} 的安装脚本装进当前用户目录，不需要管理员权限；不要加 sudo。可以写多个组件，有依赖的先装依赖。",
+      "arg": {
+        "components": "node、git、uv、claude-code、codex、grok、agy、claude-desktop、chatgpt，可以填写多个"
+      },
+      "opt": {
+        "force": "已经装过也重新安装"
+      },
+      "when": "要在这台电脑上补装某个工具时；别的应用的安装脚本也可以调用它（npx {{package}} install …）。",
+      "needs": "这台电脑已有 Node.js（{{cli}} 本身要 Node）；还没有 Node 时先用一键安装脚本",
+      "alt": {
+        "upgrade": "升级已经装好的组件",
+        "setup": "装好后写入令牌并配置各工具"
+      },
+      "ex": {
+        "runtimes": "安装 Node.js 和 uv",
+        "clis": "安装 Claude Code 和 Codex",
+        "app": "安装 ChatGPT 桌面版（内含 Codex）",
+        "force": "uv 已经装过也重新安装",
+        "json": "在脚本里安装，输出 JSON"
+      }
+    },
     "upgrade": {
-      "summary": "升级 Claude Code、Codex、Claude Desktop、ChatGPT 等编码工具",
-      "description": "按每份工具当初的安装方式升级：原生安装用工具自带的更新，npm 安装从国内镜像（npmmirror）重新安装，Homebrew 安装用 brew upgrade；原生或 Homebrew 方式无法升级时，改用 {{brand}} 一键安装脚本（程序取自国内镜像）。指定了但还没有安装的工具，也用这个脚本安装。\nClaude Desktop 和 ChatGPT（内含 Codex；macOS / Windows）比高速下载站上的版本旧时，从高速下载站下载官方安装包，核对校验值和厂商（Anthropic / OpenAI）的签名后安装；它们自带的自动更新照常开着，{{cli}} 只在没跟上时补上。应用正在运行时，在终端里问过才关掉它升级，带 --yes 或没有终端时只提示、不关。已是最新时加 --force 重新安装。ChatGPT 的 Mac 版只支持 Apple 芯片。\n不填工具名则升级已安装的全部工具。\n升级 {{product}} 本身请用 {{cli}} update。",
+      "summary": "升级编码工具、桌面应用和运行环境（Node.js、Git、uv）",
+      "description": "按每份工具当初的安装方式升级：原生安装用工具自带的更新，npm 安装从国内镜像（npmmirror）重新安装，Homebrew 安装用 brew upgrade；原生或 Homebrew 方式无法升级时，改用 {{brand}} 一键安装脚本（程序取自国内镜像）。指定了但还没有安装的工具，也用这个脚本安装。\nClaude Desktop 和 ChatGPT（内含 Codex；macOS / Windows）比高速下载站上的版本旧时，从高速下载站下载官方安装包，核对校验值和厂商（Anthropic / OpenAI）的签名后安装；它们自带的自动更新照常开着，{{cli}} 只在没跟上时补上。应用正在运行时，在终端里问过才关掉它升级，带 --yes 或没有终端时只提示、不关。已是最新时加 --force 重新安装。ChatGPT 的 Mac 版只支持 Apple 芯片。\nNode.js、Git、uv 只升级由 {{brand}} 安装脚本管理的那一份（fnm 装的 Node、~/.local/bin 里的 uv、装在当前用户下的 Git for Windows）；用 Homebrew、nvm、系统包管理器等装的，给出对应的升级命令、不改动它，加 --force 另装一份由 {{cli}} 管理的。fnm 的 Node 升级后，原来全局安装的 npm 包会按原版本装到新版里。\n不填名字则升级已安装的全部编码工具和桌面应用，并提示可以升级的运行环境。\n升级 {{product}} 本身请用 {{cli}} update。",
       "arg": {
-        "tools": "claude-code、codex、grok、agy、claude-desktop、chatgpt，可以填写多个"
+        "tools": "claude-code、codex、grok、agy、claude-desktop、chatgpt、node、git、uv，可以填写多个"
       },
       "ex": {
         "all": "升级已安装的全部工具",
         "one": "只升级 Claude Code",
         "many": "升级 Codex 和 Antigravity CLI",
         "desktop": "安装 Claude Desktop，或升到高速下载站上的最新版",
-        "force": "ChatGPT 已是最新也重新安装一遍（应用损坏时）"
+        "force": "ChatGPT 已是最新也重新安装一遍（应用损坏时）",
+        "runtime": "升级 Node.js（fnm 安装的；别的方式装的给出升级命令）"
       },
       "when": "{{cli}} doctor 提示版本过低，或工具自带的更新无法完成时。",
       "needs": "不填工具名时，只升级已经安装的工具",
@@ -870,7 +987,7 @@
         "update": "升级 {{product}} 本身"
       },
       "opt": {
-        "force": "桌面应用（claude-desktop、chatgpt）已是最新也重新下载安装"
+        "force": "桌面应用和运行环境已是最新也重新安装；运行环境由别的方式装的，另装一份由 {{cli}} 管理的"
       }
     },
     "refresh": {
@@ -1074,6 +1191,8 @@
     "offer_quit": "关掉 {{tool}} 并升到 {{latest}}？",
     "declined_hint": "没有升级。之后可以运行 {{command}}",
     "quit_failed": "无法退出 {{tool}}，这次没有升级：手动退出后运行 {{command}}",
+    "quit_confirm_in_app": "{{tool}} 没有退出：它可能有任务正在运行，或弹出了确认框。请切到 {{tool}}，在它的提示里确认退出（或等任务结束后退出），这里会接着升级（最多等 {{seconds}} 秒）…",
+    "quit_refused": "{{tool}} 没有退出，这次没有升级：它有任务正在运行或在等你确认。在 {{tool}} 里确认退出（或等任务结束后退出），再运行 {{command}}",
     "upgraded": "已把 {{tool}} 从 {{from}} 升到 {{to}}",
     "installed": "已安装 {{tool}} {{version}}",
     "upgrade_failed": "无法升级 {{tool}}：{{reason}}。当前的 {{current}} 照常可用；排除原因后运行 {{command}}",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeapi/api-helper",
-  "version": "0.0.148",
+  "version": "0.0.149",
   "description": "CLI tool for managing AI coding assistants (Claude Code, Codex, OpenClaw, Hermes, AtomCode, Grok Build) with one unified config",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,6 +16,7 @@
   "files": [
     "dist",
     "models.json",
+    "components.json",
     "client-config.snapshot.json",
     "settings-template.json",
     "codex-base-instructions.md",