@krtclcdy/tersio 2.24.0 → 2.25.0

package/cli/install.js

@@ -3,8 +3,8 @@ 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, IS_WINDOWS, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, args, applyUpdate, cavemanDefaultFlag, comboDefaultFlag, command, dryRun, ponytailDefaultFlag, profileFlagsGiven, rtkDefaultFlag, verbose, yes, dashboardExport, dashboardPort, debug, ensurePonytailConfigValue, execP, parseJsonObject, readPluginsPackage, writeIfChanged, } from './common.js';
-import { askInteractiveChoice, askInteractiveConfirm, closeRL, execNetwork, tty, withInteractiveSpinner, } from './interactive.js';
+import { BUN_BIN_DIR, COMBO_PRESET_MODES, HOME, IS_WINDOWS, OMP_AGENT_DIR, OMP_PLUGINS_DIR, OMP_BIN, PACKAGE_NAME, PACKAGE_VERSION, RTK_BINARY_NAME, args, allowUnverified, applyUpdate, cavemanDefaultFlag, comboDefaultFlag, command, dryRun, ponytailDefaultFlag, profileFlagsGiven, rtkDefaultFlag, verbose, yes, dashboardExport, dashboardPort, debug, ensurePonytailConfigValue, execP, parseJsonObject, readPluginsPackage, writeIfChanged, } from './common.js';
+import { askInteractiveChoice, askInteractiveConfirm, closeRL, execNetwork, tty, withInteractiveSpinner, withInteractiveTask, sayTagged } from './interactive.js';
 import { printWelcome } from './banner.js';
 import { checkForUpdate, runLatestUpdate } from './update.js';
 import { runUninstall } from './uninstall.js';
@@ -12,10 +12,12 @@ import { runDoctor } from './doctor.js';
 import { runReset } from './reset.js';
 import { runUsage } from './usage.js';
 import { runDashboard } from './dashboard.js';
-import { wireRtkOmp } from './rtk-wiring.js';
+import { wireRtkOmp, wireRtkOpencode, wireRtkPi } from './rtk-wiring.js';
 import { CAVEMAN_REMOTE_RULE, RTK_RELEASE_API, fetchJson, findFile, findHoistedPackage, httpsGet, httpsDownload, parseChecksum, piAgentDir, readTextIfExists, resolveRtkBinary, rtkPlatformSpec, sha256File, } from '../extensions/lib/utils.js';
