opencode-system-metrics-tui 0.1.11 → 0.1.13

package/README.md

@@ -3,7 +3,7 @@
 ## Install globally in OpenCode
 
 ```powershell
-opencode plugin -g opencode-system-metrics-tui@0.1.11 --force
+opencode plugin -g opencode-system-metrics-tui@0.1.13 --force
 ```
 
 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:
@@ -17,6 +17,19 @@ npm run verify-installation
 
 Restart OpenCode after installation. This installs the plugin globally for all projects. The OpenCode cache directory name, including `@latest`, is only a package-specifier label and does not prove the package version. Verification reads the nested package's own `package.json` and checks `dist/tui.js`; it reports stale entries without deleting anything.
 
+### Uninstall safely
+
+This project provides a safe helper; OpenCode does **not** provide a native uninstall command. It defaults to both observed global configuration roots (`~/.config/opencode` and `~/.opencode`), shows a plan, and requires `--yes` before changing anything. It removes only this plugin from OpenCode plugin arrays and verified cache entries. It never removes OpenCode, Node, Bun, shared dependencies, or repository files.
+
+```powershell
+npm run uninstall-plugin -- --dry-run
+npm run uninstall-plugin -- --yes
+npm run uninstall-plugin -- --purge-cache --yes  # also remove all verified stale versions
+npm run uninstall-plugin -- --local              # current project's .opencode config
+```
+
+Use `--dry-run` first. Without `--yes`, no changes are made. An unversioned package entry removes all verified cache entries for this package; `--purge-cache` explicitly removes all verified entries even when no package entry is configured.
+
 OpenCode TUI plugin that adds live CPU, RAM, GPU, GPU VRAM, temperature, and network metrics to the `sidebar_content` slot.
 
 The README is available in **Español**, **English**, and **Português**.
@@ -63,6 +76,19 @@ opencode
 
 `npm run install-font` ejecuta el instalador compilado incluido en `dist/`, instala **Hack Nerd Font** únicamente para el usuario actual, no se ejecuta automáticamente durante `npm install` y solicita confirmación antes de descargar la fuente oficial.
 
+### Desinstalación segura
+
+Este proyecto incluye un asistente seguro; OpenCode **no** tiene un comando nativo de desinstalación. Por defecto actúa sobre ambas raíces globales observadas (`~/.config/opencode` y `~/.opencode`), muestra un informe y requiere `--yes` antes de cambiar archivos. Solo elimina este paquete de las listas de plugins y sus entradas de caché verificadas.
+
+```bash
+npm run uninstall-plugin -- --dry-run
+npm run uninstall-plugin -- --yes
+npm run uninstall-plugin -- --purge-cache --yes  # también elimina versiones antiguas verificadas
+npm run uninstall-plugin -- --local              # configuración .opencode del proyecto actual
+```
+
+Usa primero `--dry-run`. Sin `--yes` no se realizan cambios. Una entrada de paquete sin versión elimina todas las entradas de caché verificadas de este paquete; `--purge-cache` las elimina explícitamente.
+
 Comandos adicionales:
 
 ```bash
@@ -94,7 +120,7 @@ npm publish --access public
 En otro equipo:
 
 ```bash
-opencode plugin opencode-system-metrics-tui@0.1.11
+opencode plugin opencode-system-metrics-tui@0.1.13
 ```
 
 El paquete exporta tanto la raíz (`opencode-system-metrics-tui`) como `./tui`; ambas rutas cargan el mismo bundle TUI.
@@ -104,8 +130,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.11` lo instala solo en el proyecto actual.
-- `opencode plugin -g opencode-system-metrics-tui@0.1.11 --force` lo instala globalmente para todos los proyectos.
+- `opencode plugin opencode-system-metrics-tui@0.1.13` lo instala solo en el proyecto actual.
+- `opencode plugin -g opencode-system-metrics-tui@0.1.13 --force` lo instala globalmente para todos los proyectos.
 
 ### Verificación
 
@@ -134,6 +160,8 @@ npm run build
 - 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.
+- CPU and RAM use native, read-only paths without subprocesses during normal operation: Linux reads `/proc/stat` and `/proc/meminfo`; Windows uses `GetSystemTimes` and `GlobalMemoryStatusEx` through the lazy Koffi integration; macOS uses Mach host statistics and `hw.memsize` on both Intel and Apple Silicon. If native loading or a read fails, the existing `systeminformation` path is used with the existing timeout and cache protections.
+- Native CPU percentages are deltas between consecutive samples; the first sample is intentionally unavailable. Counter resets, malformed data, and API failures fall back safely. Apple Silicon retains unified-memory semantics and does not treat system RAM as discrete VRAM.
 - 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 one native `GetIfTable2` call from `iphlpapi.dll` through Koffi; the PowerShell path remains only as a bounded fallback when the native API cannot load.
