opencode-system-metrics-tui 0.1.6 → 0.1.8

package/README.md

@@ -3,10 +3,10 @@
 ## Install globally in OpenCode
 
 ```powershell
-opencode plugin -g opencode-system-metrics-tui@0.1.6 --force
+opencode plugin -g opencode-system-metrics-tui@0.1.8 --force
 ```
 
-This is the primary installation path. The version must match `package.json`; `--force` asks OpenCode to refresh its package cache. Verify the actual installed artifact afterward:
+This is the primary installation path. The version must match `package.json`; `--force` asks OpenCode to refresh its package cache. The helper below skips OpenCode when the expected artifact is already current. Verify the actual installed artifact afterward:
 
 ```powershell
 npm run install-plugin
@@ -31,12 +31,14 @@ The README is available in **Español**, **English**, and **Português**.
 - RAM: memoria usada, total y porcentaje.
 - GPU: utilización y temperatura.
 - GPU VRAM: memoria usada, total y porcentaje.
+- En Apple Silicon, la fila se muestra como **Unified Memory**; no se presenta la memoria total del sistema como VRAM usada porque no existe una fuente fiable de uso dinámico.
 - Red: velocidad de descarga y subida en tiempo real.
 - CPU, RAM y red se consultan con una cadencia general de 2 segundos; GPU, VRAM y temperaturas usan una caché expirable de 10 segundos para reducir el coste sin congelar los sensores.
 - Colores compatibles con el tema activo de OpenCode.
 - Iconos Unicode por defecto en Windows (la detección de fuentes instaladas no cambia la selección); Linux/macOS usan Nerd Font solo si está instalada y mantienen fallback Unicode.
 - En Windows usa iconos Unicode visibles de forma predeterminada, porque OpenCode no puede detectar la fuente activa de la terminal.
 - Soporte para Linux, macOS y Windows cuando el sistema expone las métricas.
+- En macOS, la utilización de GPU usa `ioreg` y las temperaturas usan el helper de Stats si está instalado; si cualquiera de ellos falta, esa métrica queda como no disponible sin interrumpir el plugin. En Intel se conserva el fallback de GPU discreta de `systeminformation`.
 - En Windows, la temperatura de CPU requiere LibreHardwareMonitor ejecutándose como administrador con **Remote Web Server** activo en `http://127.0.0.1:8085`.
 - En Windows, la velocidad de red usa PowerShell y `Get-NetAdapterStatistics`; no agrega una dependencia npm.
 - Las lecturas opcionales de Windows se hacen bajo demanda, con timeout y caché; no hay timers globales de PowerShell.
@@ -91,7 +93,7 @@ npm publish --access public
 En otro equipo:
 
 ```bash
-opencode plugin opencode-system-metrics-tui@0.1.6
+opencode plugin opencode-system-metrics-tui@0.1.8
 ```
 
 El paquete exporta tanto la raíz (`opencode-system-metrics-tui`) como `./tui`; ambas rutas cargan el mismo bundle TUI.
@@ -101,8 +103,8 @@ El instalador de OpenCode configura el plugin TUI automáticamente. Reinicia Ope
 Publicar en npm e instalar en OpenCode son pasos distintos:
 
 - `npm publish --access public` publica el paquete en npm.
-- `opencode plugin opencode-system-metrics-tui@0.1.6` lo instala solo en el proyecto actual.
-- `opencode plugin -g opencode-system-metrics-tui@0.1.6 --force` lo instala globalmente para todos los proyectos.
+- `opencode plugin opencode-system-metrics-tui@0.1.8` lo instala solo en el proyecto actual.
+- `opencode plugin -g opencode-system-metrics-tui@0.1.8 --force` lo instala globalmente para todos los proyectos.
 
 ### Verificación
 
@@ -124,12 +126,14 @@ npm run build
 - RAM: used memory, total memory, and percentage.
 - GPU: utilization and temperature.
 - GPU VRAM: used memory, total memory, and percentage.
+- On Apple Silicon, the row is labeled **Unified Memory**; total system memory is never presented as live VRAM usage because no reliable dynamic source is available.
 - Network: live download and upload speeds.
 - CPU, RAM, and network use the 2-second general cadence; GPU, VRAM, and temperatures use an expiring 10-second cache to reduce cost without freezing sensors.
 - Uses the active OpenCode theme colors.
 - Windows uses Unicode icons by default (installed-font detection does not change selection); Linux/macOS use Nerd Font only when installed and retain Unicode fallback.
 - On Windows, visible Unicode icons are used by default because OpenCode cannot detect the terminal's active font.
 - Supports Linux, macOS, and Windows when the operating system exposes the metrics.
+- On macOS, GPU utilization uses `ioreg` and temperatures use the Stats helper when installed; missing helpers leave only that metric unavailable without interrupting the plugin. Intel retains the discrete-GPU `systeminformation` fallback.
 - On Windows, CPU temperature requires LibreHardwareMonitor running as administrator with **Remote Web Server** enabled at `http://127.0.0.1:8085`.
 - On Windows, network speed uses PowerShell and `Get-NetAdapterStatistics`; it adds no npm dependency.
 - Optional Windows reads are on demand, timeout-bounded, and cached; no global PowerShell timers are used.