-import { storedProfile, writePluginSettings } from './profile.js';
-import { filesUnder, sourcePath } from './manifest.js';
+import { formatCliStatus, storedProfile, storedProfileSync, writePluginSettings } from './profile.js';
+import { runSettings } from './settings.js';
+import { tersioSettingsFile } from '../extensions/shared/plugin-settings.js';
+import { OPENCODE_SERVER_SHIM, filesUnder, sourcePath } from './manifest.js';
 import { detectHosts, hostHint, hostLabel, parseHostArg, piTersioSource } from './hosts.js';
 async function stepPonytail(pluginsDir, options) {
     if (!options.quiet)
@@ -31,9 +33,9 @@ async function stepPonytail(pluginsDir, options) {
     }
     if (options.dryRun) {
         if (verbose && !options.quiet)
-            console.log(`  [dry-run] would write ${pkgPath}`);
+            sayTagged(`  [dry-run] would write ${pkgPath}`);
         if (migrated && verbose && !options.quiet)
-            console.log(`  [dry-run] would drop the separate @dietrichgebert/ponytail dependency (bundled with tersio)`);
+            sayTagged(`  [dry-run] would drop the separate @dietrichgebert/ponytail dependency (bundled with tersio)`);
     }
     else if (migrated) {
         await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
@@ -63,7 +65,7 @@ async function stepPonytail(pluginsDir, options) {
                 await execNetwork('Installing bundled Ponytail', 'bun', ['install'], { cwd: pluginsDir, timeout: 180000 });
             }
             catch (e) {
-                console.log(`  [fail] Could not install bundled ponytail: ${e.message}`);
+                sayTagged(`  [fail] Could not install bundled ponytail: ${e.message}`);
                 console.log('  [hint] Manual: cd ~/.omp/plugins && npm install --no-audit --no-fund');
             }
         }
@@ -91,14 +93,14 @@ async function stepSelfPlugin(pluginsDir, options) {
         if (legacy in pkg.dependencies) {
             delete pkg.dependencies[legacy];
             if (!options.dryRun && !options.quiet)
-                console.log(`  [migrate] dropped legacy ${legacy} dependency`);
+                sayTagged(`  [migrate] dropped legacy ${legacy} dependency`);
         }
     }
     if (options.dryRun) {
         if (verbose && !options.quiet)
-            console.log(`  [dry-run] would add ${PACKAGE_NAME}@^${PACKAGE_VERSION} to ${pkgPath}`);
+            sayTagged(`  [dry-run] would add ${PACKAGE_NAME}@^${PACKAGE_VERSION} to ${pkgPath}`);
         if (verbose && !options.quiet)
-            console.log(`  [dry-run] would run: npm install --no-audit --no-fund (in ${pluginsDir})`);
+            sayTagged(`  [dry-run] would run: npm install --no-audit --no-fund (in ${pluginsDir})`);
         return false;
     }
     // pkg.dependencies[PACKAGE_NAME] was assigned above, so only reinstall skips this fast path.
@@ -119,14 +121,14 @@ async function stepSelfPlugin(pluginsDir, options) {
             await execNetwork('Installing Tersio plugin dependencies', 'bun', ['install'], { cwd: pluginsDir, timeout: 180000 });
         }
         catch (e) {
-            console.log(`  [fail] Could not install ${PACKAGE_NAME} into plugins dir: ${e.message}`);
-            console.log(`  [hint] Manual: cd ~/.omp/plugins && npm install ${PACKAGE_NAME}@^${PACKAGE_VERSION} --save --no-audit --no-fund`);
+            sayTagged(`  [fail] Could not install ${PACKAGE_NAME} into plugins dir: ${e.message}`);
+            sayTagged(`  [hint] Manual: cd ~/.omp/plugins && npm install ${PACKAGE_NAME}@^${PACKAGE_VERSION} --save --no-audit --no-fund`);
             return false;
         }
     }
     const installedPkg = path.join(pluginsDir, 'node_modules', PACKAGE_NAME, 'package.json');
     if ((await readTextIfExists(installedPkg)) === null) {
-        console.log(`  [warn] ${PACKAGE_NAME} not found in plugins/node_modules after install`);
+        sayTagged(`  [warn] ${PACKAGE_NAME} not found in plugins/node_modules after install`);
         return false;
     }
     debug('tersio listed in OMP plugins');
@@ -136,7 +138,7 @@ function resolveRtkTriple() {
     const triple = rtkPlatformSpec()?.triple;
     if (triple)
         return triple;
-    console.log(`  [fail] Unsupported platform: ${process.platform}/${process.arch}`);
+    sayTagged(`  [fail] Unsupported platform: ${process.platform}/${process.arch}`);
     console.log('  [hint] Manual: https://github.com/rtk-ai/rtk/releases');
     return null;
 }
@@ -145,8 +147,8 @@ function findRtkAsset(release, triple) {
     const asset = assets.find((a) => a.name === `rtk-${triple}.zip` || a.name === `rtk-${triple}.tar.gz`);
     if (asset)
         return asset;
-    console.log(`  [fail] No rtk-${triple}.<zip|tar.gz> in release ${release.tag_name}`);
-    console.log(`  [hint] Available: ${assets.map((a) => a.name).filter((n) => n.startsWith('rtk-')).join(', ')}`);
+    sayTagged(`  [fail] No rtk-${triple}.<zip|tar.gz> in release ${release.tag_name}`);
+    sayTagged(`  [hint] Available: ${assets.map((a) => a.name).filter((n) => n.startsWith('rtk-')).join(', ')}`);
     return null;
 }
 async function downloadRtkChecksums(release) {
@@ -161,26 +163,30 @@ async function downloadRtkChecksums(release) {
         return null;
     }
 }