@@ -159,6 +187,19 @@ opencode
 
 `npm run install-font` runs the compiled installer included in `dist/`, installs **Hack Nerd Font** for the current user only, is not executed automatically by `npm install`, and asks for confirmation before downloading the official font.
 
+### Safe uninstall
+
+This project provides a safe helper; OpenCode does **not** provide a native uninstall command. It targets both observed global configuration roots (`~/.config/opencode` and `~/.opencode`) by default, prints a report, and requires `--yes` before changing anything. It removes only this package from plugin lists and its verified cache entries.
+
+```bash
+npm run uninstall-plugin -- --dry-run
+npm run uninstall-plugin -- --yes
+npm run uninstall-plugin -- --purge-cache --yes  # also remove all verified stale versions
+npm run uninstall-plugin -- --local              # current project's .opencode config
+```
+
+Run `--dry-run` first. Without `--yes`, no changes are made. An unversioned package entry removes all verified cache entries for this package; `--purge-cache` explicitly removes all verified entries. Neither mode removes OpenCode, Node, Bun, shared dependencies, or repository files.
+
 Extra commands:
 
 ```bash
@@ -190,7 +231,7 @@ npm publish --access public
 On another machine:
 
 ```bash
-opencode plugin opencode-system-metrics-tui@0.1.11
+opencode plugin opencode-system-metrics-tui@0.1.13
 ```
 
 The package exports both the root (`opencode-system-metrics-tui`) and `./tui`; both paths load the same TUI bundle.
@@ -200,8 +241,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.11` installs it for the current project only.
-- `opencode plugin -g opencode-system-metrics-tui@0.1.11 --force` installs it globally for all projects.
+- `opencode plugin opencode-system-metrics-tui@0.1.13` installs it for the current project only.
+- `opencode plugin -g opencode-system-metrics-tui@0.1.13 --force` installs it globally for all projects.
 
 ### Verification
 
@@ -254,6 +295,19 @@ opencode
 
 `npm run install-font` executa o instalador compilado incluído em `dist/`, instala a **Hack Nerd Font** somente para o usuário atual, não é executado automaticamente durante `npm install` e pede confirmação antes de baixar a fonte oficial.
 
+### Desinstalação segura
+
+Este projeto inclui um assistente seguro; o OpenCode **não** oferece um comando nativo de desinstalação. Por padrão, ele usa ambas as raízes globais observadas (`~/.config/opencode` e `~/.opencode`), mostra um relatório e exige `--yes` antes de alterar arquivos. Remove apenas este pacote das listas de plugins e suas entradas de cache verificadas.
+
+```bash
+npm run uninstall-plugin -- --dry-run
+npm run uninstall-plugin -- --yes
+npm run uninstall-plugin -- --purge-cache --yes  # também remove versões antigas verificadas
+npm run uninstall-plugin -- --local              # configuração .opencode do projeto atual
+```
+
+Execute primeiro com `--dry-run`. Sem `--yes`, nenhuma alteração é feita. Uma entrada de pacote sem versão remove todas as entradas de cache verificadas deste pacote; `--purge-cache` remove explicitamente todas as entradas verificadas.
+
 Comandos adicionais:
 
 ```bash
@@ -285,7 +339,7 @@ npm publish --access public
 Em outro computador:
 
 ```bash
-opencode plugin opencode-system-metrics-tui@0.1.11
+opencode plugin opencode-system-metrics-tui@0.1.13
 ```
 
 O pacote exporta tanto a raiz (`opencode-system-metrics-tui`) quanto `./tui`; os dois caminhos carregam o mesmo bundle TUI.
@@ -295,8 +349,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.11` instala o plugin apenas no projeto atual.
-- `opencode plugin -g opencode-system-metrics-tui@0.1.11 --force` instala o plugin globalmente para todos os projetos.
+- `opencode plugin opencode-system-metrics-tui@0.1.13` instala o plugin apenas no projeto atual.
+- `opencode plugin -g opencode-system-metrics-tui@0.1.13 --force` instala o plugin globalmente para todos os projetos.
 
 ### Verificação
 

package/dist/tui.js

@@ -6,7 +6,7 @@ import { insertNode as _$insertNode } from "@opentui/solid";
 import { insert as _$insert } from "@opentui/solid";
 import { setProp as _$setProp } from "@opentui/solid";
 import { createElement as _$createElement } from "@opentui/solid";
-import { createMemo, createSignal, onCleanup, onMount } from "solid-js";
+import { Show, createMemo, createSignal, onCleanup, onMount } from "solid-js";
 import { TextAttributes } from "@opentui/core";
 
 // src/format.ts
@@ -160,6 +160,189 @@ async function readWindowsNetworkCounters() {
   return mapWindowsNetworkRows((await nativeReader)());
 }
 
