@krtclcdy/tersio 2.6.0 → 2.8.0

package/cli/dashboard.js

@@ -1,4 +1,4 @@
-// cli/dashboard.ts — localhost gain dashboard. Serves the single plain-HTML
+// cli/dashboard.ts — gain dashboard. Serves the single plain-HTML
 // template (no deps, no build) plus a /data.json endpoint from the ledger.
 // Binds 127.0.0.1 only; --export writes a file://-ready file instead.
 // Note: no Promise.withResolvers here — engines still allow Node 20.12,
@@ -35,7 +35,7 @@ async function runDashboard(options) {
             .replace('href="brand.webp"', `href="${await faviconDataUri()}"`)
             .replace('src="brand.webp"', `src="${await faviconDataUri()}"`);
         await fs.writeFile(options.exportFile, inline, 'utf8');
-        console.log(`[ok] dashboard exported → ${options.exportFile}`);
+        console.log(`[ok] gain exported → ${options.exportFile}`);
         return;
     }
     const html = await withInteractiveSpinner('Loading dashboard template', templateHtml);
@@ -64,7 +64,7 @@ async function runDashboard(options) {
         const address = server.address();
         const port = typeof address === 'object' && address ? address.port : options.port;
         const url = `http://127.0.0.1:${port}`;
-        console.log(`[ok] dashboard live → ${url} (Ctrl-C to stop)`);
+        console.log(`[ok] gain live → ${url} (Ctrl-C to stop)`);
         if (options.open)
             openBrowser(url);
     });

package/cli/doctor.js

@@ -22,6 +22,7 @@ async function runDoctor() {
     const rtkIndex = path.join(extDir, 'rtk-session', 'index.js');
     const updaterIndex = path.join(extDir, 'ai-addons-updater', 'index.js');
     const comboIndex = path.join(extDir, 'combo-toggle', 'index.js');
+    const tersioIndex = path.join(extDir, 'tersio-commands', 'index.js');
     const modeReinforcement = path.join(extDir, 'shared', 'mode-reinforcement.js');
     const selfPkg = path.join(pluginsDir, 'node_modules', PACKAGE_NAME, 'package.json');
     // Independent probes start concurrently; sections report in fixed order as
@@ -42,6 +43,7 @@ async function runDoctor() {
         rtkIndexText: readTextIfExists(rtkIndex),
         updaterIndexText: readTextIfExists(updaterIndex),
         comboIndexText: readTextIfExists(comboIndex),
+        tersioIndexText: readTextIfExists(tersioIndex),
         modeReinforcementText: readTextIfExists(modeReinforcement),
         ruleMtime: fs.stat(cavemanRule).catch(() => null),
         rtkMtime: fs.stat(rtkBin).catch(() => null),
@@ -60,11 +62,12 @@ async function runDoctor() {
         probes.configText,
         probes.updateVersion,
     ]));