@@ -184,7 +188,7 @@ npm publish --access public
 On another machine:
 
 ```bash
-opencode plugin opencode-system-metrics-tui@0.1.6
+opencode plugin opencode-system-metrics-tui@0.1.8
 ```
 
 The package exports both the root (`opencode-system-metrics-tui`) and `./tui`; both paths load the same TUI bundle.
@@ -194,8 +198,8 @@ The OpenCode installer configures the TUI plugin automatically. Restart OpenCode
 Publishing to npm and installing in OpenCode are separate steps:
 
 - `npm publish --access public` publishes the package to npm.
-- `opencode plugin opencode-system-metrics-tui@0.1.6` installs it for the current project only.
-- `opencode plugin -g opencode-system-metrics-tui@0.1.6 --force` installs it globally for all projects.
+- `opencode plugin opencode-system-metrics-tui@0.1.8` installs it for the current project only.
+- `opencode plugin -g opencode-system-metrics-tui@0.1.8 --force` installs it globally for all projects.
 
 ### Verification
 
@@ -277,7 +281,7 @@ npm publish --access public
 Em outro computador:
 
 ```bash
-opencode plugin opencode-system-metrics-tui@0.1.6
+opencode plugin opencode-system-metrics-tui@0.1.8
 ```
 
 O pacote exporta tanto a raiz (`opencode-system-metrics-tui`) quanto `./tui`; os dois caminhos carregam o mesmo bundle TUI.
@@ -287,8 +291,8 @@ O instalador do OpenCode configura o plugin TUI automaticamente. Reinicie o Open
 Publicar no npm e instalar no OpenCode são etapas diferentes:
 
 - `npm publish --access public` publica o pacote no npm.
-- `opencode plugin opencode-system-metrics-tui@0.1.6` instala o plugin apenas no projeto atual.
-- `opencode plugin -g opencode-system-metrics-tui@0.1.6 --force` instala o plugin globalmente para todos os projetos.
+- `opencode plugin opencode-system-metrics-tui@0.1.8` instala o plugin apenas no projeto atual.
+- `opencode plugin -g opencode-system-metrics-tui@0.1.8 --force` instala o plugin globalmente para todos os projetos.
 
 ### Verificação
 

package/dist/install-hack-font.js

@@ -8,19 +8,19 @@ import { promisify } from "node:util";
 // src/font.ts
 import { existsSync, readdirSync } from "node:fs";
 import { homedir } from "node:os";
