opencode-openrouter-costs 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcelo (mhenrique94)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# opencode-openrouter-costs
+
+[English](./README.md) | [Português (BR)](./README.pt-BR.md)
+
+OpenCode TUI plugin — sidebar widget showing OpenRouter session cost and account balance.
+
+## Install
+
+```sh
+# From npm (recommended)
+npx opencode-openrouter-costs
+
+# From source (GitHub)
+npx github:mhenrique94/opencode-openrouter-costs
+```
+
+The installer asks for your preferred language (English or Portuguese) on first run.
+All subsequent output — installer instructions and the widget itself — will use that language.
+
+## What it does
+
+Adds a compact widget to the OpenCode sidebar (above "MCP Servers"):
+
+```
+OpenRouter
+Session: $0.0523
+Balance: $4.21
+```
+
+- **Session** — cost of the current session (resets on new session)
+- **Balance** — remaining OpenRouter account credit
+
+## Requirements
+
+- OpenCode >= 1.18.30
+- OpenRouter provider configured (via `/models` or `OPENROUTER_API_KEY`)
+
+## Uninstall
+
+```sh
+npx opencode-openrouter-costs --remove
+```
+
+## Language
+
+The widget supports English and Portuguese (BR). The language is chosen at install time
+and persisted in `~/.config/opencode/openrouter-cost.json`. To switch later, re-run the
+installer or edit the config file directly:
+
+```json
+{"lang": "pt"}
+```
+
+Valid values: `"en"` or `"pt"`.
+
+## License
+
+MIT

package/README.pt-BR.md

@@ -0,0 +1,54 @@
+# opencode-openrouter-costs
+
+[English](./README.md) | [Português (BR)](./README.pt-BR.md)
+
+Plugin TUI para OpenCode — widget no painel lateral mostrando gasto da sessão e saldo da conta OpenRouter.
+
+## Instalar
+
+```sh
+# Do npm (recomendado)
+npx opencode-openrouter-costs
+
+# Do código-fonte (GitHub)
+npx github:mhenrique94/opencode-openrouter-costs
+```
+
+O instalador pergunta o idioma preferido (Inglês ou Português) na primeira execução.
+Todo o output subsequente — instruções do instalador e o próprio widget — usa o idioma escolhido.
+
+## O que faz
+
+Adiciona um widget compacto no sidebar do OpenCode (acima de "Servidor MCP"):
+
+![Widget OpenRouter em Português — Sessão e Saldo](img/widget-pt.png)
+
+- **Sessão** — gasto da sessão atual (reseta ao criar nova sessão)
+- **Saldo** — crédito restante da conta OpenRouter
+
+## Requisitos
+
+- OpenCode >= 1.18.30
+- Provider OpenRouter configurado (via `/models` ou `OPENROUTER_API_KEY`)
+
+## Desinstalar
+
+```sh
+npx opencode-openrouter-costs --remove
+```
+
+## Idioma
+
+O widget suporta Inglês e Português (BR). O idioma é escolhido no momento da instalação
+e salvo em `~/.config/opencode/openrouter-cost.json`. Para trocar depois, execute o
+instalador novamente ou edite o arquivo de config diretamente:
+
+```json
+{"lang": "pt"}
+```
+
+Valores válidos: `"en"` ou `"pt"`.
+
+## Licença
+
+MIT

package/bin/openrouter-costs.mjs