-    const [cavemanIndexText, rtkIndexText, updaterIndexText, comboIndexText, modeReinforcementText, ponytailPkgText, ponytailExtText, pluginsPkgRaw, selfPkgText] = await runInteractivePhase('Checking extensions and plugins', () => Promise.all([
+    const [cavemanIndexText, rtkIndexText, updaterIndexText, comboIndexText, tersioIndexText, modeReinforcementText, ponytailPkgText, ponytailExtText, pluginsPkgRaw, selfPkgText] = await runInteractivePhase('Checking extensions and plugins', () => Promise.all([
         probes.cavemanIndexText,
         probes.rtkIndexText,
         probes.updaterIndexText,
         probes.comboIndexText,
+        probes.tersioIndexText,
         probes.modeReinforcementText,
         probes.ponytailPkgText,
         probes.ponytailExtText,
@@ -113,6 +116,7 @@ async function runDoctor() {
     check('RTK extension', rtkIndexText !== null);
     check('Updater extension', updaterIndexText !== null);
     check('Combo extension', comboIndexText !== null);
+    check('Tersio commands extension', tersioIndexText !== null);
     check('Mode reinforcement extension', modeReinforcementText !== null);
     section('Plugins');
     check('Ponytail package', ponytailPkgText !== null);

package/cli/install.js

@@ -3,10 +3,13 @@ import { promises as fs } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { BUN_BIN_DIR, COMBO_PRESET_MODES, EXTENSIONS_KEY_RE, HOME, IS_WINDOWS, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, SCOPE_MAP, applyUpdate, cavemanDefaultFlag, comboDefaultFlag, command, dryRun, install, ponytailDefaultFlag, profileFlagsGiven, reinstall, rtkDefaultFlag, scopeFlag, verbose, yes, debug, ensureExtensionAfterConfigEntry, ensureExtensionInConfig, ensurePonytailConfigValue, execP, parseJsonObject, readPluginsPackage, writeIfChanged, } from './common.js';
-import { ask, askInteractiveChoice, closeRL, execNetwork, tty, withInteractiveSpinner, } from './interactive.js';
-import { checkForUpdate } from './update.js';
+import { BUN_BIN_DIR, COMBO_PRESET_MODES, EXTENSIONS_KEY_RE, HOME, IS_WINDOWS, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, SCOPE_MAP, applyUpdate, cavemanDefaultFlag, comboDefaultFlag, command, dryRun, install, ponytailDefaultFlag, profileFlagsGiven, reinstall, rtkDefaultFlag, scopeFlag, verbose, yes, dashboardExport, dashboardPort, debug, ensureExtensionAfterConfigEntry, ensureExtensionInConfig, ensurePonytailConfigValue, execP, parseJsonObject, readPluginsPackage, writeIfChanged, } from './common.js';
+import { ask, askInteractiveChoice, askInteractiveConfirm, closeRL, execNetwork, tty, withInteractiveSpinner, } from './interactive.js';
+import { checkForUpdate, runLatestUpdate } from './update.js';
 import { runUninstall } from './uninstall.js';
+import { runDoctor } from './doctor.js';
+import { runUsage } from './usage.js';
+import { runDashboard } from './dashboard.js';
 import { CAVEMAN_REMOTE_RULE, RTK_RELEASE_API, fetchJson, findFile, httpsGet, httpsDownload, parseChecksum, readTextIfExists, rtkPlatformSpec, sha256File, } from '../extensions/lib/utils.js';
 // Paths to extension source files (relative to this script)
 const EXT_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'extensions');
@@ -15,6 +18,7 @@ const CAVEMAN_INDEX = path.join(EXT_DIR, 'caveman-session', 'index.js');
 const RTK_SESSION_INDEX = path.join(EXT_DIR, 'rtk-session', 'index.js');
 const UPDATER_INDEX = path.join(EXT_DIR, 'ai-addons-updater', 'index.js');
 const COMBO_TOGGLE_INDEX = path.join(EXT_DIR, 'combo-toggle', 'index.js');
+const TERSIO_COMMANDS_INDEX = path.join(EXT_DIR, 'tersio-commands', 'index.js');
 const MODE_REINFORCEMENT_INDEX = path.join(EXT_DIR, 'shared', 'mode-reinforcement.js');
 const SHARED_TYPES = path.join(EXT_DIR, 'shared', 'types.js');
 const LIB_UTILS = path.join(EXT_DIR, 'lib', 'utils.js');
@@ -22,7 +26,7 @@ const SHARED_PLUGIN_SETTINGS = path.join(EXT_DIR, 'shared', 'plugin-settings.js'
 const PONYTAIL_GITHUB_SPEC = 'github:DietrichGebert/ponytail';
 const PONYTAIL_NPM_SPEC = '@dietrichgebert/ponytail@latest';
 async function stepPonytail(pluginsDir, userDir, options) {
-    console.log('\n[1/7] Installing Ponytail plugin...');
+    console.log('\n[1/8] Installing Ponytail plugin...');
     await fs.mkdir(pluginsDir, { recursive: true });
     const pkgPath = path.join(pluginsDir, 'package.json');
     const pkg = await readPluginsPackage(pkgPath);
@@ -124,7 +128,7 @@ async function stepPonytail(pluginsDir, userDir, options) {
 // Settings → Plugins page (OMP enumerates plugins/package.json dependencies).
 // Returns true when the package is verified in plugins/node_modules.
 async function stepSelfPlugin(pluginsDir, options) {
-    console.log('\n[2/7] Registering tersio as OMP plugin...');
+    console.log('\n[2/8] Registering tersio as OMP plugin...');
     const pkgPath = path.join(pluginsDir, 'package.json');
     const pkg = await readPluginsPackage(pkgPath);
     pkg.dependencies[PACKAGE_NAME] = `^${PACKAGE_VERSION}`;
@@ -253,7 +257,7 @@ async function extractRtkArchive(archivePath, extractDir) {
     return false;
 }
 async function stepRtk(binDir, options) {
-    console.log('\n[3/7] Installing RTK binary...');
+    console.log('\n[3/8] Installing RTK binary...');
     try {
         const release = await withInteractiveSpinner('Finding latest RTK release', () => fetchJson(RTK_RELEASE_API));
         const triple = resolveRtkTriple();
@@ -342,14 +346,14 @@ async function stepSharedSessionState(extDir, options) {
     ], 'shared/session-state.js', options);
 }
 async function stepModeReinforcement(extDir, ponytailExtPath, options) {
-    console.log('\n[7/7] Installing mode reinforcement extension...');
+    console.log('\n[8/8] Installing mode reinforcement extension...');
     const dest = path.join(extDir, 'shared', 'mode-reinforcement.js');
     if (!await copySources(extDir, [[MODE_REINFORCEMENT_INDEX, path.join('shared', 'mode-reinforcement.js')]], 'shared/mode-reinforcement.js', options))
         return;
     await ensureExtensionAfterConfigEntry(path.join(path.dirname(extDir), 'config.yml'), dest, ponytailExtPath, 'mode reinforcement', options);
 }
 async function stepRtkSession(extDir, options) {
-    console.log('\n[4/7] Installing RTK session extension...');
+    console.log('\n[4/8] Installing RTK session extension...');
     await copySources(extDir, [[RTK_SESSION_INDEX, path.join('rtk-session', 'index.js')]], 'rtk-session/index.js', options);
 }
 // One rule fetch serves user- and project-level installs; dry runs stay offline
@@ -366,7 +370,7 @@ async function fetchCavemanRule(options) {
     }
 }
 async function stepCaveman(extDir, rule, options) {
-    console.log('\n[5/7] Installing Caveman session extension...');
+    console.log('\n[5/8] Installing Caveman session extension...');
     const cavemanDir = path.join(extDir, 'caveman-session');
     if (!options.dryRun)
         await fs.mkdir(cavemanDir, { recursive: true });
@@ -383,11 +387,15 @@ async function stepCaveman(extDir, rule, options) {
     }
     await copySources(extDir, [[CAVEMAN_INDEX, path.join('caveman-session', 'index.js')]], 'caveman-session/index.js', options);
 }
+async function stepTersioCommands(extDir, options) {
+    console.log('\n[7/8] Installing Tersio root-command extension...');
+    await copySources(extDir, [[TERSIO_COMMANDS_INDEX, path.join('tersio-commands', 'index.js')]], 'tersio-commands/index.js', options);
+}
 async function stepUpdater(extDir, options) {
     await copySources(extDir, [[UPDATER_INDEX, path.join('ai-addons-updater', 'index.js')]], 'ai-addons-updater/index.js', options);
 }
 async function stepCombo(extDir, options) {
-    console.log('\n[6/7] Installing Combo toggle extension...');
+    console.log('\n[6/8] Installing Combo toggle extension...');
     const dest = path.join(extDir, 'combo-toggle', 'index.js');
     if (!await copySources(extDir, [[COMBO_TOGGLE_INDEX, path.join('combo-toggle', 'index.js')]], 'combo-toggle/index.js', options))
         return;
@@ -536,7 +544,76 @@ async function writePluginSettings(profile, options) {
     await fs.writeFile(lockPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
     console.log(`  [write] Plugin settings in ${lockPath}`);
 }
+let updatePromptDone = false;
+// Bare `tersio` at a terminal is a command picker, not an install run:
+// update offer first (when pending), then a Clack menu over every command.
+// Scripts, pipes, --yes, and --dry-run keep the old straight-to-install path.
+async function runCommandMenu() {
+    const newer = await checkForUpdate();
+    if (newer && !dryRun) {
+        const answer = await askInteractiveConfirm(`tersio ${newer} is available (installed ${PACKAGE_VERSION}). Install it now?`);
+        if (answer.status === 'confirmed' && answer.value) {
+            await runLatestUpdate();
+            closeRL();
+            return;
+        }
+        if (answer.status === 'cancelled') {
+            closeRL();
+            process.exit(130);
+        }
+        console.log(`\n  [update] staying on ${PACKAGE_VERSION} — run ` + '`tersio update`' + ` anytime`);
+    }
+    updatePromptDone = true;
+    const choice = await askInteractiveChoice('Tersio — what next?', [
+        { value: 'install', label: 'Install add-ons', hint: 'user/project scope + combo defaults' },
+        { value: 'check', label: 'Check for updates', hint: 'compare installed vs latest release' },
+        { value: 'update', label: 'Update everything', hint: 'CLI plus all ai-addons' },
+        { value: 'doctor', label: 'Doctor', hint: 'verify the installation' },
+        { value: 'usage', label: 'Usage', hint: 'token usage and savings report' },
+        { value: 'gain', label: 'Gain dashboard', hint: 'open the report in your browser' },
+        { value: 'uninstall', label: 'Uninstall', hint: 'remove tersio' },
+    ], 'install');
+    if (choice.status !== 'selected') {
+        closeRL();
+        process.exit(130);
+    }
+    switch (choice.value) {
+        case 'install':
+            await runInstall();
+            break;
+        case 'check': {
+            const latest = await checkForUpdate();
+            console.log(latest ? `  [update] tersio ${latest} available (installed ${PACKAGE_VERSION})` : `  [ok] tersio ${PACKAGE_VERSION} is the latest`);
+            closeRL();
+            break;
+        }
+        case 'update':
+            await runLatestUpdate();
+            closeRL();
+            break;
+        case 'doctor':
+            await runDoctor();
+            closeRL();
+            break;
+        case 'usage':
+            await runUsage();
+            closeRL();
+            break;
+        case 'gain':
+            await runDashboard({ port: dashboardPort, open: true, exportFile: dashboardExport });
+            closeRL();
+            break;
+        case 'uninstall':
+            await runUninstall();
+            closeRL();
+            break;
+    }
+}
 async function runInstall() {
+    if (command === null && tty() && !yes) {
+        await runCommandMenu();
+        return;
+    }
     if (reinstall) {
         await runUninstall({ yes: true, removePonytail: false, removeRtk: true });
     }
@@ -550,8 +627,27 @@ async function runInstall() {
     // the apply-update payload, which is itself an update run.
     if (tty() && !applyUpdate && command !== 'uninstall') {
         const newer = await checkForUpdate();
-        if (newer)
-            console.log(`\n  [update] tersio ${newer} available (installed ${PACKAGE_VERSION}) — run \`tersio update\``);
+        if (newer) {
+            // Bare `tersio` with an update pending: offer it now (Y/n) instead of
+            // burying the banner above the install prompts. Yes runs the full
+            // update and stops here — the fresh binary owns what follows.
+            if (command === null && !dryRun && !yes && !updatePromptDone) {
+                const answer = await askInteractiveConfirm(`tersio ${newer} is available (installed ${PACKAGE_VERSION}). Install it now?`);
+                if (answer.status === 'confirmed' && answer.value) {
+                    await runLatestUpdate();
+                    closeRL();
+                    return;
+                }
+                if (answer.status === 'cancelled') {
+                    closeRL();
+                    process.exit(130);
+                }
+                console.log(`\n  [update] staying on ${PACKAGE_VERSION} — run \`tersio update\` anytime`);
+            }
+            else {
+                console.log(`\n  [update] tersio ${newer} available (installed ${PACKAGE_VERSION}) — run \`tersio update\``);
+            }
+        }
     }
     const scope = await resolveScope();
     // Resolve session defaults: flags > interactive prompt > defaults.
@@ -583,6 +679,7 @@ async function runInstall() {
         await stepRtkSession(userExtDir, options);
         await stepCaveman(userExtDir, cavemanRule, options);
         await stepCombo(userExtDir, options);
+        await stepTersioCommands(userExtDir, options);
         await stepModeReinforcement(userExtDir, ponytailExtPath, options);
         await stepUpdater(userExtDir, options);
         if (selfPlugin)
@@ -594,6 +691,7 @@ async function runInstall() {
         await stepSharedSessionState(projectExtDir, options);
         await stepRtkSession(projectExtDir, options);
         await stepCaveman(projectExtDir, cavemanRule, options);
+        await stepTersioCommands(projectExtDir, options);
         await stepUpdater(projectExtDir, options);
         console.log('  [note] Ponytail, RTK binary, and Combo toggle require user-level (global) install');
     }

package/cli/interactive.js

@@ -1,6 +1,6 @@
 // cli/interactive.ts — TTY layer: readline, Clack spinners, selects, task phases.
 import readline from 'node:readline';
-import { cancel as clackCancel, select as clackSelect, spinner as clackSpinner, tasks as clackTasks } from '@clack/prompts';
+import { cancel as clackCancel, confirm as clackConfirm, select as clackSelect, spinner as clackSpinner, tasks as clackTasks } from '@clack/prompts';
 import { execP } from './common.js';
 const RL = readline.createInterface({ input: process.stdin, output: process.stdout });
 let rlOpen = true;
@@ -56,6 +56,17 @@ async function askInteractiveChoice(message, options, initialValue) {
     }
     return { status: 'selected', value: choice };
 }
+async function askInteractiveConfirm(message, initialValue = true) {
+    if (!tty())
+        return { status: 'unavailable' };
+    closeRL();
+    const answer = await clackConfirm({ message, initialValue });
+    if (typeof answer !== 'boolean') {
+        clackCancel('Aborted.');
+        return { status: 'cancelled' };
+    }
+    return { status: 'confirmed', value: answer };
+}
 // Run collecting work under one TTY-only Clack task. Callers print after the
 // task completes, keeping normal output out of the spinner animation.
 async function runInteractivePhase(title, collect) {
@@ -69,4 +80,4 @@ async function runInteractivePhase(title, collect) {
 async function execNetwork(label, cmd, args, opts = {}) {
     return withInteractiveSpinner(label, () => execP(cmd, args, opts));
 }
-export { ask, closeRL, tty, withInteractiveSpinner, execNetwork, askInteractiveChoice, runInteractivePhase, };
+export { ask, closeRL, tty, withInteractiveSpinner, execNetwork, askInteractiveChoice, askInteractiveConfirm, runInteractivePhase, };

package/cli/uninstall.js

@@ -71,6 +71,7 @@ async function runUninstall(options = {}) {
         'rtk-session',
         'ai-addons-updater',
         'combo-toggle',
+        'tersio-commands',
         'shared',
         // Only consumed by ai-addons-updater (removed above); otherwise orphaned.
         'lib',

package/cli/usage.js

@@ -1,5 +1,5 @@
 // cli/usage.ts — ledger + session-token usage report, tokscale-style.
-import { co2Grams, importSessionTokens, readUsage, usdCost, } from '../extensions/shared/usage-ledger.js';
+import { co2Grams, importSessionTokens, priceFor, readUsage, usdCost, } from '../extensions/shared/usage-ledger.js';
 import { withInteractiveSpinner } from './interactive.js';
 export function summarizeUsage(rows) {
     const byKind = {};
@@ -12,12 +12,15 @@ export function summarizeUsage(rows) {
     const session = importSessionTokens();
     let usd = 0;
     let priced = true;
+    let savedUsd = 0;
     for (const [model, t] of Object.entries(session.byModel)) {
         const c = usdCost(t, model);
         usd += c.usd;
         if (!c.priced)
             priced = false;
+        savedUsd += (t.cacheRead / 1e6) * priceFor(model).price.input;
     }
+    const byTool = Object.entries(session.byTool).sort((a, b) => b[1] - a[1]).slice(0, 10);
     return {
         total: rows.length,
         byKind,
@@ -28,8 +31,12 @@ export function summarizeUsage(rows) {
         tokens: session.totals,
         byModel: session.byModel,
         byDay: session.byDay,
+        byDayModel: session.byDayModel,
+        byTool,
         usd,
         priced,
+        savedUsd,
+        costMeasured: session.costMeasured,
         co2g: co2Grams(session.totals.output),
     };
 }
@@ -44,7 +51,7 @@ function printReport(report) {
     }
     const t = report.tokens;
     console.log(`  Tokens  input ${fmt(t.input)} · output ${fmt(t.output)} · cache read ${fmt(t.cacheRead)} · cache write ${fmt(t.cacheWrite)} (${report.messages} assistant messages)`);
-    console.log(`  Cost    $${report.usd.toFixed(2)}${report.priced ? '' : ' (includes default pricing for unknown models)'} · CO2 ~${report.co2g.toFixed(1)}g (est.)`);
+    console.log(`  Cost    $${report.usd.toFixed(2)}${report.priced ? '' : ' (includes default pricing for unknown models)'} · ~$${report.savedUsd.toFixed(2)} saved by cache (est.) · CO2 ~${report.co2g.toFixed(1)}g (est.)`);
     const models = Object.entries(report.byModel).sort((a, b) => (b[1].input + b[1].output) - (a[1].input + a[1].output)).slice(0, 5);
     if (models.length) {
         console.log('  By model');
@@ -52,6 +59,12 @@ function printReport(report) {
             console.log(`    ${model}: in ${fmt(b.input)} · out ${fmt(b.output)} · cache r/w ${fmt(b.cacheRead)}/${fmt(b.cacheWrite)}`);
         }
     }
+    if (report.byTool.length) {
+        console.log('  Top tools');
+        for (const [tool, n] of report.byTool) {
+            console.log(`    ${n}× ${tool}`);
+        }
+    }
     if (report.total) {
         console.log('  Activity');
         for (const [kind, n] of Object.entries(report.byKind)) {
@@ -61,7 +74,6 @@ function printReport(report) {
         for (const [detail, n] of report.byDetail) {
             console.log(`    ${n}× ${detail}`);
         }
-        console.log(`  Total rows: ${report.total} · last write: ${report.lastWrite}`);
     }
 }
 async function runUsage() {

package/extensions/shared/usage-ledger.js

@@ -64,8 +64,11 @@ function walkJsonl(dir, out, cap) {
 export function importSessionTokens() {
     const byModel = {};
     const byDay = {};
+    const byDayModel = {};
+    const byTool = {};
     const totals = zeroBreakdown();
     let messages = 0;
+    let costMeasured = 0;
     const files = [];
     walkJsonl(sessionsDir(), files, 2000);
     for (const file of files) {
@@ -92,13 +95,44 @@ export function importSessionTokens() {
                 if (day) {
                     byDay[day] ??= zeroBreakdown();
                     addInto(byDay[day], msg.usage);
+                    const n = msg.usage;
+                    const sum = ['input', 'output', 'cacheRead', 'cacheWrite'].reduce((a, k) => a + (typeof n[k] === 'number' && Number.isFinite(n[k]) ? Math.floor(n[k]) : 0), 0);
+                    if (sum > 0) {
+                        byDayModel[day] ??= {};
+                        byDayModel[day][model] = (byDayModel[day][model] ?? 0) + sum;
+                    }
+                }
+                if (typeof msg.usage.cost === 'number' && Number.isFinite(msg.usage.cost))
+                    costMeasured += msg.usage.cost;
+                for (const part of msg.content ?? []) {
+                    if (part?.type === 'toolCall' && typeof part.name === 'string' && part.name) {
+                        const key = part.name === 'bash' ? `bash:${leadBinary(part.arguments?.command)}` : part.name;
+                        byTool[key] = (byTool[key] ?? 0) + 1;
+                    }
                 }
                 messages += 1;
             }
             catch { /* skip corrupt lines */ }
         }
     }
-    return { messages, totals, byModel, byDay };
+    return { messages, totals, byModel, byDay, byDayModel, byTool, costMeasured };
+}
+// Lead binary of a shell string: first segment head past `cd` chains and
+// VAR=x assignments (`cd /x && git status` → `git`). Falls back to `bash`.
+const SKIP_HEADS = ['cd', 'echo', 'export', 'true', 'false'];
+function leadBinary(command) {
+    if (typeof command !== 'string' || !command.trim())
+        return 'bash';
+    for (const seg of command.split(/&&|;|\n|\|(?!\|)/)) {
+        const toks = seg.trim().split(/\s+/).filter(Boolean);
+        let i = 0;
+        while (i < toks.length && (toks[i] === 'sudo' || /^[A-Za-z_][A-Za-z0-9_]*=/.test(toks[i])))
+            i++;
+        const head = (toks[i] ?? '').replace(/^['"]|['"]$/g, '').split('/').pop() ?? '';
+        if (head && !SKIP_HEADS.includes(head))
+            return head;
+    }
+    return 'bash';
 }
 const PRICE_TABLE = [
     { match: ':free', price: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 } },

package/extensions/tersio-commands/index.js

@@ -4,6 +4,8 @@
 // sibling extensions restore from, then reloads so their local mirrors sync
 // (same mechanism /combo already uses to drive its siblings).
 import { COMBO_LEVELS, activeModesSummary, getSharedComboState, normalizeComboLevel, normalizeMode, reconcileSharedComboEntries, sessionEntries, setSharedComboLevel, setSharedComboMode, } from '../shared/session-state.js';
+import os from 'node:os';
+import path from 'node:path';
 import { appendUsage, readUsage } from '../shared/usage-ledger.js';
 import { checkAddonsSummary, runAddonUpdate } from '../ai-addons-updater/index.js';
 const HELP = [
@@ -35,6 +37,23 @@ function usageSummary() {
     const last = new Date(rows[rows.length - 1].ts).toISOString();
     return `tersio usage: ${rows.length} rows (${parts.join(', ')}), last write ${last}.`;
 }
+// Gain opens instantaneously in the default browser: export a file://-ready
+// snapshot (data inlined, no server to babysit) and open it. Falls back to
+// the shell command when export or open fails.
+async function openGainDashboard(pi, ctx) {
+    const file = path.join(os.tmpdir(), `tersio-gain-${Date.now()}.html`);
+    try {
+        const exported = await pi.exec?.('tersio', ['gain', '--export', file], { cwd: ctx?.cwd });
+        if (!exported || exported.code !== 0)
+            throw new Error((exported?.stderr || 'export failed').trim());
+        const openCmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+        await pi.exec?.(openCmd, [file], { cwd: ctx?.cwd });
+        ctx?.ui?.notify?.(`tersio gain: dashboard opened in your browser.`, 'info');
+    }
+    catch (e) {
+        ctx?.ui?.notify?.(`tersio gain: could not open dashboard (${e.message}). Run 'tersio gain --open' in a shell.`, 'warning');
+    }
+}
 export default function tersioCommandsExtension(pi) {
     pi.setLabel?.('Tersio unified root command');
     async function reload(ctx) {
@@ -138,8 +157,12 @@ export default function tersioCommandsExtension(pi) {
                 await runAddonUpdate(pi, ctx, target, dryRun);
                 return;
             }
-            if (sub === 'gain' || sub === 'usage') {
-                ctx?.ui?.notify?.(`${usageSummary()}\nFull dashboard: run \`tersio dashboard --open\` in a shell.`, 'info');
+            if (sub === 'gain') {
+                await openGainDashboard(pi, ctx);
+                return;
+            }
+            if (sub === 'usage') {
+                ctx?.ui?.notify?.(usageSummary(), 'info');
                 return;
             }
             ctx?.ui?.notify?.(`Unknown subcommand: ${sub}.\n${HELP}`, 'warning');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krtclcdy/tersio",
-  "version": "2.6.0",
+  "version": "2.8.0",
   "description": "✂️ Token-saving OMP add-ons: terse Caveman replies, compact RTK shell output, lean Ponytail code calls — one-command combo presets.",
   "keywords": [
     "omp",

package/tersio.js

@@ -2,7 +2,7 @@
 // tersio.ts — Install Tersio (caveman/rtk/ponytail) add-ons on any OMP device.
 // Usage: node tersio.js [install|update|reinstall|doctor|uninstall|version|help] [options]
 // Requires: node/npm and omp CLI
-import { PACKAGE_BIN, PACKAGE_VERSION, applyUpdate, commandArg, dashboard, dashboardExport, dashboardOpen, dashboardPort, doctor, showHelp, showVersion, uninstall, unknownCommand, update, usage, } from './cli/common.js';
+import { PACKAGE_BIN, PACKAGE_VERSION, applyUpdate, commandArg, gain, dashboardExport, dashboardOpen, dashboardPort, doctor, showHelp, showVersion, uninstall, unknownCommand, update, usage, } from './cli/common.js';
 import { closeRL } from './cli/interactive.js';
 import { runInstall } from './cli/install.js';
 import { runDoctor } from './cli/doctor.js';
@@ -19,7 +19,7 @@ Commands:
   reinstall    Clean and reinstall the user-scope add-ons
   doctor       Check the current installation
   usage        Ledger-backed usage + savings report
-  dashboard    Serve the gain dashboard (localhost only)
+  gain         Open the gain dashboard (localhost only)
   uninstall    Remove the managed extensions
   version      Print the package version
   help         Show this help
@@ -35,9 +35,9 @@ Options:
   --yes, -y
   --dry-run
   --verbose
-  --port <n> (dashboard: pin port, default ephemeral)
-  --open (dashboard: open browser)
-  --export <file> (dashboard: write HTML file instead of serving)
+  --port <n> (gain: pin port, default ephemeral)
+  --open (gain: open browser)
+  --export <file> (gain: write HTML file instead of serving)
   --version, -v
   --help, -h`);
 }
@@ -74,7 +74,7 @@ async function main() {
         closeRL();
         return;
     }
-    if (dashboard) {
+    if (gain) {
         await runDashboard({ port: dashboardPort, open: dashboardOpen, exportFile: dashboardExport });
         closeRL();
         return;