-async function verifyRtkArchive(archivePath, assetName, checksumsText, options = {}) {
-    if (!checksumsText) {
-        if (!options.quiet)
-            console.log('  [warn] No checksums.txt available — skipping verification');
-        return true;
-    }
+// Fails closed: a missing checksum is worse than a failed install, since an unverifiable RTK binary runs with the user's privileges. `--allow-unverified` opts out.
+async function verifyRtkArchive(archivePath, assetName, checksumsText) {
+    const unverified = (reason) => {
+        if (allowUnverified) {
+            sayTagged(`  [warn] ${reason} — installing anyway (--allow-unverified)`);
+            return true;
+        }
+        sayTagged(`  [fail] ${reason}`);
+        sayTagged('  [hint] RTK not installed. Retry with --allow-unverified to accept an unverified binary.');
+        return false;
+    };
+    if (!checksumsText)
+        return unverified(`No checksums.txt published for ${assetName}`);
     const expected = parseChecksum(checksumsText, assetName);
+    if (!expected)
+        return unverified(`checksums.txt has no entry for ${assetName}`);
     const actual = await sha256File(archivePath);
-    if (!expected) {
-        if (!options.quiet)
-            console.log(`  [warn] checksums.txt missing entry for ${assetName} — skipping verification`);
-        return true;
-    }
     if (actual === expected) {
         debug(`Checksum verified for ${assetName}`);
         return true;
     }
-    console.log(`  [fail] Checksum mismatch for ${assetName}`);
-    console.log(`  [fail] Expected: ${expected}`);
-    console.log(`  [fail] Got:      ${actual}`);
+    sayTagged(`  [fail] Checksum mismatch for ${assetName}`);
+    sayTagged(`  [fail] Expected: ${expected}`);
+    sayTagged(`  [fail] Got:      ${actual}`);
     // Caller finally removes the temp dir.
     return false;
 }
@@ -214,110 +220,119 @@ async function extractRtkArchive(archivePath, extractDir) {
         }
         catch (e) {
             debug(`tar xzf failed: ${shortError(e)}`);
-            console.log(`  [fail] tar could not extract ${path.basename(archivePath)}`);
+            sayTagged(`  [fail] tar could not extract ${path.basename(archivePath)}`);
             console.log('  [hint] Manual: https://github.com/rtk-ai/rtk/releases');
             return false;
         }
         return true;
     }
-    console.log(`  [fail] Unknown archive format: ${archivePath}`);
+    sayTagged(`  [fail] Unknown archive format: ${archivePath}`);
     return false;
 }