+// src/native-metrics.ts
+import { readFile } from "node:fs/promises";
+function parseLinuxCpuCounters(stat) {
+  const line = stat.split(/\r?\n/).find((item) => /^cpu(?:\s|$)/.test(item));
+  if (line === undefined)
+    return;
+  const fields = line.trim().split(/\s+/).slice(1);
+  if (fields.length < 4)
+    return;
+  const values = fields.map((value) => {
+    try {
+      const parsed = BigInt(value);
+      return parsed >= 0n ? parsed : undefined;
+    } catch {
+      return;
+    }
+  });
+  if (values.some((value) => value === undefined))
+    return;
+  const numbers = values;
+  return { total: numbers.reduce((sum, value) => sum + value, 0n), idle: numbers[3] + (numbers[4] ?? 0n) };
+}
+function cpuPercentFromCounters(current, previous) {
+  if (previous === undefined || current.total < previous.total || current.idle < previous.idle)
+    return;
+  const totalDelta = current.total - previous.total;
+  const idleDelta = current.idle - previous.idle;
+  if (totalDelta <= 0n || idleDelta > totalDelta)
+    return;
+  return Number((totalDelta - idleDelta) * 10000n / totalDelta) / 100;
+}
+function parseLinuxMemoryInfo(meminfo) {
+  const values = new Map;
+  for (const line of meminfo.split(/\r?\n/)) {
+    const match = /^(MemTotal|MemAvailable|MemFree|Buffers|Cached):\s+(\d+)(?:\s+kB)?\s*$/.exec(line);
+    if (match !== null)
+      values.set(match[1], Number(match[2]) * 1024);
+  }
+  const total = values.get("MemTotal");
+  const hasAvailable = values.has("MemAvailable") || values.has("MemFree") || values.has("Buffers") || values.has("Cached");
+  const available = values.get("MemAvailable") ?? (values.get("MemFree") ?? 0) + (values.get("Buffers") ?? 0) + (values.get("Cached") ?? 0);
+  if (total === undefined || !hasAvailable || !Number.isSafeInteger(total) || !Number.isSafeInteger(available) || total <= 0 || available < 0)
+    return;
+  return { totalBytes: total, availableBytes: Math.min(total, available) };
+}
+function mapMemoryBytes(totalBytes, availableBytes) {
+  if (!Number.isSafeInteger(totalBytes) || !Number.isSafeInteger(availableBytes) || totalBytes <= 0 || availableBytes < 0)
+    return;
+  return { memoryTotalBytes: totalBytes, memoryAvailableBytes: Math.min(totalBytes, availableBytes) };
+}
+var reader;
+async function readNativeMetrics() {
+  reader ??= (async () => {
+    if (process.platform === "linux")
+      return createLinuxReader();
+    if (process.platform === "win32")
+      return createWindowsReader();
+    if (process.platform === "darwin")
+      return createMacReader();
+    throw new Error(`Native CPU/RAM metrics are unsupported on ${process.platform}`);
+  })();
+  return (await reader)();
+}
+function createLinuxReader() {
+  let previous;
+  return async () => {
+    const [stat, meminfo] = await Promise.all([readFile("/proc/stat", "utf8"), readFile("/proc/meminfo", "utf8")]);
+    const counters = parseLinuxCpuCounters(stat);
+    const memory = parseLinuxMemoryInfo(meminfo);
+    if (counters === undefined || memory === undefined)
+      throw new Error("Malformed Linux CPU/RAM data");
+    const cpuPercent = cpuPercentFromCounters(counters, previous);
+    previous = cpuPercent === undefined && previous !== undefined ? undefined : counters;
+    return { cpuPercent, memoryTotalBytes: memory.totalBytes, memoryAvailableBytes: memory.availableBytes };
+  };
+}
+async function createWindowsReader() {
+  const loaded = await import("koffi");
+  const koffi = loaded.default ?? loaded;
+  koffi.struct("FILETIME", { low: "uint32", high: "uint32" });
+  const memoryStatus = koffi.struct("MEMORYSTATUSEX", {
+    length: "uint32",
+    memoryLoad: "uint32",
+    total: "uint64",
+    available: "uint64",
+    pageFile: "uint64",
+    availablePageFile: "uint64",
+    virtual: "uint64",
+    availableVirtual: "uint64",
+    availableExtended: "uint64"
+  });
+  const kernel32 = koffi.load("kernel32.dll");
+  const getSystemTimes = kernel32.func("int __stdcall GetSystemTimes(_Out_ FILETIME *idle, _Out_ FILETIME *kernel, _Out_ FILETIME *user)");
+  const globalMemoryStatusEx = kernel32.func("int __stdcall GlobalMemoryStatusEx(_Inout_ MEMORYSTATUSEX *status)");
+  let previous;
+  return async () => {
+    const idle = {};
+    const kernel = {};
+    const user = {};
+    if (!getSystemTimes(idle, kernel, user))
+      throw new Error("GetSystemTimes failed");
+    const toUint64 = (value) => BigInt(value.low ?? 0) + (BigInt(value.high ?? 0) << 32n);
+    const counters = { total: toUint64(kernel) + toUint64(user), idle: toUint64(idle) };
+    const cpuPercent = cpuPercentFromCounters(counters, previous);
+    previous = cpuPercent === undefined && previous !== undefined ? undefined : counters;
+    const status = { length: koffi.sizeof(memoryStatus) };
+    if (!globalMemoryStatusEx(status))
+      throw new Error("GlobalMemoryStatusEx failed");
+    const memory = mapMemoryBytes(Number(status.total ?? 0n), Number(status.available ?? 0n));
+    if (memory === undefined)
+      throw new Error("Malformed Windows RAM data");
+    return { cpuPercent, ...memory };
+  };
+}
+async function createMacReader() {
+  const loaded = await import("koffi");
+  const koffi = loaded.default ?? loaded;
+  const vmStatistics = koffi.struct("vm_statistics64", {
+    free_count: "uint32",
+    active_count: "uint32",
+    inactive_count: "uint32",
+    wire_count: "uint32",
+    zero_fill_count: "uint32",
+    reactivations: "uint32",
+    pageins: "uint32",
+    pageouts: "uint32",
+    faults: "uint32",
+    cow_faults: "uint32",
+    lookups: "uint32",
+    hits: "uint32",
+    purgeable_count: "uint32",
+    speculative_count: "uint32",
+    decompressions: "uint32",
+    compressions: "uint32",
+    swapins: "uint32",
+    swapouts: "uint32",
+    compressor_page_count: "uint32",
+    throttled_count: "uint32",
+    external_page_count: "uint32",
+    internal_page_count: "uint32",
+    total_uncompressed_pages_in_compressor: "uint32"
+  });
+  const cpuLoad = koffi.struct("host_cpu_load_info", { user: "uint32", system: "uint32", idle: "uint32", nice: "uint32" });
+  const libc = koffi.load("libSystem.B.dylib");
+  const sysctlbyname = libc.func("int sysctlbyname(const char *name, void *oldp, size_t *oldlenp, const void *newp, size_t newlen)");
+  const machHostSelf = libc.func("uint32 mach_host_self()");
+  const hostStatistics64 = libc.func("int host_statistics64(uint32 host, int flavor, _Out_ vm_statistics64 *stats, _Inout_ uint32_t *count)");
+  const hostCpuLoad = libc.func("int host_statistics(uint32 host, int flavor, _Out_ host_cpu_load_info *load, _Inout_ uint32_t *count)");
+  const readUint64Sysctl = (name) => {
+    const output = koffi.alloc("uint64", 1);
+    const length = [8];
+    if (sysctlbyname(name, output, length, null, 0) !== 0)
+      throw new Error(`sysctlbyname failed: ${name}`);
+    return Number(koffi.decode(output, "uint64"));
+  };
+  const totalBytes = readUint64Sysctl("hw.memsize");
+  const pageSize = readUint64Sysctl("hw.pagesize");
+  if (!Number.isSafeInteger(totalBytes) || !Number.isSafeInteger(pageSize) || pageSize <= 0)
+    throw new Error("Malformed macOS memory data");
+  let previous;
+  return async () => {
+    const load = {};
+    const loadCount = [4];
+    if (hostCpuLoad(machHostSelf(), 3, load, loadCount) !== 0)
+      throw new Error("host_statistics failed");
+    const counters = {
+      total: BigInt(load.user ?? 0) + BigInt(load.system ?? 0) + BigInt(load.idle ?? 0) + BigInt(load.nice ?? 0),
+      idle: BigInt(load.idle ?? 0)
+    };
+    const cpuPercent = cpuPercentFromCounters(counters, previous);
+    previous = cpuPercent === undefined && previous !== undefined ? undefined : counters;
+    const stats = {};
+    const count = [38];
+    if (hostStatistics64(machHostSelf(), 4, stats, count) !== 0)
+      throw new Error("host_statistics64 failed");
+    const availablePages = (stats.free_count ?? 0) + (stats.inactive_count ?? 0) + (stats.purgeable_count ?? 0) + (stats.speculative_count ?? 0);
+    const memory = mapMemoryBytes(totalBytes, availablePages * pageSize);
+    if (memory === undefined)
+      throw new Error("Malformed macOS RAM data");
+    return { cpuPercent, ...memory };
+  };
+}
+
 // src/metrics.ts
 var execFileAsync = promisify(execFile);
 var DEFAULT_METRIC_TIMEOUT_MS = 1500;