@@ -0,0 +1,449 @@
+#!/usr/bin/env node
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync, unlinkSync } from "fs"
+import { join, dirname } from "path"
+import { homedir } from "os"
+import { createInterface } from "readline"
+import { fileURLToPath } from "url"
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+const CONFIG_DIR = join(homedir(), ".config", "opencode")
+const PLUGINS_DIR = join(CONFIG_DIR, "plugins")
+const PLUGIN_NAME = "openrouter-cost.tsx"
+const PLUGIN_DEST = join(PLUGINS_DIR, PLUGIN_NAME)
+const PLUGIN_REL = `./plugins/${PLUGIN_NAME}`
+const TUI_JSON = join(CONFIG_DIR, "tui.json")
+const PKG_JSON = join(CONFIG_DIR, "package.json")
+const PLUGIN_SRC = join(__dirname, "..", "src", "plugin", PLUGIN_NAME)
+const LANG_JSON = join(CONFIG_DIR, "openrouter-cost.json")
+
+const DEPS = {
+  "@opentui/solid": "0.5.11",
+  "solid-js": "1.9.12",
+}
+
+const MESSAGES = {
+  en: {
+    banner: "OpenRouter Cost Plugin — installer for OpenCode\n",
+    steps: (plugin, pluginsDir, tuiJson, pkgJson) =>
+      [
+        "What will happen:",
+        `  1. Copy ${plugin} → ${pluginsDir}/`,
+        `  2. Add entry to ${tuiJson} (plugin)`,
+        `  3. Ensure @opentui/solid + solid-js in ${pkgJson}`,
+      ].join("\n"),
+    requirements: "Requirements: OpenCode >= 1.18.30 with OpenRouter provider configured\n",
+    confirm: "Install? [y/N] ",
+    copying: "1. Copying plugin...",
+    copied: "Copied.",
+    identical: "Plugin already exists and is identical — skip.",
+    existsPrompt: "   Plugin already exists; overwrite? [y/N] ",
+    existsYes: "Overwritten.",
+    existsSkip: "Skip.",
+    updatingTui: "2. Updating tui.json...",
+    addedTui: (plugin) => `Added ${plugin} to plugin array.`,
+    tuiExists: "Entry already exists — skip.",
+    addingDeps: "3. Ensuring dependencies in package.json...",
+    depsAdded: "Dependencies added.",
+    depsExists: "Dependencies already present — skip.",
+    skippedDeps: "Skipping dependencies (--no-deps).",
+    success: [
+      "",
+      "Plugin installed! Restart OpenCode and open a session.",
+      'The widget appears in the sidebar above "MCP Servers".',
+      "",
+      'If OpenRouter is not configured, the widget shows "not configured".',
+      "Configure via /models or set OPENROUTER_API_KEY.",
+    ].join("\n"),
+    dryRun: (from, to) => `[dry-run] Would copy ${from} → ${to}`,
+    bannerRemove: "OpenRouter Cost Plugin — Uninstaller\n",
+    confirmRemove: "Remove plugin? [y/N] ",
+    removingPlugin: "1. Removing plugin...",
+    removedPlugin: "Removed.",
+    pluginNotFound: "Plugin not found — skip.",
+    removingTui: "2. Removing from tui.json...",
+    removedTui: "Removed.",
+    tuiNotFound: "tui.json not found or no plugin array — skip.",
+    removingDeps: "3. Removing dependencies...",
+    removedDeps: "Dependencies removed.",
+    depsNotFound: "Dependencies not found — skip.",
+    successRemove: "Plugin removed. Restart OpenCode.",
+    cancelled: "Cancelled.",
+  },
+  pt: {
+    banner: "OpenRouter Cost Plugin — instalador para OpenCode\n",
+    steps: (plugin, pluginsDir, tuiJson, pkgJson) =>
+      [
+        "O que será feito:",
+        `  1. Copiar ${plugin} → ${pluginsDir}/`,
+        `  2. Adicionar entrada em ${tuiJson} (plugin)`,
+        `  3. Garantir @opentui/solid + solid-js em ${pkgJson}`,
+      ].join("\n"),
+    requirements: "Requisitos: OpenCode >= 1.18.30 com provider OpenRouter configurado\n",
+    confirm: "Instalar? [y/N] ",
+    copying: "1. Copiando plugin...",
+    copied: "Copiado.",
+    identical: "Plugin já existe e é idêntico — skip.",
+    existsPrompt: "   Plugin já existe; reescrever? [y/N] ",
+    existsYes: "Reescrito.",
+    existsSkip: "Skip.",
+    updatingTui: "2. Atualizando tui.json...",
+    addedTui: (plugin) => `Adicionado ${plugin} ao plugin array.`,
+    tuiExists: "Entrada já existe — skip.",
+    addingDeps: "3. Garantindo dependências em package.json...",
+    depsAdded: "Dependências adicionadas.",
+    depsExists: "Dependências já presentes — skip.",
+    skippedDeps: "Pulando dependências (--no-deps).",
+    success: [
+      "",
+      "Plugin instalado! Reinicie o OpenCode e abra uma sessão.",
+      'O widget aparece no sidebar acima de "Servidor MCP".',
+      "",
+      'Se o OpenRouter não estiver configurado, o widget mostra "não configurado".',
+      "Configure via /models ou setando OPENROUTER_API_KEY.",
+    ].join("\n"),
+    dryRun: (from, to) => `[dry-run] Copiaria ${from} → ${to}`,
+    bannerRemove: "OpenRouter Cost Plugin — Desinstalador\n",
+    confirmRemove: "Remover plugin? [y/N] ",
+    removingPlugin: "1. Removendo plugin...",
+    removedPlugin: "Removido.",
+    pluginNotFound: "Plugin não encontrado — skip.",
+    removingTui: "2. Removendo de tui.json...",
+    removedTui: "Removido.",
+    tuiNotFound: "tui.json não encontrado ou sem plugin array — skip.",
+    removingDeps: "3. Removendo dependências...",
+    removedDeps: "Dependências removidas.",
+    depsNotFound: "Dependências não encontradas — skip.",
+    successRemove: "Plugin removido. Reinicie o OpenCode.",
+    cancelled: "Cancelado.",
+  },
+}
+
+function timestamp() {
+  const d = new Date()
+  const pad = (n) => String(n).padStart(2, "0")
+  return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`
+}
+
+function backup(filePath) {
+  if (!existsSync(filePath)) return
+  const bak = `${filePath}.bak-${timestamp()}`
+  copyFileSync(filePath, bak)
+}
+
+function readJson(filePath) {
+  if (!existsSync(filePath)) return null
+  try {
+    return JSON.parse(readFileSync(filePath, "utf-8"))
+  } catch {
+    return null
+  }
+}
+
+function writeJson(filePath, data) {
+  backup(filePath)
+  writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf-8")
+}
+
+function confirm(rl, message) {
+  return new Promise((resolve) => {
+    rl.question(message, (answer) => {
+      resolve(/^(y|yes)$/i.test(answer.trim()))
+    })
+  })
+}
+
+function readLangFromConfig() {
+  const data = readJson(LANG_JSON)
+  if (data?.lang === "pt") return "pt"
+  if (data?.lang === "en") return "en"
+  return null
+}
+
+function writeLangConfig(lang) {
+  const data = { lang }
+  if (existsSync(LANG_JSON)) {
+    backup(LANG_JSON)
+  }
+  writeFileSync(LANG_JSON, JSON.stringify(data, null, 2) + "\n", "utf-8")
+}
+
+function deleteLangConfig() {
+  if (existsSync(LANG_JSON)) {
+    unlinkSync(LANG_JSON)
+  }
+}
+
+async function promptLang(rl) {
+  console.log("OpenRouter Cost Plugin\n")
+  console.log("Choose your language / Escolha o idioma:\n")
+  console.log("  [1] English   ← Enter = default")
+  console.log("  [2] Português (BR)\n")
+  const answer = await new Promise((resolve) => {
+    rl.question("> ", (a) => resolve(a.trim()))
+  })
+  if (answer === "2") return "pt"
+  if (answer === "1" || answer === "") return "en"
+  console.log("Invalid choice — defaulting to English.\n")
+  return "en"
+}
+
+async function install(opts) {
+  if (!existsSync(CONFIG_DIR)) {
+    console.error("Execute `opencode` pelo menos uma vez primeiro.")
+    process.exit(1)
+  }
+
+  const rl = createInterface({ input: process.stdin, output: process.stdout })
+
+  // 1. Define language
+  let lang
+  if (opts.lang) {
+    if (opts.lang !== "en" && opts.lang !== "pt") {
+      console.warn(`Invalid --lang "${opts.lang}". Defaulting to English.\n`)
+      lang = "en"
+    } else {
+      lang = opts.lang
+    }
+  } else if (opts.yes) {
+    lang = readLangFromConfig() || "en"
+  } else {
+    lang = await promptLang(rl)
+  }
+
+  const msg = MESSAGES[lang]
+
+  // 2. Verify config dir
+  if (!existsSync(CONFIG_DIR)) {
+    console.error("Execute `opencode` pelo menos uma vez primeiro.")
+    process.exit(1)
+  }
+
+  // 3. Banner
+  console.log(msg.banner)
+  console.log(msg.steps(PLUGIN_NAME, PLUGINS_DIR, TUI_JSON, PKG_JSON) + "\n")
+  console.log(msg.requirements)
+
+  if (!opts.yes) {
+    const ok = await confirm(rl, msg.confirm)
+    if (!ok) {
+      console.log(msg.cancelled)
+      rl.close()
+      return
+    }
+  }
+
+  // Step 1: Copy plugin
+  console.log(`\n${msg.copying}`)
+  if (!opts.dryRun) {
+    if (!existsSync(PLUGINS_DIR)) {
+      mkdirSync(PLUGINS_DIR, { recursive: true })
+    }
+    if (existsSync(PLUGIN_DEST)) {
+      const existing = readFileSync(PLUGIN_DEST, "utf-8")
+      const source = readFileSync(PLUGIN_SRC, "utf-8")
+      if (existing === source) {
+        console.log(msg.identical)
+      } else {
+        if (!opts.yes) {
+          const overwrite = await confirm(rl, msg.existsPrompt)
+          if (!overwrite) {
+            console.log(msg.existsSkip)
+          } else {
+            backup(PLUGIN_DEST)
+            copyFileSync(PLUGIN_SRC, PLUGIN_DEST)
+            console.log(msg.existsYes)
+          }
+        } else {
+          backup(PLUGIN_DEST)
+          copyFileSync(PLUGIN_SRC, PLUGIN_DEST)
+          console.log(msg.existsYes)
+        }
+      }
+    } else {
+      copyFileSync(PLUGIN_SRC, PLUGIN_DEST)
+      console.log(msg.copied)
+    }
+  } else {
+    console.log(msg.dryRun(PLUGIN_SRC, PLUGIN_DEST))
+  }
+
+  // Step 2: Update tui.json
+  console.log(`\n${msg.updatingTui}`)
+  const tuiData = readJson(TUI_JSON) || {}
+  const plugins = Array.isArray(tuiData.plugin) ? tuiData.plugin : []
+  if (!plugins.includes(PLUGIN_REL)) {
+    if (!opts.dryRun) {
+      plugins.push(PLUGIN_REL)
+      tuiData.plugin = plugins
+      writeJson(TUI_JSON, tuiData)
+      console.log(`   ${msg.addedTui(PLUGIN_REL)}`)
+    } else {
+      console.log(`   ${msg.dryRun(PLUGIN_REL, TUI_JSON)}`)
+    }
+  } else {
+    console.log(`   ${msg.tuiExists}`)
+  }
+
+  // Step 3: Add deps to package.json
+  if (!opts.noDeps) {
+    console.log(`\n${msg.addingDeps}`)
+    const pkgData = readJson(PKG_JSON) || {}
+    if (!pkgData.dependencies) pkgData.dependencies = {}
+    let added = false
+    for (const [name, version] of Object.entries(DEPS)) {
+      if (!pkgData.dependencies[name]) {
+        if (!opts.dryRun) {
+          pkgData.dependencies[name] = version
+          added = true
+        } else {
+          console.log(`   [dry-run] Would add ${name}@${version}`)
+        }
+      }
+    }
+    if (!opts.dryRun) {
+      if (added) {
+        writeJson(PKG_JSON, pkgData)
+        console.log(`   ${msg.depsAdded}`)
+      } else {
+        console.log(`   ${msg.depsExists}`)
+      }
+    }
+  } else {
+    console.log(`\n${msg.skippedDeps}`)
+  }
+
+  // Step 4: Write lang config
+  if (!opts.dryRun) {
+    writeLangConfig(lang)
+  }
+
+  rl.close()
+
+  console.log(msg.success)
+}
+
+async function uninstall(opts) {
+  if (!existsSync(CONFIG_DIR)) {
+    console.error("Execute `opencode` pelo menos uma vez primeiro.")
+    process.exit(1)
+  }
+
+  const rl = createInterface({ input: process.stdin, output: process.stdout })
+
+  // 1. Read language from config; default en
+  const lang = readLangFromConfig() || "en"
+  const msg = MESSAGES[lang]
+
+  console.log(msg.bannerRemove)
+
+  if (!opts.yes) {
+    const ok = await confirm(rl, msg.confirmRemove)
+    if (!ok) {
+      console.log(msg.cancelled)
+      rl.close()
+      return
+    }
+  }
+
+  // Step 1: Remove plugin file
+  console.log(`\n${msg.removingPlugin}`)
+  if (existsSync(PLUGIN_DEST)) {
+    if (!opts.dryRun) {
+      unlinkSync(PLUGIN_DEST)
+      console.log(`   ${msg.removedPlugin}`)
+    } else {
+      console.log(`   [dry-run] Would remove ${PLUGIN_DEST}`)
+    }
+  } else {
+    console.log(`   ${msg.pluginNotFound}`)
+  }
+
+  // Step 2: Remove from tui.json
+  console.log(`\n${msg.removingTui}`)
+  const tuiData = readJson(TUI_JSON)
+  if (tuiData && Array.isArray(tuiData.plugin)) {
+    const idx = tuiData.plugin.indexOf(PLUGIN_REL)
+    if (idx !== -1) {
+      if (!opts.dryRun) {
+        backup(TUI_JSON)
+        tuiData.plugin.splice(idx, 1)
+        if (tuiData.plugin.length === 0) {
+          delete tuiData.plugin
+        }
+        writeJson(TUI_JSON, tuiData)
+        console.log(`   ${msg.removedTui}`)
+      } else {
+        console.log(`   [dry-run] Would remove ${PLUGIN_REL} from plugin array.`)
+      }
+    } else {
+      console.log(`   ${msg.tuiNotFound}`)
+    }
+  } else {
+    console.log(`   ${msg.tuiNotFound}`)
+  }
+
+  // Step 3: Remove deps from package.json
+  console.log(`\n${msg.removingDeps}`)
+  const pkgData = readJson(PKG_JSON)
+  if (pkgData && pkgData.dependencies) {
+    let removed = false
+    for (const name of Object.keys(DEPS)) {
+      if (pkgData.dependencies[name]) {
+        if (!opts.dryRun) {
+          delete pkgData.dependencies[name]
+          removed = true
+        } else {
+          console.log(`   [dry-run] Would remove ${name}`)
+        }
+      }
+    }
+    if (!opts.dryRun && removed) {
+      writeJson(PKG_JSON, pkgData)
+      console.log(`   ${msg.removedDeps}`)
+    } else if (!removed) {
+      console.log(`   ${msg.depsNotFound}`)
+    }
+  } else {
+    console.log(`   ${msg.depsNotFound}`)
+  }
+
+  // Step 4: Remove lang config
+  if (!opts.dryRun) {
+    deleteLangConfig()
+  }
+
+  rl.close()
+
+  console.log(`\n${msg.successRemove}`)
+}
+
+// --- CLI ---
+const args = process.argv.slice(2)
+const flags = {
+  yes: args.includes("--yes") || args.includes("-y"),
+  dryRun: args.includes("--dry-run"),
+  noDeps: args.includes("--no-deps"),
+  remove: args.includes("--remove"),
+}
+
+// Parse --lang en|pt
+let langFlag = null
+const langIdx = args.indexOf("--lang")
+if (langIdx !== -1 && args[langIdx + 1]) {
+  langFlag = args[langIdx + 1]
+}
+
+if (flags.remove) {
+  uninstall(flags).catch((err) => {
+    console.error(err)
+    process.exit(1)
+  })
+} else {
+  install({ ...flags, lang: langFlag }).catch((err) => {
+    console.error(err)
+    process.exit(1)
+  })
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "opencode-openrouter-costs",
+  "version": "0.1.0",
+  "description": "OpenCode TUI plugin — sidebar widget showing OpenRouter session cost and account balance",
+  "license": "MIT",
+  "author": "Marcelo (mhenrique94)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mhenrique94/opencode-openrouter-costs.git"
+  },
+  "bin": {
+    "opencode-openrouter-costs": "./bin/openrouter-costs.mjs"
+  },
+  "engines": {
+    "node": ">=18",
+    "opencode": ">=1.18.30"
+  },
+  "files": [
+    "bin/",
+    "src/plugin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "tui",
+    "openrouter",
+    "cost",
+    "balance",
+    "widget",
+    "sidebar"
+  ],
+  "scripts": {
+    "test": "node --test test/**/*.test.mjs"
+  }
+}

package/src/plugin/openrouter-cost.tsx

@@ -0,0 +1,159 @@
+/** @jsxImportSource @opentui/solid */
+import type { TuiPlugin, TuiPluginApi } from "@opencode-ai/plugin/tui"
+import { createSignal, onCleanup } from "solid-js"
+import { readFile } from "fs/promises"
+import { homedir } from "os"
+import { join } from "path"
+
+type Lang = "en" | "pt"
+
+const LABELS = {
+  en: {
+    session: "Session",
+    balance: "Balance",
+    notConfigured: "not configured",
+    loading: "…",
+  },
+  pt: {
+    session: "Sessão",
+    balance: "Saldo",
+    notConfigured: "não configurado",
+    loading: "…",
+  },
+} as const
+
+function t(lang: Lang, key: keyof (typeof LABELS)["en"]): string {
+  return LABELS[lang]?.[key] ?? LABELS.en[key]
+}
+
+const money = new Intl.NumberFormat("en-US", {
+  style: "currency",
+  currency: "USD",
+})
+
+const DEFAULT_TTL_MS = 60_000
+
+async function readKey(): Promise<string | null> {
+  const envKey = process.env.OPENROUTER_API_KEY
+  if (envKey) return envKey
+
+  try {
+    const authPath = join(homedir(), ".local", "share", "opencode", "auth.json")
+    const raw = await readFile(authPath, "utf-8")
+    const auth = JSON.parse(raw)
+    return auth?.openrouter?.key ?? null
+  } catch {
+    return null
+  }
+}
+
+async function readLang(): Promise<Lang> {
+  try {
+    const configPath = join(homedir(), ".config", "opencode", "openrouter-cost.json")
+    const raw = await readFile(configPath, "utf-8")
+    const config = JSON.parse(raw)
+    if (config?.lang === "pt") return "pt"
+    if (config?.lang === "en") return "en"
+    return "en"
+  } catch {
+    return "en"
+  }
+}
+
+function View(props: { api: TuiPluginApi; session_id: string; key: string | null; lang: Lang }) {
+  const theme = () => props.api.theme.current
+  const session = () => props.api.state.session.get(props.session_id)
+  const sessionCost = () => session()?.cost ?? 0
+
+  const [balance, setBalance] = createSignal<string | null>(null)
+  let lastFetch = 0
+  let fetching = false
+  let disposed = false
+
+  async function fetchBalance() {
+    if (!props.key || disposed || fetching) return
+    fetching = true
+    try {
+      const res = await fetch("https://openrouter.ai/api/v1/credits", {
+        headers: { Authorization: `Bearer ${props.key}` },
+      })
+      if (!res.ok) {
+        if (!disposed) setBalance(null)
+        return
+      }
+      const json = await res.json()
+      const total = json?.data?.total_credits ?? 0
+      const used = json?.data?.total_usage ?? 0
+      const remaining = Math.max(0, total - used)
+      if (!disposed) {
+        setBalance(money.format(remaining))
+        lastFetch = Date.now()
+      }
+    } catch {
+      if (!disposed) setBalance(null)
+    } finally {
+      fetching = false
+    }
+  }
+
+  function maybeRefresh() {
+    if (Date.now() - lastFetch >= DEFAULT_TTL_MS) {
+      fetchBalance()
+    }
+  }
+
+  fetchBalance()
+
+  const unsub = props.api.event.on("message.updated", () => {
+    maybeRefresh()
+  })
+
+  onCleanup(() => {
+    disposed = true
+    unsub()
+  })
+
+  if (!props.key) {
+    return (
+      <box>
+        <text fg={theme().text}>
+          <b>OpenRouter</b>
+        </text>
+        <text fg={theme().warning}>{t(props.lang, "notConfigured")}</text>
+      </box>
+    )
+  }
+
+  return (
+    <box>
+      <text fg={theme().text}>
+        <b>OpenRouter</b>
+      </text>
+      <text fg={theme().textMuted}>{t(props.lang, "session")}: {money.format(sessionCost())}</text>
+      <text fg={theme().textMuted}>
+        {t(props.lang, "balance")}: {balance() ?? t(props.lang, "loading")}
+      </text>
+    </box>
+  )
+}
+
+const tui: TuiPlugin = async (api) => {
+  const [key, lang] = await Promise.all([readKey(), readLang()])
+  if (!key) {
+    console.warn("OpenRouter Cost Plugin: no key found. Configure via /models or set OPENROUTER_API_KEY.")
+  }
+
+  api.slots.register({
+    order: 150,
+    slots: {
+      sidebar_content(_ctx, props) {
+        return <View api={api} session_id={props.session_id} key={key} lang={lang} />
+      },
+    },
+  })
+}
+
+export default {
+  id: "openrouter-cost",
+  tui,
+}