-// The binary is machine-wide and only OMP needs the wiring, so an install that
-// finds one present only rebinds. `tersio update` still refreshes it.
+// The binary is machine-wide; hosts without a hook only rebind. `tersio update` still refreshes it.
 async function stepRtk(binDir, options, target = 'omp') {
     const binDest = path.join(binDir, RTK_BINARY_NAME);
     const found = resolveRtkBinary();
+    const hostName = target === 'omp' ? 'OMP' : target === 'opencode' ? 'OpenCode' : 'pi';
     const bind = async (binary) => {
-        if (target !== 'omp')
-            return;
         if (!(await fileExists(binary))) {
-            console.log('  [skip] no rtk binary to wire — install rtk, then run: rtk init -g --agent omp');
+            console.log(`  [skip] no rtk binary to wire — install rtk, then run: rtk init -g ${target === 'opencode' ? '--opencode' : `--agent ${target}`}`);
             return;
         }
-        await wireRtkOmp(binary, options);
+        if (target === 'opencode')
+            await wireRtkOpencode(binary, options);
+        else if (target === 'pi')
+            await wireRtkPi(binary, options);
+        else
+            await wireRtkOmp(binary, options);
     };
     if (found && !applyUpdate) {
-        // The path only under --verbose: a plain run, and a dry run, stay free of
-        // real user paths.
+        // The path only under --verbose: a plain run, and a dry run, stay free of real user paths.
         if (!options.quiet) {
             const where = verbose ? ` (${found})` : '';
-            console.log(`  RTK — already installed${where}${target === 'omp' ? ', binding into OMP' : ', nothing to bind on pi'}`);
+            console.log(`  RTK — already installed${where}, binding into ${hostName}`);
         }
         await bind(found);
         return;
     }
     if (!options.quiet)
-        console.log(`  RTK — download binary and ${target === 'omp' ? 'wire into OMP' : 'put it on PATH'}`);
-    // A failed download must not skip wiring: a pre-existing binary serves the
-    // OMP hook just as well. Dry runs stay offline.
+        console.log(`  RTK — download binary and wire into ${hostName}`);
+    // A failed download must not skip wiring: a pre-existing binary serves the host hook just as well. Dry runs stay offline.
     if (options.dryRun) {
         if (verbose && !options.quiet)
-            console.log(`  [dry-run] would download rtk binary and install to ${binDest}`);
+            sayTagged(`  [dry-run] would download rtk binary and install to ${binDest}`);
         await bind(found ?? binDest);
         return;
     }
     try {
-        const release = await withInteractiveSpinner('Finding latest RTK release', () => fetchJson(RTK_RELEASE_API));
         const triple = resolveRtkTriple();
         if (!triple)
             return;
-        const asset = findRtkAsset(release, triple);
-        if (!asset)
-            return;
-        const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'omp-rtk-'));
-        try {
-            const archivePath = path.join(tmpDir, asset.name);
-            const checksumsText = await withInteractiveSpinner('Downloading RTK binary', async (update) => {
-                const [downloadedChecksums] = await Promise.all([
-                    downloadRtkChecksums(release),
-                    httpsDownload(asset.browser_download_url, archivePath),
-                ]);
-                update('Verifying RTK checksum');
-                return downloadedChecksums;
-            });
-            if (!await verifyRtkArchive(archivePath, asset.name, checksumsText, options))
+        // One task with streamed sub-steps: release lookup, download, checksum, extract, install. Non-TTY keeps the plain lines each step already prints.
+        await withInteractiveTask('Installing RTK', async (update) => {
+            const release = await fetchJson(RTK_RELEASE_API);
+            const asset = findRtkAsset(release, triple);
+            if (!asset) {
+                sayTagged(`  [fail] No rtk-${triple}.<zip|tar.gz> in release ${release.tag_name}`);
                 return;
-            const extractDir = path.join(tmpDir, 'extracted');
-            if (!await extractRtkArchive(archivePath, extractDir))
-                return;
-            const found = await findFile(extractDir, RTK_BINARY_NAME);
-            if (!found) {
-                console.log(`  [fail] Could not find ${RTK_BINARY_NAME} in extracted archive`);
-                return;
-            }
-            await fs.mkdir(path.dirname(binDest), { recursive: true });
-            await fs.copyFile(binDest, `${binDest}.bak`).catch(() => { });
-            await fs.copyFile(found, binDest);
-            if (!IS_WINDOWS) {
-                await fs.chmod(binDest, 0o755);
-                debug(`chmod 755 ${binDest}`);
             }
+            const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'omp-rtk-'));
             try {
-                await execP(binDest, ['--version'], { timeout: 30000, shell: false });
+                const archivePath = path.join(tmpDir, asset.name);
+                update(`Downloading ${asset.name}`);
+                const [checksumsText] = await Promise.all([
+                    downloadRtkChecksums(release),
+                    httpsDownload(asset.browser_download_url, archivePath),
+                ]);
+                update('Verifying checksum');
+                if (!await verifyRtkArchive(archivePath, asset.name, checksumsText)) {
+                    sayTagged('  [hint] RTK install skipped for this run');
+                    return;
+                }
+                update('Extracting');
+                const extractDir = path.join(tmpDir, 'extracted');
+                if (!await extractRtkArchive(archivePath, extractDir)) {
+                    sayTagged(`  [fail] Could not extract ${asset.name}`);
+                    return;
+                }
+                update('Installing binary');
+                const found = await findFile(extractDir, RTK_BINARY_NAME);
+                if (!found) {
+                    sayTagged(`  [fail] Could not find ${RTK_BINARY_NAME} in extracted archive`);
+                    return;
+                }
+                await fs.mkdir(path.dirname(binDest), { recursive: true });
+                await fs.copyFile(binDest, `${binDest}.bak`).catch(() => { });
+                await fs.copyFile(found, binDest);
+                if (!IS_WINDOWS) {
+                    await fs.chmod(binDest, 0o755);
+                    debug(`chmod 755 ${binDest}`);
+                }
+                try {
+                    await execP(binDest, ['--version'], { timeout: 30000, shell: false });
+                }
+                catch {
+                    sayTagged(`  [hint] Verify manually: ${binDest} --version`);
+                }
             }
-            catch {
-                console.log(`  [hint] Verify manually: ${binDest} --version`);
+            finally {
+                await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => { });
             }
-        }
-        finally {
-            await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => { });
-        }
+        });
     }
     catch (e) {
-        console.log(`  [fail] RTK: ${e.message}`);
+        sayTagged(`  [fail] RTK: ${e.message}`);
         console.log('  [hint] Manual: https://github.com/rtk-ai/rtk/releases');
     }
     // Wire rtk's tool_call extension: the binary alone never meters a session.
     await bind(binDest);
 }