@@ -451,21 +634,31 @@ async function readWindowsCpuTemperature() {
   return value === undefined ? undefined : { main: value };
 }
 async function readMetrics() {
-  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),
+  const [native, hardwareArchitecture] = await Promise.allSettled([
+    withTimeout(readNativeMetrics(), isWindows ? WINDOWS_MEMORY_TIMEOUT_MS : DEFAULT_METRIC_TIMEOUT_MS),
     readMacHardwareArchitecture()
   ]);
+  let cpuPercent = native.status === "fulfilled" ? finite(native.value.cpuPercent) : null;
+  let memoryTotalBytes = native.status === "fulfilled" ? finite(native.value.memoryTotalBytes) : null;
+  let memoryAvailableBytes = native.status === "fulfilled" ? finite(native.value.memoryAvailableBytes) : null;
+  let fallbackMemoryUsedBytes = null;
+  if (native.status !== "fulfilled") {
+    const [load, memory] = await Promise.allSettled([
+      withTimeout(si.currentLoad(), DEFAULT_METRIC_TIMEOUT_MS),
+      withTimeout(si.mem(), isWindows ? WINDOWS_MEMORY_TIMEOUT_MS : DEFAULT_METRIC_TIMEOUT_MS)
+    ]);
+    cpuPercent = load.status === "fulfilled" ? finite(load.value.currentLoad) : null;
+    memoryTotalBytes = memory.status === "fulfilled" ? finite(memory.value.total) : null;
+    memoryAvailableBytes = memory.status === "fulfilled" ? finite(memory.value.available) : null;
+    fallbackMemoryUsedBytes = memoryTotalBytes !== null && memoryAvailableBytes !== null ? Math.max(0, memoryTotalBytes - memoryAvailableBytes) : memory.status === "fulfilled" ? finite(memory.value.used) : null;
+  }
   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, 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;
