@krtclcdy/tersio 2.24.0 → 2.25.0

package/README.md

@@ -8,9 +8,7 @@
 [![Build](https://shieldcn.dev/github/ci/KurutoDenzeru/tersio.svg?variant=branded&size=xs&logo=githubactions&label=Build)](https://github.com/KurutoDenzeru/tersio/actions)
 [![MIT](https://shieldcn.dev/badge/license-MIT-2563eb.svg?variant=branded&size=xs&logo=opensourceinitiative)](./LICENSE)
 
-Token-saving add-ons for Oh My Pi and pi: terse caveman replies, compact
-RTK shell output, lean Ponytail code calls, usage tracking with a gain
-dashboard — one-command combo presets, one shared extension tree.
+Token saver & usage tracker for coding agents: terse caveman replies, compact RTK shell output, lean Ponytail code calls, and a gain dashboard — one-command combo presets over one shared extension tree.
 
 ## ⚡ Getting Started
 
@@ -25,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:
 
@@ -57,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 | Δ |
 |---|---|---|---|
@@ -80,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.
@@ -123,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 |
 |---|---|
@@ -131,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. |
@@ -149,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.
 
@@ -168,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.
@@ -178,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,6 +1,4 @@
-// cli/banner.ts — mini pixel-scissor welcome (16x12 px -> 6 half-block rows).
-// OMP-style launch moment for interactive runs: clack intro + note box.
-// 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() {
@@ -72,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;
@@ -84,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,7 +1,4 @@
-// cli/currency.ts — display-currency helpers (USD-base, offline snapshot rates).
-// Same 10 currencies, symbols, and snapshot rates as the dashboard's
-// converter (dashboard/app); the dashboard replaces rates with live
-// frankfurter figures when reachable, the CLI always uses the snapshot.
+// 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 = [
@@ -31,9 +28,7 @@ function parseCurrencyFlag(raw) {
     }
     return v;
 }
-// Stored default from the omp plugin lock file (written by tersio settings);
-// USD when missing, corrupt, or holding an unknown code. Sync so flag
-// parsing in cli/common.ts can fall back to it at startup.
+// Stored default; USD when missing, corrupt, or an unknown code.
 function readStoredCurrency() {
     const file = tersioSettingsFile();
     if (!existsSync(file))

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,9 +9,12 @@ 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 { 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 { 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';
 import { resolveRtkBinary } from '../extensions/lib/utils.js';
 const DASHBOARD_DIST = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'dashboard', 'dist');
@@ -50,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];
@@ -71,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();
@@ -115,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(),
@@ -216,12 +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');
-    const retiredReinforcement = explicitEntries.filter((entry) => entry.endsWith('/shared/mode-reinforcement.ts')).length;
-    addon('No retired reinforcement', retiredReinforcement === 0, retiredReinforcement ? `${retiredReinforcement} registration(s)` : 'ok', 'Extensions');
+    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);
@@ -246,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',
@@ -257,7 +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));
@@ -279,11 +315,54 @@ function setDiagSchedule(schedule) {
     writeDiagReport(base);
     return base;
 }
+// One field per call, validated against the same sets the CLI uses.
+async function saveDefaults(body) {
+    const profile = await storedProfile();
+    if (body.comboDefault !== undefined) {
+        const level = normalizeComboLevel(body.comboDefault);
+        if (!level)
+            return { ok: false, error: 'unknown combo level' };
+        profile.comboDefault = level;
+    }
+    if (body.cavemanDefault !== undefined) {
+        const v = String(body.cavemanDefault);
+        if (!CAVEMAN_DEFAULTS.has(v))
+            return { ok: false, error: 'unknown caveman level' };
+        profile.cavemanDefault = v;
+    }
+    if (body.ponytailDefault !== undefined) {
+        const v = String(body.ponytailDefault);
+        if (!PONYTAIL_DEFAULTS.has(v))
+            return { ok: false, error: 'unknown ponytail level' };
+        profile.ponytailDefault = v;
+    }
+    if (body.backupSchedule !== undefined) {
+        const v = String(body.backupSchedule);
+        if (!BACKUP_SCHEDULES.has(v))
+            return { ok: false, error: 'unknown backup schedule' };
+        profile.backupSchedule = v;
+    }
+    if (body.rtkDefault !== undefined) {
+        if (typeof body.rtkDefault !== 'boolean')
+            return { ok: false, error: 'rtk default must be true or false' };
+        profile.rtkDefault = body.rtkDefault;
+    }
+    await writePluginSettings(profile, {});
+    return {
+        ok: true,
+        profile: {
+            comboDefault: profile.comboDefault,
+            cavemanDefault: profile.cavemanDefault,
+            rtkDefault: profile.rtkDefault,
+            ponytailDefault: profile.ponytailDefault,
+            backupSchedule: profile.backupSchedule,
+        },
+    };
+}
 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;
@@ -295,6 +374,50 @@ async function saveDashboardCurrency(raw) {
     await writePluginSettings(profile, {});
     return code;
 }
+export const EXPORT_FORMATS = ['json', 'jsonl', 'csv'];
+export function exportRows(report) {
+    return report.recent.map((r) => ({
+        timestamp: new Date(r.t).toISOString(),
+        local: new Date(r.t).toLocaleString(),
+        agent: r.h ?? 'pi',
+        model: r.m,
+        input: r.i,
+        output: r.o,
+        cacheRead: r.cr ?? 0,
+        cacheWrite: r.cw ?? 0,
+        costUsd: r.usd,
+        elapsedMs: r.d,
+        status: r.st,
+    }));
+}
+export function csvCell(v) {
+    const s = v === undefined || v === null ? '' : String(v);
+    return /[",\n]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
+}
+export function exportBody(format, report) {
+    const stamp = new Date().toISOString().slice(0, 10);
+    if (format === 'json') {
+        return { body: JSON.stringify({ exportedAt: new Date().toISOString(), version: report.version, source: report.source, report }, null, 2), type: 'application/json' };
+    }
+    const rows = exportRows(report);
+    if (format === 'jsonl') {
+        return { body: rows.map((r) => JSON.stringify(r)).join('\n') + '\n', type: 'application/x-ndjson' };
+    }
+    const cols = Object.keys(rows[0] ?? { timestamp: '', agent: '' });
+    const head = cols.join(',');
+    const body = [head, ...rows.map((r) => cols.map((c) => csvCell(r[c])).join(','))].join('\n') + '\n';
+    return { body, type: 'text/csv; charset=utf-8' };
+}
+function serveExport(req, res) {
+    const format = ((req.url || '').split('?')[1] || '').match(/format=([a-z]+)/)?.[1];
+    const fmt = format && EXPORT_FORMATS.includes(format) ? format : 'json';
+    const { body, type } = exportBody(fmt, summarizeUsage(readUsage()));
+    res.writeHead(200, {
+        'Content-Type': type,
+        'Content-Disposition': `attachment; filename="tersio-usage-${new Date().toISOString().slice(0, 10)}.${fmt === 'jsonl' ? 'ndjson' : fmt}"`,
+    });
+    res.end(body);
+}
 function readBody(req) {
     return new Promise((resolve) => {
         let body = '';
@@ -307,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');
 }
@@ -351,6 +473,82 @@ async function runDashboard(options) {
             res.end(JSON.stringify({ ok: true, rows }));
             return;
         }
+        if (req.url === '/backups' && req.method === 'GET') {
+            const rows = listUsageBackups().map((b) => ({ file: path.basename(b.file), mtime: b.mtime, size: b.size }));
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            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 {
+                file = String(JSON.parse(await readBody(req)).file ?? '');
+            }
+            catch {
+                file = '';
+            }
+            const ok = deleteUsageBackup(file);
+            res.writeHead(ok ? 200 : 400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(ok ? { ok: true, file } : { ok: false, error: 'unknown backup' }));
+            return;
+        }
+        if (req.url === '/backups/restore' && req.method === 'POST') {
+            let file = '';
+            try {
+                file = String(JSON.parse(await readBody(req)).file ?? '');
+            }
+            catch {
+                file = '';
+            }
+            const ok = restoreUsageBackup(file);
+            res.writeHead(ok ? 200 : 400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(ok ? { ok: true, file } : { ok: false, error: 'unknown backup' }));
+            return;
+        }
+        if (req.url === '/settings' && req.method === 'GET') {
+            storedProfile().then((profile) => {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    comboDefault: profile.comboDefault,
+                    cavemanDefault: profile.cavemanDefault,
+                    rtkDefault: profile.rtkDefault,
+                    ponytailDefault: profile.ponytailDefault,
+                    backupSchedule: profile.backupSchedule,
+                }));
+            });
+            return;
+        }
+        if (req.url === '/settings' && req.method === 'POST') {
+            let body = {};
+            try {
+                body = JSON.parse(await readBody(req)) ?? {};
+            }
+            catch {
+                body = {};
+            }
+            const saved = await saveDefaults(body);
+            if (!saved.ok) {
+                res.writeHead(400, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: false, error: saved.error }));
+            }
+            else {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: true, ...saved.profile }));
+            }
+            return;
+        }
         if (req.url === '/currency' && req.method === 'POST') {
             let code = null;
             try {
@@ -375,11 +573,20 @@ async function runDashboard(options) {
             res.end(dataJson());
             return;
         }
+        if (req.url?.startsWith('/export')) {
+            serveExport(req, res);
+            return;
+        }
         if (req.url === '/health') {
             res.writeHead(200, { 'Content-Type': 'application/json' });
             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 {