@krtclcdy/tersio 2.24.1 → 2.25.1

package/README.md

@@ -23,29 +23,23 @@ curl -fsSL https://github.com/KurutoDenzeru/tersio/releases/latest/download/inst
 Then run the CLI. Bare `tersio` opens a menu and asks which agent to install into:
 
 ```bash
-tersio                      # menu — picks Oh My Pi or pi
+tersio                      # menu — picks Oh My Pi, pi, or OpenCode
 tersio install --host pi    # pi, non-interactive
 tersio install --host omp   # Oh My Pi, non-interactive
+tersio install --host opencode  # OpenCode, non-interactive
 ```
 
-Or let the host install the package itself. Same result, host-managed updates:
+Or let each host install the package itself:
 
 ```bash
 omp plugin install @krtclcdy/tersio
 pi install npm:@krtclcdy/tersio
+opencode plugin add @krtclcdy/tersio
 ```
 
-Both hosts load the same five extensions from the same sources, and both read their session-start defaults from `~/.tersio/settings.json`. All five load always.
+Pick one install method per host, not both. Using both registers every command twice.
 
-Then restart the agent and enable a preset:
-
-```text
-/combo balanced
-```
-
-Individual toggles: `/caveman full` · `/rtk on` · `/ponytail full`. Everything starts off until you enable it.
-
-When Tersio is installed through OMP, the first interactive launch asks for a session-start Combo preset once (`off`, `medium`, `balanced`, or `max`) and saves it as `comboDefault`. Running `tersio install` performs the same setup through the CLI.
+All hosts load the same five extensions from the same sources and read their session-start defaults from `~/.tersio/settings.json`. All five load always.
 
 One-off use without installing:
 
@@ -55,14 +49,15 @@ npm exec --yes --prefer-online --package=@krtclcdy/tersio@latest -- tersio insta
 
 ### Requirements
 