-  const memoryAvailableBytes = memory.status === "fulfilled" ? finite(memory.value.available) : null;
-  const memoryUsedBytes = memoryTotalBytes !== null && memoryAvailableBytes !== null ? Math.max(0, memoryTotalBytes - memoryAvailableBytes) : memory.status === "fulfilled" ? finite(memory.value.used) : null;
+  const memoryUsedBytes = fallbackMemoryUsedBytes ?? (memoryTotalBytes !== null && memoryAvailableBytes !== null ? Math.max(0, memoryTotalBytes - memoryAvailableBytes) : 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;
@@ -657,12 +850,11 @@ function MetricsPanel(props) {
     };
   });
   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$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(` ↑ `);
+    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$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$33);
     _$setProp(_el$, "flexDirection", "column");
     _$setProp(_el$, "paddingLeft", 0);
@@ -704,20 +896,40 @@ function MetricsPanel(props) {
     _$insert(_el$21, () => formatPercent(metricsState.sharedMetrics().gpuPercent), _el$22);
     _$insert(_el$21, () => icons.thermometer, _el$23);
     _$insert(_el$21, () => formatTemperature(metricsState.sharedMetrics().gpuTemperatureCelsius), null);
-    _$insertNode(_el$24, _el$25);
-    _$insertNode(_el$24, _el$26);
-    _$insertNode(_el$24, _el$29);
-    _$setProp(_el$24, "flexDirection", "row");
-    _$insert(_el$25, () => gpuMemory().icon);
-    _$insertNode(_el$26, _el$27);
-    _$insertNode(_el$26, _el$28);
-    _$insert(_el$26, () => gpuMemory().label, _el$28);
-    _$insertNode(_el$29, _el$30);
-    _$insertNode(_el$29, _el$31);
-    _$insertNode(_el$29, _el$32);
-    _$insert(_el$29, () => formatGiB(gpuMemory().usedBytes), _el$30);
-    _$insert(_el$29, () => formatGiB(gpuMemory().totalBytes), _el$31);
-    _$insert(_el$29, () => formatPercent(gpuMemory().percent), _el$32);
+    _$insert(_el$, _$createComponent(Show, {
+      get when() {
+        return metricsState.sharedMetrics().gpuMemoryIsUnified !== true;
+      },
+      get children() {
+        var _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(`)`);
+        _$insertNode(_el$24, _el$25);
+        _$insertNode(_el$24, _el$26);
+        _$insertNode(_el$24, _el$29);
+        _$setProp(_el$24, "flexDirection", "row");
+        _$insert(_el$25, () => gpuMemory().icon);
+        _$insertNode(_el$26, _el$27);
+        _$insertNode(_el$26, _el$28);
+        _$insert(_el$26, () => gpuMemory().label, _el$28);
+        _$insertNode(_el$29, _el$30);
+        _$insertNode(_el$29, _el$31);
+        _$insertNode(_el$29, _el$32);
+        _$insert(_el$29, () => formatGiB(gpuMemory().usedBytes), _el$30);
+        _$insert(_el$29, () => formatGiB(gpuMemory().totalBytes), _el$31);
+        _$insert(_el$29, () => formatPercent(gpuMemory().percent), _el$32);
+        _$effect((_p$) => {
+          var _v$ = props.theme.success, _v$2 = props.theme.text, _v$3 = props.theme.textMuted;
+          _v$ !== _p$.e && (_p$.e = _$setProp(_el$25, "fg", _v$, _p$.e));
+          _v$2 !== _p$.t && (_p$.t = _$setProp(_el$26, "fg", _v$2, _p$.t));
+          _v$3 !== _p$.a && (_p$.a = _$setProp(_el$29, "fg", _v$3, _p$.a));
+          return _p$;
+        }, {
+          e: undefined,
+          t: undefined,
+          a: undefined
+        });
+        return _el$24;
+      }
+    }), _el$33);
     _$insertNode(_el$33, _el$34);
     _$insertNode(_el$33, _el$35);
     _$insertNode(_el$33, _el$37);
@@ -729,24 +941,21 @@ function MetricsPanel(props) {
     _$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));