-// Copy sources into the target extension dir. First entry is required; the
-// rest are optional companions.
+// Copy sources into the target extension dir. First entry is required; the rest are optional companions.
 async function copySources(extDir, files, skipLabel, options) {
     const src = await readTextIfExists(files[0][0]);
     if (!src) {
         if (!options.quiet && options.dryRun)
-            console.log(`  [skip] ${skipLabel} not found in repo`);
+            sayTagged(`  [skip] ${skipLabel} not found in repo`);
         return false;
     }
     await writeIfChanged(path.join(extDir, files[0][1]), src, options);
@@ -341,8 +356,7 @@ async function stepRtkSession(extDir, options) {
         console.log('  RTK session — install session mode');
     await copySources(extDir, filesUnder('rtk-session'), 'rtk-session/index.ts', options);
 }
-// One fetch serves the install; dry runs stay offline and preview the bundled
-// rule's destination.
+// One fetch serves the install; dry runs stay offline and preview the bundled rule's destination.
 async function fetchCavemanRule(options) {
     const bundled = await readTextIfExists(sourcePath('caveman-session/rule.md'));
     if (options.dryRun)
@@ -355,7 +369,7 @@ async function fetchCavemanRule(options) {
             debug(`Using bundled Caveman rule: ${e.message}`);
             return bundled;
         }
-        console.log(`  [warn] Could not fetch caveman rule: ${e.message}`);
+        sayTagged(`  [warn] Could not fetch caveman rule: ${e.message}`);
         return null;
     }
 }