-import { join as posixJoin, win32 } from "node:path";
+import { posix, win32 } from "node:path";
 var NERD_FONT_FILE_PATTERN = /NerdFont[A-Za-z0-9-]*[-_][A-Za-z0-9-]+\.(?:ttf|otf)$/i;
 var MAX_FONT_SCAN_DEPTH = 2;
 var MAX_FONT_SCAN_ENTRIES = 256;
 function getFontDirectories(platform, home = homedir(), env = process.env) {
   if (platform === "darwin")
-    return [posixJoin(home, "Library", "Fonts"), "/Library/Fonts", "/System/Library/Fonts"];
+    return [posix.join(home, "Library", "Fonts"), "/Library/Fonts", "/System/Library/Fonts"];
   if (platform === "win32") {
     const localAppData = env.LOCALAPPDATA ?? win32.join(home, "AppData", "Local");
     const windows = env.WINDIR ?? "C:\\Windows";
     return [win32.join(localAppData, "Microsoft", "Windows", "Fonts"), win32.join(windows, "Fonts")];
   }
-  return [posixJoin(home, ".local", "share", "fonts"), posixJoin(home, ".fonts"), "/usr/local/share/fonts", "/usr/share/fonts"];
+  return [posix.join(home, ".local", "share", "fonts"), posix.join(home, ".fonts"), "/usr/local/share/fonts", "/usr/share/fonts"];
 }
 function isNerdFontFile(fileName) {
   return NERD_FONT_FILE_PATTERN.test(fileName);
@@ -36,7 +36,7 @@ function hasNerdFont(platform = process.platform, home = homedir(), env = proces
       return false;
     try {
       return readdirSync(directory, { withFileTypes: true }).slice(0, MAX_FONT_SCAN_ENTRIES).some((entry) => {
-        const path = platform === "win32" ? win32.join(directory, entry.name) : posixJoin(directory, entry.name);
+        const path = platform === "win32" ? win32.join(directory, entry.name) : posix.join(directory, entry.name);
         return entry.isFile() ? isNerdFontFile(entry.name) : entry.isDirectory() && containsFont(path, depth + 1);
       });
     } catch {

package/dist/tui.js

@@ -40,13 +40,71 @@ import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import si from "systeminformation";
 var execFileAsync = promisify(execFile);
-var WINDOWS_NETWORK_TIMEOUT_MS = 1500;
+var DEFAULT_METRIC_TIMEOUT_MS = 1500;
+var WINDOWS_MEMORY_TIMEOUT_MS = 5000;
+var WINDOWS_NETWORK_PROCESS_TIMEOUT_MS = 4000;
+var WINDOWS_NETWORK_OUTER_TIMEOUT_MS = 4500;
+var MAC_METRIC_TIMEOUT_MS = 1500;
+var MAC_STATS_HELPER = "/Applications/Stats.app/Contents/Resources/smc";
+var runCommand = async (command, args, timeoutMs) => {
+  const { stdout } = await execFileAsync(command, args, { timeout: timeoutMs, maxBuffer: 1024 * 1024 });
+  return stdout;
+};
+async function detectMacHardwareArchitecture(runner = runCommand, processArchitecture = process.arch) {
+  try {
+    const output = (await runner("sysctl", ["-in", "hw.optional.arm64"], MAC_METRIC_TIMEOUT_MS)).trim();
+    if (output === "1")
+      return "arm64";
+    if (output === "0")
+      return "x86_64";
+  } catch {}
+  return processArchitecture === "arm64" ? "arm64" : "x86_64";
+}
+function gpuMemoryLabel(architecture, platform = process.platform) {
+  if (platform !== "darwin")
+    return "GPU VRAM";
+  if (architecture === "arm64")
+    return "Unified Memory";
+  if (architecture === "x86_64")
+    return "GPU VRAM";
+  return "Memory";
+}
 function parseMonitorTemperature(value) {
   if (value === undefined)
     return;
   const parsed = Number(value.replace(",", ".").replace(/[^\d.-]/g, ""));
   return Number.isFinite(parsed) ? parsed : undefined;
 }
+function parseMacGpuUtilization(stdout) {
+  const match = stdout.match(/"Device Utilization %"\s*=\s*([\d]+(?:\.\d+)?)/);
+  if (match === null)
+    return;
+  const value = Number(match[1]);
+  return Number.isFinite(value) && value >= 0 && value <= 100 ? value : undefined;
+}
+function parseMacStatsTemperature(stdout, sensorPrefix) {
+  let maximum;
+  for (const line of stdout.split(/\r?\n/)) {
+    const fields = line.trim().split(/\s+/);
+    if (fields.length < 2 || !new RegExp(`^\\[${sensorPrefix}`).test(fields[0]))
+      continue;
+    const value = Number(fields[1].replace(",", ".").replace(/[°cC]/g, ""));
+    if (Number.isFinite(value) && value > 0 && (maximum === undefined || value > maximum))
+      maximum = value;
+  }
+  return maximum;
+}
+async function readMacMetrics(runner = runCommand) {
+  const [gpuOutput, temperatureOutput] = await Promise.all([
+    runner("ioreg", ["-r", "-d", "1", "-c", "IOAccelerator"], MAC_METRIC_TIMEOUT_MS).catch(() => ""),
+    runner(MAC_STATS_HELPER, ["list", "-t"], MAC_METRIC_TIMEOUT_MS).catch(() => "")
+  ]);
+  return {
+    gpuPercent: parseMacGpuUtilization(gpuOutput) ?? null,
+    cpuTemperatureCelsius: parseMacStatsTemperature(temperatureOutput, "Tp") ?? null,
+    gpuTemperatureCelsius: parseMacStatsTemperature(temperatureOutput, "Tg") ?? null
+  };
+}
 async function readLibreHardwareMonitorTemperature() {
   const response = await fetch("http://127.0.0.1:8085/data.json", { signal: AbortSignal.timeout(2000) });
   if (!response.ok)
@@ -87,7 +145,7 @@ async function readWindowsNetworkSample() {
     "-NonInteractive",
     "-Command",
     "Get-NetAdapterStatistics | Select-Object Name,ReceivedBytes,SentBytes | ConvertTo-Json -Compress"
-  ], { windowsHide: true, timeout: WINDOWS_NETWORK_TIMEOUT_MS, maxBuffer: 1024 * 1024 });
+  ], { windowsHide: true, timeout: WINDOWS_NETWORK_PROCESS_TIMEOUT_MS, maxBuffer: 1024 * 1024 });
   return parseWindowsNetworkOutput(stdout);
 }
 var previousNetwork;
@@ -102,6 +160,7 @@ var unavailable = {
   gpuMemoryUsedBytes: null,
   gpuMemoryTotalBytes: null,
   gpuMemoryPercent: null,
+  gpuMemoryIsUnified: null,
   downloadBytesPerSecond: null,
   uploadBytesPerSecond: null
 };
@@ -126,7 +185,15 @@ var SLOW_METRIC_CACHE_MS = 1e4;
 var TEMPERATURE_CACHE_MS = 1e4;
 var OPTIONAL_SOURCE_BACKOFF_MS = 30000;
 var isWindows = process.platform === "win32";