-      _v$2 !== _p$.t && (_p$.t = _$setProp(_el$2, "attributes", _v$2, _p$.t));
-      _v$3 !== _p$.a && (_p$.a = _$setProp(_el$5, "fg", _v$3, _p$.a));
-      _v$4 !== _p$.o && (_p$.o = _$setProp(_el$6, "fg", _v$4, _p$.o));
-      _v$5 !== _p$.i && (_p$.i = _$setProp(_el$8, "fg", _v$5, _p$.i));
-      _v$6 !== _p$.n && (_p$.n = _$setProp(_el$10, "fg", _v$6, _p$.n));
-      _v$7 !== _p$.s && (_p$.s = _$setProp(_el$11, "fg", _v$7, _p$.s));
-      _v$8 !== _p$.h && (_p$.h = _$setProp(_el$13, "fg", _v$8, _p$.h));
-      _v$9 !== _p$.r && (_p$.r = _$setProp(_el$18, "fg", _v$9, _p$.r));
-      _v$0 !== _p$.d && (_p$.d = _$setProp(_el$19, "fg", _v$0, _p$.d));
-      _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$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));
+      var _v$4 = props.theme.text, _v$5 = TextAttributes.BOLD, _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$4 !== _p$.e && (_p$.e = _$setProp(_el$2, "fg", _v$4, _p$.e));
+      _v$5 !== _p$.t && (_p$.t = _$setProp(_el$2, "attributes", _v$5, _p$.t));
+      _v$6 !== _p$.a && (_p$.a = _$setProp(_el$5, "fg", _v$6, _p$.a));
+      _v$7 !== _p$.o && (_p$.o = _$setProp(_el$6, "fg", _v$7, _p$.o));
+      _v$8 !== _p$.i && (_p$.i = _$setProp(_el$8, "fg", _v$8, _p$.i));
+      _v$9 !== _p$.n && (_p$.n = _$setProp(_el$10, "fg", _v$9, _p$.n));
+      _v$0 !== _p$.s && (_p$.s = _$setProp(_el$11, "fg", _v$0, _p$.s));
+      _v$1 !== _p$.h && (_p$.h = _$setProp(_el$13, "fg", _v$1, _p$.h));
+      _v$10 !== _p$.r && (_p$.r = _$setProp(_el$18, "fg", _v$10, _p$.r));
+      _v$11 !== _p$.d && (_p$.d = _$setProp(_el$19, "fg", _v$11, _p$.d));
+      _v$12 !== _p$.l && (_p$.l = _$setProp(_el$21, "fg", _v$12, _p$.l));
+      _v$13 !== _p$.u && (_p$.u = _$setProp(_el$34, "fg", _v$13, _p$.u));
+      _v$14 !== _p$.c && (_p$.c = _$setProp(_el$35, "fg", _v$14, _p$.c));
+      _v$15 !== _p$.w && (_p$.w = _$setProp(_el$37, "fg", _v$15, _p$.w));
       return _p$;
     }, {
       e: undefined,
@@ -762,10 +971,7 @@ function MetricsPanel(props) {
       l: undefined,
       u: undefined,
       c: undefined,
-      w: undefined,
-      m: undefined,
-      f: undefined,
-      y: undefined
+      w: undefined
     });
     return _el$;
   })();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-system-metrics-tui",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "OpenCode TUI sidebar plugin for live system metrics",
   "license": "MIT",
   "type": "module",
@@ -25,7 +25,8 @@
     "typecheck": "tsc --noEmit",
     "install-font": "node dist/install-hack-font.js",
     "verify-installation": "tsx scripts/plugin-installation.ts",