@@ -371,7 +385,7 @@ async function stepCaveman(extDir, rule, options) {
     }
     else if (rule === null) {
         console.log('  [skip] Caveman rule.md unavailable');
-        console.log(`  [hint] Manual: ${CAVEMAN_REMOTE_RULE}`);
+        sayTagged(`  [hint] Manual: ${CAVEMAN_REMOTE_RULE}`);
     }
     else {
         await writeIfChanged(ruleDest, rule, options);
@@ -391,11 +405,72 @@ async function stepCombo(extDir, options) {
         console.log('  Combo — install preset switch');
     await copySources(extDir, filesUnder('combo-toggle'), 'combo-toggle/index.ts', options);
 }
+// The tree ships no node_modules, so the full ruleset rides along as files.
+const PONYTAIL_BUNDLE_FILES = [
+    'hooks/ponytail-instructions.js',
+    'hooks/ponytail-config.js',
+    'skills/ponytail/SKILL.md',
+];
+async function stepPonytailBundle(treeDir, options) {
+    const root = findHoistedPackage('@dietrichgebert/ponytail', path.dirname(fileURLToPath(import.meta.url)));
+    if (!root) {
+        if (!options.quiet)
+            console.log('  [skip] Ponytail package not found next to the CLI — OpenCode keeps the built-in text');
+        return;
+    }
+    if (!options.quiet)
+        console.log('  Ponytail — bundle the full ruleset for OpenCode');
+    for (const rel of PONYTAIL_BUNDLE_FILES) {
+        const src = path.join(root, ...rel.split('/'));
+        let text;
+        try {
+            text = await fs.readFile(src, 'utf8');
+        }
+        catch {
+            sayTagged(`  [fail] Ponytail bundle file missing: ${rel}`);
+            return;
+        }
+        await writeIfChanged(path.join(treeDir, 'ponytail-bundle', ...rel.split('/')), text, options);
+    }
+}
+// OpenCode loads imported .ts plugins from the config plugins dir, so a plain tree copy + one config entry is enough.
+async function stepOpencode(options) {
+    const dir = path.join(HOME, '.config', 'opencode', 'plugins', 'tersio');
+    if (!options.quiet)
+        console.log(`  OpenCode — write the plugin tree (${dir})`);
+    await stepSharedSessionState(dir, options);
+    await copySources(dir, filesUnder('rtk-session'), 'rtk-session/index.ts', options);
+    await copySources(dir, filesUnder('caveman-session'), 'caveman-session/index.ts', options);
+    await stepCombo(dir, options);
+    await copySources(dir, filesUnder('tersio-commands'), 'tersio-commands/index.ts', options);
+    await stepUpdater(dir, options);
+    await copySources(dir, filesUnder('opencode'), 'opencode/server.ts', options);
+    await stepPonytailBundle(dir, options);
+    // The loader resolves <pluginDir>/server.ts, so mirror the entry at the tree root.
+    await writeIfChanged(path.join(dir, 'server.ts'), OPENCODE_SERVER_SHIM, options);
+    if (!options.dryRun)
+        await fs.rm(path.join(dir, 'opencode', 'index.ts'), { force: true }).catch(() => { });
+    const configPath = path.join(HOME, '.config', 'opencode', 'opencode.json');
+    let config = {};
+    try {
+        config = JSON.parse((await readTextIfExists(configPath)) ?? '{}');
+    }
+    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))
+        withoutTersio.push(dir);
+    config.plugins = withoutTersio;
+    if (!options.dryRun)
+        await fs.mkdir(path.dirname(configPath), { recursive: true });
+    await writeIfChanged(configPath, `${JSON.stringify(config, null, 2)}\n`, options);
+}
 async function resolveProfile(opts = {}) {
     // Seed from the stored defaults so flag-less runs keep them.
     const profile = await storedProfile();
-    // One numbered prompt for all three modes, for a real terminal user with no
-    // default flags. Never for --apply-update, and never for a script.
+    // One numbered prompt for all three modes, for a real terminal user with no default flags. Never for --apply-update, and never for a script.
     if (tty() && !profileFlagsGiven && !applyUpdate) {
         const choice = await askInteractiveChoice('Session-start defaults — Combo preset', [
             { value: 'off', label: 'off' },
@@ -446,10 +521,11 @@ async function runCommandMenu() {
         console.log(`\n  [update] staying on ${PACKAGE_VERSION} — run ` + '`tersio update`' + ` anytime`);
     }
     updatePromptDone = true;
-    const choice = await askInteractiveChoice('Tersio — what next?', [
+    const choice = await askInteractiveChoice(`Tersio — what next?\n${formatCliStatus(storedProfileSync())}`, [
         { value: 'install', label: 'Install add-ons', hint: 'user scope + combo defaults' },
         { value: 'update', label: 'Update', hint: 'CLI version check, then refresh add-ons (RTK, Caveman rule, Ponytail)' },
         { value: 'doctor', label: 'Doctor', hint: 'verify the installation' },
+        { value: 'settings', label: 'Settings', hint: 'default combo mode, currency, diagnosis schedule' },
         { value: 'usage', label: 'Usage', hint: 'token usage and savings report' },
         { value: 'dashboard', label: 'Dashboard', hint: 'open the report in your browser' },
         { value: 'reset', label: 'Reset statistics', hint: 'clear statistics; transcripts and RTK history stay' },
@@ -464,8 +540,7 @@ async function runCommandMenu() {
             await runInstall();
             break;
         case 'update': {
-            // One bound flow: the version check already ran above, so report it
-            // and offer the refresh in the same breath — no second "update" quiz.
+            // One bound flow: the version check already ran above, so report it and offer the refresh in the same breath — no second "update" quiz.
             if (typeof newer === 'string')
                 console.log(`  tersio ${newer} available (installed ${PACKAGE_VERSION})`);
             else
@@ -503,6 +578,10 @@ async function runCommandMenu() {
             closeRL();
             break;
         }
+        case 'settings':
+            await runSettings();
+            closeRL();
+            break;
         case 'usage':
             await runUsage();
             closeRL();
@@ -521,16 +600,24 @@ async function runCommandMenu() {
             break;
     }
 }
-// Which host this run targets. --host pins it; a TTY user picks; scripts,
-// pipes, --yes, and --dry-run keep the pre-multi-host default of Oh My Pi.
+// Which host this run targets. --host pins it; a TTY user picks; scripts, pipes, --yes, and --dry-run keep the pre-multi-host default of Oh My Pi.
 let targetHost = 'omp';
+// Hosts the menu advertises but cannot install yet. Listed disabled so the roadmap is visible without offering a target that does nothing.
+const SOON_HOSTS = [
+    { value: 'claude', label: 'Claude Code', hint: 'Coming soon' },
+    { value: 'codex', label: 'Codex', hint: 'Coming soon' },
+];
 async function chooseHost(title, only) {
     const hosts = detectHosts().filter((host) => !only || only.includes(host.id));
-    const choice = await askInteractiveChoice(title, hosts.map((host) => ({
+    const options = hosts.map((host) => ({
         value: host.id,
         label: hostLabel(host),
         hint: hostHint(host),
-    })), targetHost);
+    }));
+    // A scoped menu (uninstall --host) lists only real hosts.
+    if (!only)
+        options.push(...SOON_HOSTS.map((h) => ({ ...h, disabled: true })));
+    const choice = await askInteractiveChoice(title, options, targetHost);
     if (choice.status !== 'selected') {
         closeRL();
         process.exit(130);
@@ -540,14 +627,13 @@ async function chooseHost(title, only) {
 function hostEntry(id) {
     return detectHosts().find((host) => host.id === id);
 }
-// pi auto-discovers `<agent-dir>/extensions/**/index.ts`, so this route writes
-// the same tree as OMP's and registers nothing.
-async function stepPiLayer(profile, options) {
+// pi auto-discovers `<agent-dir>/extensions/**/index.ts`, so this route writes the same tree as OMP's and registers nothing.
+async function stepPiLayer(options) {
     const agentDir = piAgentDir();
     const extDir = path.join(agentDir, 'extensions');
     const declared = piTersioSource(agentDir);
     if (declared)
-        console.log(`  [note] pi also has a tersio package (${declared}) — remove one, or both copies load: pi remove npm:${PACKAGE_NAME}`);
+        sayTagged(`  [note] pi also has a tersio package (${declared}) — remove one, or both copies load: pi remove npm:${PACKAGE_NAME}`);
     if (!options.quiet)
         console.log(`  Pi — write the extension tree (${extDir})`);
     const cavemanRule = await fetchCavemanRule(options);
@@ -570,7 +656,7 @@ async function stepPonytailForPi(agentDir, options) {
             return;
         }
         catch (e) {
-            console.log(`  [fail] pi install ponytail: ${shortError(e)}`);
+            sayTagged(`  [fail] pi install ponytail: ${shortError(e)}`);
         }
     }
     const skills = findHoistedPackage('@dietrichgebert/ponytail', path.dirname(fileURLToPath(import.meta.url)), 'skills');
@@ -582,7 +668,7 @@ async function stepPonytailForPi(agentDir, options) {
     const dest = path.join(agentDir, 'skills');
     if (options.dryRun) {
         if (verbose && !options.quiet)
-            console.log(`  [dry-run] would copy Ponytail skills to ${dest}`);
+            sayTagged(`  [dry-run] would copy Ponytail skills to ${dest}`);
         return;
     }
     for (const entry of await fs.readdir(skills, { withFileTypes: true })) {
@@ -592,12 +678,11 @@ async function stepPonytailForPi(agentDir, options) {
         await fs.rm(to, { recursive: true, force: true });
         await fs.cp(path.join(skills, entry.name), to, { recursive: true });
         if (!options.quiet)
-            console.log(`  [write] skill ${entry.name} → ${to}`);
+            sayTagged(`  [write] skill ${entry.name} → ${to}`);
     }
 }
 async function runInstall() {
-    // Without this guard a picked command re-enters here with command === null
-    // and loops straight back into the picker.
+    // Without this guard a picked command re-enters here with command === null and loops straight back into the picker.
     if (command === null && tty() && !yes && !updatePromptDone) {
         await runCommandMenu();
         return;
@@ -616,7 +701,6 @@ async function runInstall() {
     else if (tty() && !yes && !dryRun && !applyUpdate && command !== 'uninstall') {
         targetHost = await chooseHost('Install Tersio into which agent?');
     }
-    const host = hostEntry(targetHost);
     // apply-update stays silent: the parent printed the plan.
     const quiet = applyUpdate;
     if (!quiet)
@@ -630,8 +714,7 @@ async function runInstall() {
     if (tty() && !applyUpdate && command !== 'uninstall') {
         const newer = await checkForUpdate();
         if (typeof newer === 'string') {
-            // Update pending: offer it here instead of burying it above the install
-            // prompts. Yes runs the full update and stops.
+            // Update pending: offer it here instead of burying it above the install prompts. Yes runs the full update and stops.
             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) {
@@ -656,6 +739,25 @@ async function runInstall() {
     const userExtDir = path.join(userDir, 'extensions');
     // apply-update refreshes every add-on like a reinstall.
     const installOptions = { dryRun, verbose, yes, reinstall: applyUpdate, quiet };
+    // Point of no return: disk writes start here; pipes stay unattended.
+    if (!yes && !dryRun && !applyUpdate && tty()) {
+        const target = hostEntry(targetHost);
+        const where = targetHost === 'pi'
+            ? path.join(piAgentDir(), 'extensions')
+            : targetHost === 'opencode'
+                ? path.join(HOME, '.config', 'opencode', 'plugins', 'tersio')
+                : path.join(OMP_AGENT_DIR, 'extensions');
+        console.log(`\nWill install into ${target.label}:`);
+        console.log(`  ${where}`);
+        console.log('  caveman · rtk · ponytail session modes');
+        console.log(`  session defaults → ${tersioSettingsFile()}`);
+        const go = await askInteractiveConfirm(`Install Tersio into ${target.label}?`);
+        if (go.status !== 'confirmed' || !go.value) {
+            closeRL();
+            console.log('\nAborted. Nothing was changed.');
+            return;
+        }
+    }
     try {
         const v = (await execP(OMP_BIN, ['--version'])).stdout.trim();
         if (verbose && !quiet)
@@ -672,11 +774,22 @@ async function runInstall() {
         }
         catch (e) {
             failures.push(label);
-            console.log(`  [fail] ${label}: ${shortError(e)}`);
+            sayTagged(`  [fail] ${label}: ${shortError(e)}`);
         }
     };
+    if (targetHost === 'opencode') {
+        await capture('opencode tree', () => stepOpencode(installOptions));
+        await capture('rtk', () => stepRtk(BUN_BIN_DIR, installOptions, 'opencode'));
+        await capture('settings', () => writePluginSettings(profile, installOptions));
+        if (failures.length > 0)
+            console.log(`\nDone with ${failures.length} failure(s) — see [fail] lines above.`);
+        else
+            console.log('\nDone — restart OpenCode, then /combo balanced.');
+        closeRL();
+        return;
+    }
     if (targetHost === 'pi') {
-        await capture('pi tree', () => stepPiLayer(profile, installOptions));
+        await capture('pi tree', () => stepPiLayer(installOptions));
         await capture('rtk', () => stepRtk(BUN_BIN_DIR, installOptions, 'pi'));
         await capture('settings', () => writePluginSettings(profile, installOptions));
         if (failures.length > 0)
@@ -708,4 +821,4 @@ async function runInstall() {
     }
     closeRL();
 }
-export { runInstall };
+export { runInstall, verifyRtkArchive };