+var isMac = process.platform === "darwin";
 var NETWORK_CACHE_MS = 2000;
+var macHardwareArchitecture;
+function readMacHardwareArchitecture() {
+  if (!isMac)
+    return Promise.resolve("x86_64");
+  macHardwareArchitecture ??= detectMacHardwareArchitecture();
+  return macHardwareArchitecture;
+}
 function selectGpuMetrics(graphics) {
   const empty = {
     gpuPercent: null,
@@ -208,6 +275,11 @@ var cachedGraphics = {
   lastAttemptAt: 0,
   inFlight: undefined
 };
+var cachedMacMetrics = {
+  value: undefined,
+  lastAttemptAt: 0,
+  inFlight: undefined
+};
 var cachedNetwork = {
   value: undefined,
   lastAttemptAt: 0,
@@ -249,14 +321,16 @@ async function readWindowsCpuTemperature() {
   return value === undefined ? undefined : { main: value };
 }
 async function readMetrics() {
-  const [load, memory] = await Promise.allSettled([
-    withTimeout(si.currentLoad(), 1500),
-    withTimeout(si.mem(), 1500)
+  const [load, memory, hardwareArchitecture] = await Promise.allSettled([
+    withTimeout(si.currentLoad(), DEFAULT_METRIC_TIMEOUT_MS),
+    withTimeout(si.mem(), isWindows ? WINDOWS_MEMORY_TIMEOUT_MS : DEFAULT_METRIC_TIMEOUT_MS),
+    readMacHardwareArchitecture()
   ]);
-  const [temperature, graphics, network] = await Promise.allSettled([
+  const [temperature, graphics, network, mac] = await Promise.allSettled([
     readCachedMetric(cachedCpuTemperature, isWindows ? readWindowsCpuTemperature : () => si.cpuTemperature(), TEMPERATURE_CACHE_MS, Date.now(), TEMPERATURE_CACHE_MS, 2500),
     readCachedMetric(cachedGraphics, () => si.graphics(), SLOW_METRIC_CACHE_MS, Date.now(), SLOW_METRIC_CACHE_MS, 2500),
-    readCachedMetric(cachedNetwork, isWindows ? readWindowsNetworkMetrics : () => si.networkStats("*"), isWindows ? NETWORK_CACHE_MS : 2000, Date.now(), OPTIONAL_SOURCE_BACKOFF_MS, 1500)
+    readCachedMetric(cachedNetwork, isWindows ? readWindowsNetworkMetrics : () => si.networkStats("*"), isWindows ? NETWORK_CACHE_MS : 2000, Date.now(), OPTIONAL_SOURCE_BACKOFF_MS, isWindows ? WINDOWS_NETWORK_OUTER_TIMEOUT_MS : DEFAULT_METRIC_TIMEOUT_MS),
+    isMac ? readCachedMetric(cachedMacMetrics, () => readMacMetrics(), SLOW_METRIC_CACHE_MS, Date.now(), OPTIONAL_SOURCE_BACKOFF_MS, MAC_METRIC_TIMEOUT_MS) : Promise.resolve(undefined)
   ]);
   const cpuPercent = load.status === "fulfilled" ? finite(load.value.currentLoad) : null;
   const memoryTotalBytes = memory.status === "fulfilled" ? finite(memory.value.total) : null;
@@ -264,6 +338,14 @@ async function readMetrics() {
   const memoryUsedBytes = memoryTotalBytes !== null && memoryAvailableBytes !== null ? Math.max(0, memoryTotalBytes - memoryAvailableBytes) : memory.status === "fulfilled" ? finite(memory.value.used) : null;
   const memoryPercent = memoryUsedBytes !== null && memoryTotalBytes !== null && memoryTotalBytes > 0 ? memoryUsedBytes / memoryTotalBytes * 100 : null;
   const gpu = selectGpuMetrics(graphics.status === "fulfilled" ? graphics.value : undefined);
+  const macMetrics = mac.status === "fulfilled" ? mac.value : undefined;
+  const architecture = hardwareArchitecture.status === "fulfilled" ? hardwareArchitecture.value : undefined;
+  const isAppleSilicon = isMac && architecture === "arm64";
+  if (isAppleSilicon) {
+    gpu.gpuMemoryUsedBytes = null;
+    gpu.gpuMemoryTotalBytes = null;
+    gpu.gpuMemoryPercent = null;
+  }
   let downloadBytesPerSecond = null;
   let uploadBytesPerSecond = null;
   if (network.status === "fulfilled" && network.value !== undefined) {
@@ -290,12 +372,13 @@ async function readMetrics() {
     memoryUsedBytes,
     memoryTotalBytes,
     memoryPercent,
-    gpuPercent: gpu.gpuPercent,
-    cpuTemperatureCelsius: temperature.status === "fulfilled" && temperature.value !== undefined ? finite(temperature.value.main) ?? ("max" in temperature.value ? finite(temperature.value.max) : null) : null,
-    gpuTemperatureCelsius: gpu.gpuTemperatureCelsius,
+    gpuPercent: macMetrics?.gpuPercent ?? gpu.gpuPercent,
+    cpuTemperatureCelsius: macMetrics?.cpuTemperatureCelsius ?? (temperature.status === "fulfilled" && temperature.value !== undefined ? finite(temperature.value.main) ?? ("max" in temperature.value ? finite(temperature.value.max) : null) : null),
+    gpuTemperatureCelsius: macMetrics?.gpuTemperatureCelsius ?? gpu.gpuTemperatureCelsius,
     gpuMemoryUsedBytes: gpu.gpuMemoryUsedBytes,
     gpuMemoryTotalBytes: gpu.gpuMemoryTotalBytes,
     gpuMemoryPercent: gpu.gpuMemoryPercent,
+    gpuMemoryIsUnified: isAppleSilicon ? true : isMac && architecture === "x86_64" ? false : null,
     downloadBytesPerSecond,
     uploadBytesPerSecond
   };
@@ -304,19 +387,19 @@ async function readMetrics() {
 // src/font.ts
 import { existsSync, readdirSync } from "node:fs";
 import { homedir } from "node:os";
-import { join as posixJoin, win32 } from "node:path";
+import { posix, win32 } from "node:path";
 var NERD_FONT_FILE_PATTERN = /NerdFont[A-Za-z0-9-]*[-_][A-Za-z0-9-]+\.(?:ttf|otf)$/i;
 var MAX_FONT_SCAN_DEPTH = 2;
 var MAX_FONT_SCAN_ENTRIES = 256;
 function getFontDirectories(platform, home = homedir(), env = process.env) {
   if (platform === "darwin")
-    return [posixJoin(home, "Library", "Fonts"), "/Library/Fonts", "/System/Library/Fonts"];
+    return [posix.join(home, "Library", "Fonts"), "/Library/Fonts", "/System/Library/Fonts"];
   if (platform === "win32") {
     const localAppData = env.LOCALAPPDATA ?? win32.join(home, "AppData", "Local");
     const windows = env.WINDIR ?? "C:\\Windows";
     return [win32.join(localAppData, "Microsoft", "Windows", "Fonts"), win32.join(windows, "Fonts")];
   }
-  return [posixJoin(home, ".local", "share", "fonts"), posixJoin(home, ".fonts"), "/usr/local/share/fonts", "/usr/share/fonts"];
+  return [posix.join(home, ".local", "share", "fonts"), posix.join(home, ".fonts"), "/usr/local/share/fonts", "/usr/share/fonts"];
 }
 function isNerdFontFile(fileName) {
   return NERD_FONT_FILE_PATTERN.test(fileName);
@@ -332,7 +415,7 @@ function hasNerdFont(platform = process.platform, home = homedir(), env = proces
       return false;
     try {
       return readdirSync(directory, { withFileTypes: true }).slice(0, MAX_FONT_SCAN_ENTRIES).some((entry) => {
-        const path = platform === "win32" ? win32.join(directory, entry.name) : posixJoin(directory, entry.name);
+        const path = platform === "win32" ? win32.join(directory, entry.name) : posix.join(directory, entry.name);
         return entry.isFile() ? isNerdFontFile(entry.name) : entry.isDirectory() && containsFont(path, depth + 1);
       });
     } catch {
@@ -376,6 +459,7 @@ var initialMetrics = {
   gpuMemoryUsedBytes: null,
   gpuMemoryTotalBytes: null,
   gpuMemoryPercent: null,
+  gpuMemoryIsUnified: null,
   downloadBytesPerSecond: null,
   uploadBytesPerSecond: null
 };
@@ -432,13 +516,13 @@ function MetricsPanel(props) {
   onMount(startMetricsPolling);
   onCleanup(stopMetricsPolling);
   return (() => {
-    var _el$ = _$createElement("box"), _el$2 = _$createElement("text"), _el$3 = _$createTextNode(` `), _el$4 = _$createElement("box"), _el$5 = _$createElement("text"), _el$6 = _$createElement("text"), _el$8 = _$createElement("text"), _el$9 = _$createTextNode(` · `), _el$0 = _$createTextNode(` `), _el$1 = _$createElement("box"), _el$10 = _$createElement("text"), _el$11 = _$createElement("text"), _el$13 = _$createElement("text"), _el$14 = _$createTextNode(` / `), _el$15 = _$createTextNode(` (`), _el$16 = _$createTextNode(`)`), _el$17 = _$createElement("box"), _el$18 = _$createElement("text"), _el$19 = _$createElement("text"), _el$21 = _$createElement("text"), _el$22 = _$createTextNode(` · `), _el$23 = _$createTextNode(` `), _el$24 = _$createElement("box"), _el$25 = _$createElement("text"), _el$26 = _$createElement("text"), _el$28 = _$createElement("text"), _el$29 = _$createTextNode(` / `), _el$30 = _$createTextNode(` (`), _el$31 = _$createTextNode(`)`), _el$32 = _$createElement("box"), _el$33 = _$createElement("text"), _el$34 = _$createElement("text"), _el$36 = _$createElement("text"), _el$37 = _$createTextNode(`↓ `), _el$38 = _$createTextNode(` ↑ `);
+    var _el$ = _$createElement("box"), _el$2 = _$createElement("text"), _el$3 = _$createTextNode(` `), _el$4 = _$createElement("box"), _el$5 = _$createElement("text"), _el$6 = _$createElement("text"), _el$8 = _$createElement("text"), _el$9 = _$createTextNode(` · `), _el$0 = _$createTextNode(` `), _el$1 = _$createElement("box"), _el$10 = _$createElement("text"), _el$11 = _$createElement("text"), _el$13 = _$createElement("text"), _el$14 = _$createTextNode(` / `), _el$15 = _$createTextNode(` (`), _el$16 = _$createTextNode(`)`), _el$17 = _$createElement("box"), _el$18 = _$createElement("text"), _el$19 = _$createElement("text"), _el$21 = _$createElement("text"), _el$22 = _$createTextNode(` · `), _el$23 = _$createTextNode(` `), _el$24 = _$createElement("box"), _el$25 = _$createElement("text"), _el$26 = _$createElement("text"), _el$27 = _$createTextNode(` `), _el$28 = _$createTextNode(` `), _el$29 = _$createElement("text"), _el$30 = _$createTextNode(` / `), _el$31 = _$createTextNode(` (`), _el$32 = _$createTextNode(`)`), _el$33 = _$createElement("box"), _el$34 = _$createElement("text"), _el$35 = _$createElement("text"), _el$37 = _$createElement("text"), _el$38 = _$createTextNode(`↓ `), _el$39 = _$createTextNode(` ↑ `);
     _$insertNode(_el$, _el$2);
     _$insertNode(_el$, _el$4);
     _$insertNode(_el$, _el$1);
     _$insertNode(_el$, _el$17);
     _$insertNode(_el$, _el$24);
-    _$insertNode(_el$, _el$32);
+    _$insertNode(_el$, _el$33);
     _$setProp(_el$, "flexDirection", "column");
     _$setProp(_el$, "paddingLeft", 0);
     _$setProp(_el$, "paddingRight", 0);
@@ -481,26 +565,28 @@ function MetricsPanel(props) {
     _$insert(_el$21, () => formatTemperature(metricsState.sharedMetrics().gpuTemperatureCelsius), null);
     _$insertNode(_el$24, _el$25);
     _$insertNode(_el$24, _el$26);
-    _$insertNode(_el$24, _el$28);
+    _$insertNode(_el$24, _el$29);
     _$setProp(_el$24, "flexDirection", "row");
     _$insert(_el$25, () => icons.vram);
-    _$insertNode(_el$26, _$createTextNode(` GPU VRAM `));
-    _$insertNode(_el$28, _el$29);
-    _$insertNode(_el$28, _el$30);
-    _$insertNode(_el$28, _el$31);
-    _$insert(_el$28, () => formatGiB(metricsState.sharedMetrics().gpuMemoryUsedBytes), _el$29);
-    _$insert(_el$28, () => formatGiB(metricsState.sharedMetrics().gpuMemoryTotalBytes), _el$30);
-    _$insert(_el$28, () => formatPercent(metricsState.sharedMetrics().gpuMemoryPercent), _el$31);
-    _$insertNode(_el$32, _el$33);
-    _$insertNode(_el$32, _el$34);
-    _$insertNode(_el$32, _el$36);
-    _$setProp(_el$32, "flexDirection", "row");
-    _$insert(_el$33, () => icons.network);
-    _$insertNode(_el$34, _$createTextNode(` NET `));
-    _$insertNode(_el$36, _el$37);
-    _$insertNode(_el$36, _el$38);
-    _$insert(_el$36, () => formatRate(metricsState.sharedMetrics().downloadBytesPerSecond), _el$38);
-    _$insert(_el$36, () => formatRate(metricsState.sharedMetrics().uploadBytesPerSecond), null);
+    _$insertNode(_el$26, _el$27);
+    _$insertNode(_el$26, _el$28);
+    _$insert(_el$26, () => gpuMemoryLabel(metricsState.sharedMetrics().gpuMemoryIsUnified === true ? "arm64" : metricsState.sharedMetrics().gpuMemoryIsUnified === false ? "x86_64" : undefined), _el$28);
+    _$insertNode(_el$29, _el$30);
+    _$insertNode(_el$29, _el$31);
+    _$insertNode(_el$29, _el$32);
+    _$insert(_el$29, () => formatGiB(metricsState.sharedMetrics().gpuMemoryUsedBytes), _el$30);
+    _$insert(_el$29, () => formatGiB(metricsState.sharedMetrics().gpuMemoryTotalBytes), _el$31);
+    _$insert(_el$29, () => formatPercent(metricsState.sharedMetrics().gpuMemoryPercent), _el$32);
+    _$insertNode(_el$33, _el$34);
+    _$insertNode(_el$33, _el$35);
+    _$insertNode(_el$33, _el$37);
+    _$setProp(_el$33, "flexDirection", "row");
+    _$insert(_el$34, () => icons.network);
+    _$insertNode(_el$35, _$createTextNode(` NET `));
+    _$insertNode(_el$37, _el$38);
+    _$insertNode(_el$37, _el$39);
+    _$insert(_el$37, () => formatRate(metricsState.sharedMetrics().downloadBytesPerSecond), _el$39);
+    _$insert(_el$37, () => formatRate(metricsState.sharedMetrics().uploadBytesPerSecond), null);
     _$effect((_p$) => {
       var _v$ = props.theme.text, _v$2 = TextAttributes.BOLD, _v$3 = props.theme.success, _v$4 = props.theme.text, _v$5 = props.theme.textMuted, _v$6 = props.theme.success, _v$7 = props.theme.text, _v$8 = props.theme.textMuted, _v$9 = props.theme.success, _v$0 = props.theme.text, _v$1 = props.theme.textMuted, _v$10 = props.theme.success, _v$11 = props.theme.text, _v$12 = props.theme.textMuted, _v$13 = props.theme.success, _v$14 = props.theme.text, _v$15 = props.theme.textMuted;
       _v$ !== _p$.e && (_p$.e = _$setProp(_el$2, "fg", _v$, _p$.e));
@@ -516,10 +602,10 @@ function MetricsPanel(props) {
       _v$1 !== _p$.l && (_p$.l = _$setProp(_el$21, "fg", _v$1, _p$.l));
       _v$10 !== _p$.u && (_p$.u = _$setProp(_el$25, "fg", _v$10, _p$.u));
       _v$11 !== _p$.c && (_p$.c = _$setProp(_el$26, "fg", _v$11, _p$.c));
-      _v$12 !== _p$.w && (_p$.w = _$setProp(_el$28, "fg", _v$12, _p$.w));
-      _v$13 !== _p$.m && (_p$.m = _$setProp(_el$33, "fg", _v$13, _p$.m));
-      _v$14 !== _p$.f && (_p$.f = _$setProp(_el$34, "fg", _v$14, _p$.f));
-      _v$15 !== _p$.y && (_p$.y = _$setProp(_el$36, "fg", _v$15, _p$.y));
+      _v$12 !== _p$.w && (_p$.w = _$setProp(_el$29, "fg", _v$12, _p$.w));
+      _v$13 !== _p$.m && (_p$.m = _$setProp(_el$34, "fg", _v$13, _p$.m));
+      _v$14 !== _p$.f && (_p$.f = _$setProp(_el$35, "fg", _v$14, _p$.f));
+      _v$15 !== _p$.y && (_p$.y = _$setProp(_el$37, "fg", _v$15, _p$.y));
       return _p$;
     }, {
       e: undefined,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-system-metrics-tui",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "OpenCode TUI sidebar plugin for live system metrics",
   "license": "MIT",
   "type": "module",

package/scripts/install-plugin.ts

@@ -1,7 +1,8 @@
 import { execFile } from "node:child_process"
 import { readFile } from "node:fs/promises"
+import { fileURLToPath } from "node:url"
 import { promisify } from "node:util"
-import { formatVerificationResult, verifyPluginInstallation } from "./plugin-installation.js"
+import { formatVerificationResult, shouldInstallPlugin, verifyPluginInstallation } from "./plugin-installation.js"
 
 const execFileAsync = promisify(execFile)
 const manifest = JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8")) as {
@@ -10,21 +11,36 @@ const manifest = JSON.parse(await readFile(new URL("../package.json", import.met
 }
 const packageSpec = `${manifest.name}@${manifest.version}`
 
-console.log(`Installing ${packageSpec} globally through OpenCode`)
-try {
-  const result = await execFileAsync("opencode", ["plugin", "-g", packageSpec, "--force"], { windowsHide: true })
-  if (result.stdout.trim()) console.log(result.stdout.trim())
-  if (result.stderr.trim()) console.error(result.stderr.trim())
-} catch (error) {
-  const message = error instanceof Error ? error.message : String(error)
-  console.error(`OpenCode plugin installation failed: ${message}`)
-  process.exit(1)
+export async function installPlugin(): Promise<void> {
+  const verificationOptions = {
+    packageName: manifest.name,
+    expectedVersion: manifest.version,
+    cacheDirectory: process.env.OPENCODE_CACHE_DIR,
+  }
+  const current = await verifyPluginInstallation(verificationOptions)
+  console.log(formatVerificationResult(current))
+  if (!shouldInstallPlugin(current)) {
+    console.log(`Installation already current for ${packageSpec}; OpenCode was not invoked.`)
+    return
+  }
+
+  console.log(`Installing ${packageSpec} globally through OpenCode`)
+  try {
+    const result = await execFileAsync("opencode", ["plugin", "-g", packageSpec, "--force"], { windowsHide: true })
+    if (result.stdout.trim()) console.log(result.stdout.trim())
+    if (result.stderr.trim()) console.error(result.stderr.trim())
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error)
+    console.error(`OpenCode plugin installation failed: ${message}`)
+    process.exitCode = 1
+    return
+  }
+
+  const verification = await verifyPluginInstallation(verificationOptions)
+  console.log(formatVerificationResult(verification))
+  if (!verification.ok) process.exitCode = 1
 }
 
-const verification = await verifyPluginInstallation({
-  packageName: manifest.name,
-  expectedVersion: manifest.version,
-  cacheDirectory: process.env.OPENCODE_CACHE_DIR,
-})
-console.log(formatVerificationResult(verification))
-if (!verification.ok) process.exitCode = 1
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+  await installPlugin()
+}

package/scripts/plugin-installation.ts

@@ -15,6 +15,7 @@ export type PluginVerification = {
   packagePath?: string
   actualVersion?: string
   staleEntries: string[]
+  warnings: string[]
   errors: string[]
 }
 
@@ -46,8 +47,11 @@ export async function verifyPluginInstallation(options: PluginVerificationOption
   const cacheDirectory = resolve(options.cacheDirectory ?? getDefaultOpenCodeCacheDirectory())
   const errors: string[] = []
   const staleEntries: string[] = []
+  const warnings: string[] = []
   let packagePath: string | undefined
   let actualVersion: string | undefined
+  let expectedArtifactFound = false
+  let expectedPackagePath: string | undefined
 
   let entries: string[]
   try {
@@ -55,7 +59,7 @@ export async function verifyPluginInstallation(options: PluginVerificationOption
       .filter((entry) => entry.isDirectory() && entry.name.startsWith(`${options.packageName}@`))
       .map((entry) => entry.name)
   } catch {
-    return { ok: false, staleEntries, errors: [`OpenCode package cache not found: ${cacheDirectory}`] }
+    return { ok: false, staleEntries, warnings, errors: [`OpenCode package cache not found: ${cacheDirectory}`] }
   }
 
   for (const entry of entries) {
@@ -65,31 +69,42 @@ export async function verifyPluginInstallation(options: PluginVerificationOption
       staleEntries.push(join(cacheDirectory, entry))
       continue
     }
-    if (manifest.version === options.expectedVersion && packagePath === undefined) {
-      packagePath = candidatePath
-      actualVersion = manifest.version
-    } else if (manifest.version !== options.expectedVersion) {
+    if (manifest.version === options.expectedVersion) {
+      expectedArtifactFound = true
+      expectedPackagePath ??= candidatePath
+      if (await exists(join(candidatePath, options.distPath ?? "dist", "tui.js")) && packagePath === undefined) {
+        packagePath = candidatePath
+        actualVersion = manifest.version
+      }
+    } else {
       staleEntries.push(join(cacheDirectory, entry))
     }
   }
 
-  if (packagePath === undefined) {
+  if (!expectedArtifactFound) {
     errors.push(`Installed ${options.packageName}@${options.expectedVersion} was not found in ${cacheDirectory}`)
+  } else if (packagePath === undefined) {
+    errors.push(`Required dist/tui.js is missing from an expected ${options.packageName}@${options.expectedVersion} artifact in ${cacheDirectory}`)
+    packagePath = expectedPackagePath
+    actualVersion = options.expectedVersion
   } else if (actualVersion !== options.expectedVersion) {
     errors.push(`Installed version is ${actualVersion ?? "unknown"}; expected ${options.expectedVersion}`)
   }
 
-  if (packagePath !== undefined && !(await exists(join(packagePath, options.distPath ?? "dist", "tui.js")))) {
-    errors.push(`Required dist/tui.js is missing from ${packagePath}`)
-  }
-  if (staleEntries.length > 0) errors.push(`Stale OpenCode cache entries detected: ${staleEntries.join(", ")}`)
+  if (staleEntries.length > 0) warnings.push(`Stale OpenCode cache entries detected: ${staleEntries.join(", ")}`)
+
+  return { ok: errors.length === 0, packagePath, actualVersion, staleEntries, warnings, errors }
+}
 
-  return { ok: errors.length === 0, packagePath, actualVersion, staleEntries, errors }
+export function shouldInstallPlugin(result: PluginVerification): boolean {
+  return !result.ok
 }
 
 export function formatVerificationResult(result: PluginVerification): string {
-  if (result.ok) return `Verified OpenCode plugin ${result.actualVersion} at ${result.packagePath}`
-  return result.errors.join("\n")
+  const lines = result.ok
+    ? [`Verified OpenCode plugin ${result.actualVersion} at ${result.packagePath}`]
+    : result.errors
+  return [...lines, ...result.warnings].join("\n")
 }
 
 if (process.argv[1] !== undefined && resolve(process.argv[1]) === resolve(fileURLToPath(import.meta.url))) {