-    "install-plugin": "tsx scripts/install-plugin.ts"
+    "install-plugin": "tsx scripts/install-plugin.ts",
+    "uninstall-plugin": "tsx scripts/uninstall-plugin.ts"
   },
   "engines": {
     "node": ">=18"

package/scripts/uninstall-plugin.ts

@@ -0,0 +1,202 @@
+import { lstat, readFile, readdir, rm, stat, writeFile } from "node:fs/promises"
+import { homedir } from "node:os"
+import { basename, isAbsolute, join, relative, resolve } from "node:path"
+import { fileURLToPath } from "node:url"
+
+export type UninstallScope = "global" | "local"
+
+export type ConfigChange = {
+  path: string
+  removed: string[]
+  content: string
+}
+
+export type CacheCandidate = {
+  path: string
+  version: string
+}
+
+export type UninstallPlan = {
+  configChanges: ConfigChange[]
+  cacheCandidates: CacheCandidate[]
+  warnings: string[]
+}
+
+type PackageManifest = { name?: unknown; version?: unknown }
+
+const packageManifest = JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8")) as { name: string }
+const packageName = packageManifest.name
+
+function isPackageSpec(value: unknown, name: string): value is string {
+  return typeof value === "string" && (value === name || value.startsWith(`${name}@`))
+}
+
+function filterPluginArrays(value: unknown, name: string, removed: string[]): unknown {
+  if (Array.isArray(value)) return value
+  if (value === null || typeof value !== "object") return value
+
+  const result: Record<string, unknown> = {}
+  for (const [key, child] of Object.entries(value)) {
+    if ((key === "plugin" || key === "plugins") && Array.isArray(child)) {
+      result[key] = child.filter((entry) => {
+        const spec = typeof entry === "string" ? entry : Array.isArray(entry) ? entry[0] : undefined
+        if (!isPackageSpec(spec, name)) return true
+        removed.push(spec)
+        return false
+      })
+    } else {
+      result[key] = filterPluginArrays(child, name, removed)
+    }
+  }
+  return result
+}
+
+export function filterPluginConfig(content: string, name = packageName): { content: string; removed: string[] } {
+  const parsed: unknown = JSON.parse(content)
+  const removed: string[] = []
+  const filtered = filterPluginArrays(parsed, name, removed)
+  const newline = content.includes("\r\n") ? "\r\n" : "\n"
+  const serialized = JSON.stringify(filtered, null, 2)
+  return { content: `${serialized.replaceAll("\n", newline)}${newline}`, removed }
+}
+
+export function getConfigPaths(scope: UninstallScope, cwd = process.cwd(), home = homedir(), env: NodeJS.ProcessEnv = process.env): string[] {
+  if (scope === "local") return [join(cwd, ".opencode", "tui.json"), join(cwd, ".opencode", "opencode.json"), join(cwd, "opencode.json")]
+  const configRoot = env.XDG_CONFIG_HOME ?? join(home, ".config")
+  const globalRoots = [join(configRoot, "opencode"), join(home, ".config", "opencode"), join(home, ".opencode")]
+  return [...new Set([
+    ...globalRoots.flatMap((root) => [join(root, "tui.json"), join(root, "opencode.json")]),
+    join(configRoot, "opencode.json"),
+  ])]
+}
+
+export function getCachePackagesRoot(home = homedir(), env: NodeJS.ProcessEnv = process.env): string {
+  const cacheRoot = env.OPENCODE_CACHE_DIR ?? env.XDG_CACHE_HOME ?? join(home, ".cache")
+  return join(cacheRoot, "opencode", "packages")
+}
+
+function isWithin(root: string, candidate: string): boolean {
+  const fromRoot = relative(resolve(root), resolve(candidate))
+  return fromRoot !== "" && !fromRoot.startsWith("..") && !isAbsolute(fromRoot)
+}
+
+async function readPackageManifest(path: string): Promise<PackageManifest | undefined> {
+  try {
+    return JSON.parse(await readFile(path, "utf8")) as PackageManifest
+  } catch {
+    return undefined
+  }
+}
+
+export async function findCacheCandidates(
+  cacheRoot: string,
+  name = packageName,
+  versions: Set<string> | undefined = undefined,
+  purgeCache = false,
+): Promise<{ candidates: CacheCandidate[]; warnings: string[] }> {
+  const root = resolve(cacheRoot)
+  const candidates: CacheCandidate[] = []
+  const warnings: string[] = []
+  let entries
+  try {
+    if ((await lstat(root)).isSymbolicLink()) throw new Error(`Unexpected symbolic link cache root: ${root}`)
+    entries = await readdir(root, { withFileTypes: true })
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException).code === "ENOENT") return { candidates, warnings }
+    if (error instanceof Error && error.message.startsWith("Unexpected symbolic link cache root:")) throw error
+    throw new Error(`Cannot inspect OpenCode cache root: ${root}`)
+  }
+
+  for (const entry of entries) {
+    if (!entry.isDirectory() || !entry.name.startsWith(`${name}@`)) continue
+    const candidatePath = join(root, entry.name)
+    if (!isWithin(root, candidatePath) || basename(candidatePath) !== entry.name) throw new Error(`Unexpected cache path: ${candidatePath}`)
+    const manifest = await readPackageManifest(join(candidatePath, "node_modules", name, "package.json"))
+    if (manifest?.name !== name || typeof manifest.version !== "string") {
+      warnings.push(`Skipped unverified cache entry: ${candidatePath}`)
+      continue
+    }
+    if (purgeCache || versions?.has(manifest.version)) candidates.push({ path: candidatePath, version: manifest.version })
+  }
+  candidates.sort((left, right) => left.path.localeCompare(right.path))
+  return { candidates, warnings }
+}
+
+export async function buildUninstallPlan(options: {
+  scope: UninstallScope
+  configPaths?: string[]
+  cacheRoot?: string
+  packageName?: string
+  purgeCache?: boolean
+}): Promise<UninstallPlan> {
+  const name = options.packageName ?? packageName
+  const configChanges: ConfigChange[] = []
+  const versions = new Set<string>()
+  const warnings: string[] = []
+  let hasUnversionedPackage = false
+
+  for (const path of options.configPaths ?? getConfigPaths(options.scope)) {
+    let content: string
+    try {
+      if ((await lstat(path)).isSymbolicLink()) throw new Error(`Unexpected symbolic link config path: ${path}`)
+      content = await readFile(path, "utf8")
+    }
+    catch (error) {
+      if ((error as NodeJS.ErrnoException).code === "ENOENT") continue
+      throw new Error(`Cannot read OpenCode config: ${path}`)
+    }
+    let filtered: { content: string; removed: string[] }
+    try { filtered = filterPluginConfig(content, name) }
+    catch { throw new Error(`Malformed OpenCode config: ${path}`) }
+    if (filtered.removed.length === 0) continue
+    for (const spec of filtered.removed) {
+      if (spec === name) hasUnversionedPackage = true
+      const version = spec.slice(name.length + 1)
+      if (version && version !== "latest") versions.add(version)
+    }
+    configChanges.push({ path, removed: filtered.removed, content: filtered.content })
+  }
+
+  const cache = await findCacheCandidates(options.cacheRoot ?? getCachePackagesRoot(), name, versions, options.purgeCache || hasUnversionedPackage)
+  return { configChanges, cacheCandidates: cache.candidates, warnings: [...warnings, ...cache.warnings] }
+}
+
+function printPlan(plan: UninstallPlan, dryRun: boolean): void {
+  console.log(dryRun ? "Uninstall dry run (no changes will be made):" : "Uninstall plan:")
+  for (const change of plan.configChanges) console.log(`Config ${dryRun ? "would remove" : "remove"} ${change.removed.join(", ")} from ${change.path}`)
+  for (const candidate of plan.cacheCandidates) console.log(`Cache ${dryRun ? "would remove" : "remove"} ${candidate.path} (${candidate.version})`)
+  if (plan.configChanges.length === 0 && plan.cacheCandidates.length === 0) console.log("No matching plugin configuration or verified cache entries found.")
+  for (const warning of plan.warnings) console.warn(`Warning: ${warning}`)
+}
+
+export async function uninstallPlugin(args = process.argv.slice(2)): Promise<void> {
+  const scope: UninstallScope = args.includes("--local") ? "local" : "global"
+  if (args.includes("--local") && args.includes("--global")) throw new Error("Choose only one scope: --local or --global")
+  const purgeCache = args.includes("--purge-cache")
+  const dryRun = args.includes("--dry-run") || args.includes("--report")
+  const yes = args.includes("--yes")
+  const plan = await buildUninstallPlan({ scope, purgeCache })
+  printPlan(plan, dryRun)
+  if (dryRun || (plan.configChanges.length === 0 && plan.cacheCandidates.length === 0)) return
+  if (!yes) {
+    console.log("Destructive uninstall requires --yes; no changes were made.")
+    return
+  }
+
+  for (const change of plan.configChanges) {
+    if (!isAbsolute(change.path) || (await lstat(change.path)).isSymbolicLink()) throw new Error(`Unexpected config path: ${change.path}`)
+    const mode = (await stat(change.path)).mode
+    await writeFile(change.path, change.content, { mode })
+  }
+  const cacheRoot = resolve(getCachePackagesRoot())
+  for (const candidate of plan.cacheCandidates) {
+    if (!isWithin(cacheRoot, candidate.path) || !basename(candidate.path).startsWith(`${packageName}@`) || (await lstat(candidate.path)).isSymbolicLink()) throw new Error(`Unexpected cache path: ${candidate.path}`)
+    await rm(candidate.path, { recursive: true, force: false })
+  }
+  console.log("Uninstall completed. Restart OpenCode if it was running.")
+}
+
+if (process.argv[1] !== undefined && resolve(process.argv[1]) === resolve(fileURLToPath(import.meta.url))) {
+  try { await uninstallPlugin() }
+  catch (error) { console.error(error instanceof Error ? error.message : String(error)); process.exitCode = 1 }
+}