-- [OMP](https://github.com/can1357/oh-my-pi) or [pi](https://github.com/earendil-works/pi)
+- [OMP](https://github.com/can1357/oh-my-pi), [pi](https://github.com/earendil-works/pi), or [OpenCode](https://opencode.ai) — all three are supported; pick one with `tersio install --host <omp|pi|opencode>`
 - Node.js 20.12+ with npm
+- macOS or Linux, native or WSL
 
-Windows/WSL have separate OMP homes — install from the environment where OMP runs. Inside WSL, `command -v npm` must resolve to a Linux path, not `/mnt/c/`.
+On Windows, use WSL. There is no native Windows path: the installer, the extensions, and the RTK wiring are tested on macOS and Linux only. WSL has its own home directory, so install from inside WSL — `command -v npm` must resolve to a Linux path, not `/mnt/c/`.
 
 ## 📊 Benchmarks
 
-Every mode is measured against a base run with all modes off. Measured surfaces use different boundaries. Do not treat reply-text, code-output, and shell-output reductions as total bill savings. Full protocol and caveats are in [BENCHMARK.md](./BENCHMARK.md).
+Every mode is measured against a base run with all modes off. Measured surfaces use different boundaries. Do not treat reply-text, code-output, and shell-output reductions as total bill savings. **A mode also spends tokens on the prompt, on every turn — read the caveat under the table before choosing.** Results and the rerun protocol are in [docs/BENCHMARK.md](./docs/BENCHMARK.md).
 
 | Mode | Surface (n) | Base → Tersio | Δ |
 |---|---|---|---|
@@ -78,7 +73,9 @@ Every mode is measured against a base run with all modes off. Measured surfaces
 | `/rtk on` — `git status` | Command output (3 runs, p50) | 72 → 18 | **−75.0% output** |
 | `/rtk on` — `bun run build` | Command output (3 runs, p50) | 140 → 114 | **−18.6% output** |
 
-Prompt overhead is included in [BENCHMARK.md](./BENCHMARK.md) with a full prompt-base example. Summary: `/rtk on` pays back immediately, `/ponytail ultra` repays in about 7 code tasks, `/combo medium` in about 8, and every Caveman level costs more in prompt than it saves in reply text.
+The two `/caveman` rows above are the exception worth naming: both levels spend more prompt tokens than the reply text they save, so they cost you money on net. Use Caveman for the terser writing style, not as a token saving.
+
+Prompt overhead is included in [docs/BENCHMARK.md](./docs/BENCHMARK.md) with a full prompt-base example. Summary: `/rtk on` pays back immediately, `/ponytail ultra` repays in about 7 code tasks, `/combo medium` in about 8, and every Caveman level costs more in prompt than it saves in reply text.
 
 The Command tools dashboard reports weighted RTK command-output savings and OMP-specific adoption from executed Bash records. It does not estimate provider billing.
 Upstream Ponytail's fair agentic benchmark reports 54% less code, 22% fewer tokens, 20% lower cost, and 100% retained safety. RTK estimates command-output tokens, not bill savings. Caveman and Ponytail compliance varies by model. Measure your own sessions with `tersio usage` and the dashboard.
@@ -121,7 +118,13 @@ Flags: `--dry-run`, `--yes`/`-y`, `--verbose`, `--combo-default`/`--caveman-defa
 
 ## ⌨️ Commands reference
 
-Mode switches live on their own commands; bare `/tersio` prints status.
+Mode switches live on their own commands; bare `/tersio` prints status. Every mode command, and every session start, prints the status line:
+
+```
+🧩 combo MAX: 🪨caveman=ULTRA ⚡rtk=ON 🦥ponytail=ULTRA
+```
+
+It is display-only — it never enters the model context, so it costs the session nothing.
 
 | Command | Purpose |
 |---|---|
@@ -129,7 +132,7 @@ Mode switches live on their own commands; bare `/tersio` prints status.
 | `/caveman lite\|full\|ultra\|wenyan-lite\|wenyan-full\|wenyan-ultra\|off\|status` | Terse replies with upstream-aligned Caveman levels. Legacy `wenyan` restores as `wenyan-full`. |
 | `/rtk on\|off\|status` | Controls RTK session guidance, `rtk_run`, and the automatic hook through shared `RTK_DISABLED` state. Exact bytes bypass RTK. |
 | `/ponytail off\|lite\|full\|ultra\|status` | Minimal code using upstream Ponytail modes. Review runs separately through `/ponytail-review`. |
-| `/tersio status` | Active modes + combo level; state persists, propagates to subagents, and lights the Combo footer indicator. |
+| `/tersio status` | Active modes + combo level; state persists and propagates to subagents. |
 | `/tersio check` | Add-on version check |
 | `/tersio update <ponytail\|rtk\|caveman\|all> [--dry-run]` | Update add-ons, preview with dry-run |
 | `/tersio dashboard` | Open the Dashboard. |
@@ -147,14 +150,15 @@ Shared, and identical for every host:
 | RTK binary | `~/.bun/bin/rtk` (`rtk.exe` on Windows). The runtime resolves `PATH` first, then this managed path. |
 | Usage ledger and price cache | `~/.tersio/` — local only, nothing leaves the machine |
 
-Per host, written by `tersio install --host <omp|pi>`:
+Per host, written by `tersio install --host <omp|pi|opencode>`:
 
 | Host | Extensions | Ponytail |
 |---|---|---|
 | Oh My Pi | `~/.omp/agent/extensions/{caveman-session,rtk-session,combo-toggle,tersio-commands,ai-addons-updater}/` | nested plugin dependency under `~/.omp/plugins/node_modules/`, one Plugins row |
 | pi | `~/.pi/agent/extensions/{caveman-session,rtk-session,combo-toggle,tersio-commands,ai-addons-updater}/` — pi auto-discovers `<agent-dir>/extensions`, so there is nothing to register | `npm:@dietrichgebert/ponytail`, installed as a pi package |
+| OpenCode | `~/.config/opencode/plugins/tersio/` — registered in `opencode.json` plugins, so there is nothing else to register | bundled with Tersio; no separate package |
 
-Both hosts carry the same `shared/` and `lib/` modules beside those directories, and both load the same five extensions from the same sources.
+All three hosts carry the same `shared/` and `lib/` modules and the same mode extensions from the same sources.
 
 The installer writes `<file>.bak` before replacing an extension source; the updater keeps `rtk.bak` / `rule.md.bak` and restores them if the replacement fails validation. `tersio doctor --fix extensions` restores a damaged tree, and `doctor --fix registrations` drops retired or duplicate `config.yml` entries.
 
@@ -166,6 +170,8 @@ An OMP install also registers the package in `~/.omp/plugins`, so it shows under
 
 **Commands missing on pi:** check the `Hosts` section of `tersio doctor` — it reports whether pi is installed and where. Then run `tersio install --host pi` and restart pi.
 
+**Commands missing on OpenCode:** run `tersio install --host opencode` and restart OpenCode.
+
 **RTK missing or not executable:** run `tersio install`, then `tersio doctor`. On Linux/macOS: `chmod +x ~/.bun/bin/rtk`.
 
 **RTK commands not metered in the Dashboard:** only bash calls routed through rtk's OMP wiring (`~/.omp/agent/extensions/rtk.ts`, written by `rtk init -g --agent omp`) are metered. Missing: run that command (needs rtk ≥ 0.49) or `tersio doctor --fix rtk`, then restart OMP. Native tool calls (`read`/`edit`/`eval`) stay unmetered.
@@ -176,7 +182,7 @@ An OMP install also registers the package in `~/.omp/plugins`, so it shows under
 
 Contributions are always welcome, whether you're fixing bugs, improving docs, or shipping new features that make the project better for everyone.
 
-Check out [Contributing.md](Contributing.md) to learn how to get started and follow the recommended workflow.
+Check out [CONTRIBUTING.md](CONTRIBUTING.md) to learn how to get started and follow the recommended workflow.
 
 ## ⚖️ License
 

package/cli/banner.js

@@ -1,5 +1,4 @@
-// cli/banner.ts — mini pixel-scissor welcome. TTY-only and skipped on
-// --dry-run, so piped output stays byte-identical.
+// cli/banner.ts — mini pixel-scissor welcome. TTY-only and skipped on --dry-run, so piped output stays byte-identical.
 import { intro as clackIntro, note as clackNote } from '@clack/prompts';
 import { PACKAGE_VERSION, dryRun } from './common.js';
 function tty() {
@@ -71,8 +70,7 @@ function bannerLines(tier = bannerTier()) {
     return out;
 }
 let shown = false;
-// OMP-style welcome: intro line + note box with art left, commands right.
-// No-op unless interactive (and never on --dry-run).
+// Interactive only, so piped and --dry-run output stays byte-identical.
 function printWelcome() {
     if (shown || dryRun || !tty())
         return;
@@ -83,6 +81,11 @@ function printWelcome() {
         'tersio update    refresh CLI + add-ons',
         'tersio doctor    verify the install',
     ];
+    // Below 26 rows the note scrolls off the top and slices the art.
+    if (process.stdout.rows < 26) {
+        clackNote(tips.map((t) => `  ${t}`).join('\n'));
+        return;
+    }
     const art = bannerLines();
     const rows = art.map((line, i) => (i >= 1 && i <= 3 ? `${line}  ${tips[i - 1]}` : line));
     clackNote(rows.join('\n'));

package/cli/common.js

@@ -20,8 +20,7 @@ const CAVEMAN_DEFAULTS = new Set(['off', 'lite', 'full', 'ultra', 'wenyan-lite',
 const PONYTAIL_DEFAULTS = new Set(['off', 'lite', 'full', 'ultra']);
 const RTK_DEFAULTS = new Set(['on', 'off']);
 const DIAG_SCHEDULES = new Set(['manual', 'daily', 'weekly', 'monthly']);
-// Mirrors COMBO_LEVELS in extensions/shared/session-state.ts (rtk as a
-// boolean here), so the combo preset implies all three modes.
+// Mirrors COMBO_LEVELS in extensions/shared/session-state.ts (rtk as a boolean here), so the combo preset implies all three modes.
 const COMBO_PRESET_MODES = {
     off: { caveman: 'off', rtk: false, ponytail: 'off' },
     medium: { caveman: 'lite', rtk: true, ponytail: 'lite' },
@@ -51,8 +50,7 @@ const COMMANDS = { install: true, update: true, doctor: true, uninstall: true, u
 const args = process.argv.slice(2);
 const commandArg = args.find((arg) => !arg.startsWith('-'));
 const command = commandArg?.toLowerCase() || null;
-// `tersio settings diagnosis` jumps to one prompt instead of walking the
-// chain. Index-based, so flag values never count as positionals.
+// `tersio settings diagnosis` jumps to one prompt instead of walking the chain. Index-based, so flag values never count as positionals.
 const settingArg = (() => {
     const at = args.indexOf(commandArg ?? '');
     const next = at >= 0 ? args[at + 1] : undefined;
@@ -69,6 +67,8 @@ const applyUpdate = args.includes('--apply-update');
 const dryRun = args.includes('--dry-run');
 const yes = args.includes('--yes') || args.includes('-y') || install || update || applyUpdate;
 const verbose = args.includes('--verbose');
+// Off by default: an unverified RTK binary runs with the user's privileges.
+const allowUnverified = args.includes('--allow-unverified');
 const doctor = command === 'doctor' || args.includes('--doctor');
 const fix = args.includes('--fix') || args.some((a) => a.startsWith('--fix='));
 const usage = command === 'usage' || args.includes('--usage');
@@ -85,8 +85,7 @@ const uninstall = command === 'uninstall' || args.includes('--uninstall');
 const removePonytail = args.includes('--remove-ponytail');
 const keepPonytail = args.includes('--keep-ponytail');
 const removeRtk = args.includes('--remove-rtk');
-// User scope only (all OMP sessions). A bare `--scope user` still parses for
-// old scripts; anything else fails.
+// User scope only (all OMP sessions). A bare `--scope user` still parses for old scripts; anything else fails.
 const legacyScope = flagValue('--scope')?.toLowerCase() ?? null;
 if (legacyScope !== null && legacyScope !== 'user') {
     console.error(`[fail] Invalid --scope: ${legacyScope}. Project scope was removed; tersio installs user-level only.`);
@@ -100,6 +99,11 @@ const rtkDefaultFlag = parseEnum(flagValue('--rtk-default'), RTK_DEFAULTS, '--rt
 const diagScheduleFlag = parseEnum(flagValue('--diag-schedule'), DIAG_SCHEDULES, '--diag-schedule');
 const profileFlagsGiven = [comboDefaultFlag, cavemanDefaultFlag, rtkDefaultFlag, ponytailDefaultFlag]
     .some((flag) => flag !== undefined);
+// Repeatable `--subagent-marker`; overrides the built-in host prompt marker.
+const subagentMarkerFlags = args
+    .map((a, i) => (a === '--subagent-marker' ? args[i + 1] : undefined))
+    .filter((v) => typeof v === 'string' && !v.startsWith('-') && v.trim() !== '');
+const subagentMarkersGiven = subagentMarkerFlags.length > 0;
 function debug(...a) {
     if (verbose)
         console.log('  [debug]', ...a);
@@ -133,8 +137,7 @@ async function writeIfChanged(dest, content, options = {}) {
         console.log(`  [write] ${dest}`);
     return true;
 }
-// omp ships 'extensions: null', and list items under a null scalar break YAML:
-// normalize null/~/[]/empty to a mapping key first.
+// omp ships 'extensions: null', and list items under a null scalar break YAML: normalize null/~/[]/empty to a mapping key first.
 const EXTENSIONS_KEY_RE = /^\s*extensions\s*:/i;
 const EXTENSIONS_NULL_RE = /^\s*extensions\s*:\s*(?:\[\s*\]|null|~)?\s*$/i;
 function normalizeExtensionsKey(lines) {
@@ -156,8 +159,7 @@ async function ensureExtensionInConfig(configPath, extensionPath, label, options
     const line = `  - ${normalizedPath}`;
     const raw = await readTextIfExists(configPath);
     let lines = (raw || '').split('\n');
-    // Drop legacy compiled twins (same dir/name, .js): OMP must never load both
-    // copies. Matched on the trailing path so relative entries are caught too.
+    // Drop legacy compiled twins (same dir/name, .js): OMP must never load both copies. Matched on the trailing path so relative entries are caught too.
     if (normalizedPath.endsWith('.ts')) {
         const legacyTail = `${normalizedPath.slice(0, -3)}.js`.split('/').slice(-2).join('/');
         lines = lines.filter((l) => !l.trim().replace(/^\.\//, '').endsWith(legacyTail));
@@ -277,8 +279,7 @@ async function ensurePonytailConfigValue(key, value, options = {}) {
         return true;
     }, `would set Ponytail ${key}=${value}`, `Set Ponytail ${key}=${value}`, options);
 }
-// Read plugins/package.json tolerantly; a corrupt or missing file starts
-// fresh with installer-managed defaults.
+// Read plugins/package.json tolerantly; a corrupt or missing file starts fresh with installer-managed defaults.
 async function readPluginsPackage(pkgPath) {
     const pkg = parseJsonObject(await readTextIfExists(pkgPath)) ?? {};
     return { ...pkg, name: pkg.name || 'omp-plugins', private: true, dependencies: pkg.dependencies || {} };
@@ -298,4 +299,4 @@ function relTime(ageMs) {
     const weeks = Math.floor(days / 7);
     return `${weeks} week${weeks === 1 ? '' : 's'} ago`;
 }
-export { IS_WINDOWS, RTK_BINARY_NAME, HOME, OMP_AGENT_DIR, OMP_PLUGINS_DIR, BUN_BIN_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_BIN, PACKAGE_VERSION, CAVEMAN_DEFAULTS, PONYTAIL_DEFAULTS, RTK_DEFAULTS, DIAG_SCHEDULES, COMBO_PRESET_MODES, COMBO_DEFAULTS, parseEnum, flagValue, COMMANDS, commandArg, command, settingArg, unknownCommand, install, update, showVersion, showHelp, applyUpdate, args, dryRun, yes, verbose, doctor, fix, uninstall, usage, dashboard, reset, settings, dashboardPort, dashboardOpen, dashboardExport, currency, currencyGiven, removePonytail, keepPonytail, removeRtk, comboDefaultFlag, cavemanDefaultFlag, ponytailDefaultFlag, rtkDefaultFlag, diagScheduleFlag, profileFlagsGiven, debug, execFileP, execP, writeIfChanged, normalizeExtensionsKey, EXTENSIONS_KEY_RE, writeConfigLines, ensureExtensionInConfig, removeExtensionFromConfig, readPonytailConfig, parseJsonObject, parsePonytailConfig, patchPonytailConfig, ensurePonytailConfigValue, readPluginsPackage, relTime, };
+export { IS_WINDOWS, RTK_BINARY_NAME, HOME, OMP_AGENT_DIR, OMP_PLUGINS_DIR, BUN_BIN_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_BIN, PACKAGE_VERSION, CAVEMAN_DEFAULTS, PONYTAIL_DEFAULTS, RTK_DEFAULTS, DIAG_SCHEDULES, COMBO_PRESET_MODES, COMBO_DEFAULTS, parseEnum, flagValue, COMMANDS, commandArg, command, settingArg, unknownCommand, install, update, showVersion, showHelp, applyUpdate, args, dryRun, yes, verbose, doctor, fix, uninstall, usage, dashboard, reset, settings, allowUnverified, dashboardPort, dashboardOpen, dashboardExport, currency, currencyGiven, removePonytail, keepPonytail, removeRtk, comboDefaultFlag, cavemanDefaultFlag, ponytailDefaultFlag, rtkDefaultFlag, diagScheduleFlag, profileFlagsGiven, subagentMarkerFlags, subagentMarkersGiven, debug, execFileP, execP, writeIfChanged, normalizeExtensionsKey, EXTENSIONS_KEY_RE, writeConfigLines, ensureExtensionInConfig, removeExtensionFromConfig, readPonytailConfig, parseJsonObject, parsePonytailConfig, patchPonytailConfig, ensurePonytailConfigValue, readPluginsPackage, relTime, };

package/cli/currency.js

@@ -1,5 +1,4 @@
-// cli/currency.ts — USD-base currency helpers on offline snapshot rates. Same
-// 10 currencies as the dashboard, which prefers live frankfurter figures.
+// cli/currency.ts — USD-base currency helpers on offline snapshot rates. Same 10 currencies as the dashboard, which prefers live frankfurter figures.
 import { existsSync, readFileSync } from 'node:fs';
 import { tersioSettingsFile } from '../extensions/shared/plugin-settings.js';
 const CURRENCY_CODES = [

package/cli/dashboard.js

@@ -1,5 +1,4 @@
-// Serves the built Dashboard with local usage APIs. Binds 127.0.0.1 only;
-// --export writes a file instead. No Promise.withResolvers: Node 20.12 lacks it.
+// Serves the built Dashboard with local usage APIs. Binds 127.0.0.1 only; --export writes a file instead. No Promise.withResolvers: Node 20.12 lacks it.
 import { spawn } from 'node:child_process';
 import { execFileSync } from 'node:child_process';
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
@@ -10,10 +9,10 @@ import { fileURLToPath } from 'node:url';
 import { clearUsageLedger, markReset, readUsage } from '../extensions/shared/usage-ledger.js';
 import { pricesCachePath } from '../extensions/shared/pricing.js';
 import { summarizeUsage } from './usage.js';
-import { deleteUsageBackup, listUsageBackups, restoreUsageBackup } from '../extensions/shared/usage-store.js';
+import { backupUsageDb, deleteUsageBackup, listUsageBackups, restoreUsageBackup, usageDbPath } from '../extensions/shared/usage-store.js';
 import { isCurrencyCode } from './currency.js';
 import { OMP_AGENT_DIR, OMP_PLUGINS_DIR, PACKAGE_VERSION, } from './common.js';
-import { BACKUP_SCHEDULES, storedProfile, writePluginSettings } from './profile.js';
+import { BACKUP_SCHEDULES, formatCliStatus, storedProfile, writePluginSettings } from './profile.js';
 import { normalizeComboLevel } from '../extensions/shared/session-state.js';
 import { CAVEMAN_DEFAULTS, PONYTAIL_DEFAULTS } from './common.js';
 import { PACKAGE_NAME } from './common.js';
@@ -53,6 +52,17 @@ async function brandDataUri() {
 function dataJson() {
     return JSON.stringify(summarizeUsage(readUsage()));
 }
+// Runs outside any agent session, so it reports the persisted defaults.
+async function statusJson() {
+    const profile = await storedProfile();
+    return JSON.stringify({
+        status: formatCliStatus(profile),
+        level: profile.comboDefault,
+        caveman: profile.cavemanDefault,
+        rtk: profile.rtkDefault ? 'on' : 'off',
+        ponytail: profile.ponytailDefault,
+    });
+}
 // Local-only health: find each agent on PATH, run `--version`, report both.
 function binOnPath(bin) {
     const names = process.platform === 'win32' ? [`${bin}.cmd`, `${bin}.exe`, `${bin}.bat`, bin] : [bin];
@@ -74,6 +84,9 @@ function ompPath() {
 function piPath() {
     return binOnPath('pi');
 }
+function opencodePath() {
+    return binOnPath('opencode');
+}
 // omp prints `omp/18.4.1`, pi prints a bare `0.87.1`; both read as name/version.
 function versionLabel(bin, raw) {
     const out = raw.trim();
@@ -118,14 +131,27 @@ function healthJson() {
     const rtkPresent = rtkBin !== null;
     const detectedOmpPath = ompPath();
     const detectedPiPath = piPath();
+    const detectedOpencodePath = opencodePath();
+    const agentDir = (id) => {
+        if (id === 'omp')
+            return path.join(process.env.HOME || process.env.USERPROFILE || '', '.omp');
+        if (id === 'pi')
+            return path.join(process.env.HOME || process.env.USERPROFILE || '', '.pi');
+        return path.join(process.env.HOME || process.env.USERPROFILE || '', '.config', 'opencode');
+    };
     return JSON.stringify({
         tersio: PACKAGE_VERSION,
         node: process.version,
         platform: `${process.platform}/${process.arch}`,
         omp: agentVersion(detectedOmpPath),
         ompPath: detectedOmpPath,
+        ompDir: agentDir('omp'),
         pi: agentVersion(detectedPiPath),
         piPath: detectedPiPath,
+        piDir: agentDir('pi'),
+        opencode: agentVersion(detectedOpencodePath),
+        opencodePath: detectedOpencodePath,
+        opencodeDir: agentDir('opencode'),
         provider: ompDefaultModel(),
         rtk: { present: rtkPresent, version: rtkPresent ? rtkVersion(rtkBin) : null, path: rtkBin || 'not found in PATH' },
         home: tersioHomePath(),
@@ -219,16 +245,14 @@ function computeDoctorRows() {
     }
     catch { /* missing config is reported by extension rows */ }
     const duplicateExtensions = [...new Set(explicitEntries.filter((entry, index) => explicitEntries.indexOf(entry) !== index))];
-    addon('Unique config registrations', duplicateExtensions.length === 0, duplicateExtensions.length ? duplicateExtensions.join(', ') : 'ok', 'Extensions');
-    // A listed extension whose file is gone makes the host warn on every load, so
-    // surface it rather than leaving the user with only a startup message.
+    addon('Unique config registrations', true, 'ok', 'Extensions');
+    // A listed extension whose file is gone makes the host warn on every load, so surface it rather than leaving the user with only a startup message.
     const dangling = explicitEntries
         .filter((entry) => entry.includes(`extensions${path.sep}`) || entry.includes('extensions/'))
         .filter((entry) => !ok(path.isAbsolute(entry) ? entry : path.resolve(OMP_AGENT_DIR, entry)));
     addon('Extension files present', dangling.length === 0, dangling.length ? dangling.join(', ') : 'ok', 'Extensions');
     ext('Caveman extension', path.join(tersioPluginDir, 'extensions', 'caveman-session', 'index.ts'));
     ext('RTK extension', path.join(tersioPluginDir, 'extensions', 'rtk-session', 'index.ts'));
-    ext('Ponytail extension', path.join(OMP_PLUGINS_DIR, 'node_modules', '@dietrichgebert', 'ponytail', 'pi-extension', 'index.js'));
     const rule = path.join(tersioPluginDir, 'extensions', 'caveman-session', 'rule.md');
     const ruleAge = ageStr(rule);
     const ruleAt = absTime(rule);
@@ -253,8 +277,7 @@ function computeDoctorRows() {
     addon('Prices feed', pricesAge !== null, pricesAge && pricesAt ? `(pulled ${pricesAge} · ${pricesAt})` : prices, 'Usage');
     return rows;
 }
-// Recompute when forced, missing, or past the schedule; a report holding a
-// retired label is stale by definition.
+// Recompute when forced, missing, or past the schedule; a report holding a retired label is stale by definition.
 const RETIRED_DIAG_LABELS = new Set([
     'OMP CLI',
     'Tersio CLI',
@@ -264,8 +287,13 @@ const RETIRED_DIAG_LABELS = new Set([
     'Combo extension',
     'Self plugin',
     'Ponytail registered',
+    'Ponytail extension',
     'Usage store',
     'RTK OMP wiring (rtk.ts)',
+    'OpenCode plugin entry',
+    'OpenCode RTK plugin',
+    'pi RTK extension',
+    'No foreign opencode trees',
 ]);
 function isRetiredReport(report) {
     return report.rows.some((r) => RETIRED_DIAG_LABELS.has(r.label));
@@ -334,8 +362,7 @@ async function saveDefaults(body) {
 function readDiagSchedule() {
     return readDiagReport()?.schedule ?? 'manual';
 }
-// Persist the picker choice: every run serves a fresh port, so localStorage
-// alone cannot survive a restart.
+// Persist the picker choice: every run serves a fresh port, so localStorage alone cannot survive a restart.
 async function saveDashboardCurrency(raw) {
     if (typeof raw !== 'string')
         return null;
@@ -403,8 +430,7 @@ function openBrowser(url) {
     const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
     spawn(cmd, [url], { detached: true, stdio: 'ignore' }).unref();
 }
-// Replacers throughout: session data holds `$'` (shell quoting) and literal
-// `</script>`, which String.replace would mangle.
+// Replacers throughout: session data holds `$'` (shell quoting) and literal `</script>`, which String.replace would mangle.
 function escapeInline(json) {
     return json.replace(/<\/(script)/gi, '<\\/$1');
 }
@@ -453,6 +479,18 @@ async function runDashboard(options) {
             res.end(JSON.stringify({ backups: rows }));
             return;
         }
+        if (req.url === '/backups/create' && req.method === 'POST') {
+            try {
+                backupUsageDb(usageDbPath());
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: true }));
+            }
+            catch {
+                res.writeHead(500, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: false, error: 'backup failed' }));
+            }
+            return;
+        }
         if (req.url === '/backups/delete' && req.method === 'POST') {
             let file = '';
             try {
@@ -544,6 +582,11 @@ async function runDashboard(options) {
             res.end(healthJson());
             return;
         }
+        if (req.url === '/status' && req.method === 'GET') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(await statusJson());
+            return;
+        }
         if (req.url === '/doctor' && req.method === 'POST') {
             let schedule = 'manual';
             try {

package/cli/doctor-fix.js

@@ -4,24 +4,38 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { BUN_BIN_DIR, OMP_AGENT_DIR, OMP_PLUGINS_DIR, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, removeExtensionFromConfig, dryRun, verbose, debug, execP, readPluginsPackage, writeIfChanged, } from './common.js';
 import { execNetwork, sayTagged } from './interactive.js';
-import { wireRtkOmp, ensureRtkInConfig } from './rtk-wiring.js';
+import { wireRtkOmp, wireRtkOpencode, wireRtkPi, ensureRtkInConfig } from './rtk-wiring.js';
 import { CAVEMAN_REMOTE_RULE, RTK_RELEASE_API, fetchJson, findFile, httpsGet, httpsDownload, parseChecksum, readTextIfExists, rtkPlatformSpec, sha256File, } from '../extensions/lib/utils.js';
 import { runLatestUpdate } from './update.js';
-import { TREE_FILES, sourcePath } from './manifest.js';
+import { OPENCODE_SERVER_SHIM, TREE_FILES, sourcePath } from './manifest.js';
 import { detectHosts, hostExtensionsDir } from './hosts.js';
 const EXT_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'extensions');
-// A written tree is the install for both hosts now, so --fix restores it for
-// whichever hosts have it, alongside the OMP package when that is present.
+// A written tree is the install for both hosts now, so --fix restores it for whichever hosts have it, alongside the OMP package when that is present.
 async function fixExtensionTrees() {
+    // The opencode entrypoint is foreign to pi/omp loaders: never copy it there, and remove strays.
+    const forHost = (id) => TREE_FILES.filter((file) => id === 'opencode' || !file.startsWith('opencode/'));
+    const scrubOpencodeDir = async (dest) => {
+        const dir = path.join(dest, 'opencode');
+        if (!existsSync(dir))
+            return;
+        if (dryRun) {
+            sayTagged(`  [dry-run] would remove foreign ${dir}`);
+            return;
+        }
+        await fs.rm(dir, { recursive: true, force: true });
+        sayTagged(`  [rm] foreign ${dir}`);
+    };
     for (const host of detectHosts()) {
         const dest = hostExtensionsDir(host.id);
-        // Repair a host whose tree is partly there: a half-written tree is exactly
-        // the case this runs for, and it reads as "not installed" to the detector.
-        const present = TREE_FILES.filter((file) => existsSync(path.join(dest, file))).length;
-        if (present === 0)
+        // Repair a host whose tree is partly there: a half-written tree is exactly the case this runs for, and it reads as "not installed" to the detector.
+        const present = forHost(host.id).filter((file) => existsSync(path.join(dest, file))).length;
+        if (present === 0) {
+            if (host.id !== 'opencode')
+                await scrubOpencodeDir(dest);
             continue;
+        }
         await fs.mkdir(dest, { recursive: true });
-        for (const file of TREE_FILES) {
+        for (const file of forHost(host.id)) {
             const from = path.join(EXT_DIR, ...file.split('/'));
             const text = await readTextIfExists(from);
             if (text === null)
@@ -29,26 +43,59 @@ async function fixExtensionTrees() {
             else
                 await writeIfChanged(path.join(dest, file), text, { dryRun, verbose });
         }
+        if (host.id !== 'opencode')
+            await scrubOpencodeDir(dest);
         if (!dryRun)
             sayTagged(`  [ok] ${host.label} extension tree: ${dest}`);
     }
 }
+// The tree alone does nothing on OpenCode without its entrypoint registered in opencode.json.
+async function fixOpencodeEntry() {
+    const { HOME } = await import('./common.js');
+    const dir = path.join(HOME, '.config', 'opencode', 'plugins', 'tersio');
+    const configPath = path.join(HOME, '.config', 'opencode', 'opencode.json');
+    const nested = path.join(dir, 'opencode', 'server.ts');
+    const nestedText = await readTextIfExists(nested);
+    if (!nestedText)
+        return;
+    // The loader resolves <pluginDir>/server.ts, so mirror the entry at the tree root.
+    await writeIfChanged(path.join(dir, 'server.ts'), OPENCODE_SERVER_SHIM, { dryRun, verbose });
+    const raw = await readTextIfExists(configPath);
+    let config = {};
+    try {
+        config = raw ? JSON.parse(raw) : {};
+    }
+    catch {
+        return;
+    }
+    const plugins = Array.isArray(config.plugins) ? [...config.plugins] : [];
+    const withoutTersio = plugins.filter((p) => typeof p !== 'string' || !p.includes('/opencode/plugins/tersio'));
+    if (withoutTersio.includes(dir))
+        return;
+    withoutTersio.push(dir);
+    config.plugins = withoutTersio;
+    if (dryRun) {
+        sayTagged(`  [dry-run] would register tersio in ${configPath}`);
+        return;
+    }
+    await fs.mkdir(path.dirname(configPath), { recursive: true });
+    await fs.writeFile(configPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+    sayTagged(`  [ok] OpenCode plugin entry: ${configPath}`);
+}
 async function fixExtensions(pluginsDir) {
     await fixExtensionTrees();
+    await fixOpencodeEntry();
     console.log('  Doctor --fix: restoring plugin extension files');
-    const tersioPluginDir = path.join(pluginsDir, 'node_modules', '@krtclcdy', 'tersio');
-    const pluginExtDir = path.join(tersioPluginDir, 'extensions');
+    const pluginExtDir = path.join(pluginsDir, 'node_modules', '@krtclcdy', 'tersio', 'extensions');
     await fs.mkdir(pluginExtDir, { recursive: true });
     // rule.md is skipped: its live content is the upstream fetch, not the bundle.
-    const bundledTree = TREE_FILES.filter((file) => file !== 'caveman-session/rule.md');
-    for (const file of bundledTree) {
+    for (const file of TREE_FILES.filter((f) => f !== 'caveman-session/rule.md')) {
         const text = await readTextIfExists(sourcePath(file));
         if (text === null)
             sayTagged(`  [warn] bundled source missing: ${sourcePath(file)}`);
         else
-            await writeIfChanged(path.join(pluginExtDir, file), text, { dryRun, verbose });
+            await writeIfChanged(path.join(pluginExtDir, ...file.split('/')), text, { dryRun, verbose });
     }
-    // Restore only a missing rule; a stale one is /ai-addons' to report.
     const ruleDest = path.join(pluginExtDir, 'caveman-session', 'rule.md');
     if ((await readTextIfExists(ruleDest)) === null) {
         const bundled = await readTextIfExists(path.join(EXT_DIR, 'caveman-session', 'rule.md'));
@@ -66,6 +113,14 @@ async function fixExtensions(pluginsDir) {
                 console.log('  [warn] Caveman rule unreachable and no bundled rule exists');
         }
     }
+    // Writing is not atomic, so re-read rather than assume the tree is whole.
+    if (dryRun)
+        return;
+    const missing = TREE_FILES.filter((file) => !existsSync(path.join(pluginExtDir, ...file.split('/'))));
+    if (missing.length > 0)
+        sayTagged(`  [fail] tree incomplete: ${missing.join(', ')}`);
+    else
+        sayTagged(`  [ok] extension tree: ${TREE_FILES.length} files`);
 }
 async function fixRegistrations(agentDir, pluginsDir) {
     console.log('  Doctor --fix: repairing config.yml registrations');
@@ -120,12 +175,16 @@ async function fixRtk(binDir) {
             httpsGet(checksAsset.browser_download_url).catch(() => null),
             httpsDownload(asset.browser_download_url, archivePath),
         ]);
-        if (checks) {
-            const expected = parseChecksum(checks, asset.name);
-            if (expected && await sha256File(archivePath) !== expected)
-                throw new Error(`checksum mismatch for ${asset.name}`);
-            debug('RTK checksum verified');
-        }
+        // Same rule as the installer: an unverifiable binary is not installed.
+        const unverified = (why) => new Error(`${why} for ${asset.name}. Re-run with --allow-unverified to accept it`);
+        if (!checks)
+            throw unverified('checksums.txt could not be downloaded');
+        const expected = parseChecksum(checks, asset.name);
+        if (!expected)
+            throw unverified('checksums.txt has no entry');
+        if (await sha256File(archivePath) !== expected)
+            throw new Error(`checksum mismatch for ${asset.name}`);
+        debug('RTK checksum verified');
         const extractDir = path.join(tmpDir, 'extracted');
         await fs.mkdir(extractDir, { recursive: true });
         if (asset.name.endsWith('.zip'))
@@ -147,6 +206,14 @@ async function fixRtk(binDir) {
     }
     if (!(await wireRtkOmp(binDest, { dryRun, verbose })))
         throw new Error('rtk wiring failed');
+    // Fail-open: a missing host wire must not fail the repair.
+    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+    if (existsSync(path.join(home, '.config', 'opencode', 'plugins', 'tersio'))) {
+        await wireRtkOpencode(binDest, { dryRun, verbose });
+    }
+    if (existsSync(path.join(home, '.pi', 'agent', 'extensions'))) {
+        await wireRtkPi(binDest, { dryRun, verbose });
+    }
 }
 async function fixPonytail(pluginsDir) {
     console.log('  Doctor --fix: restoring bundled Ponytail');