thoth-agents 0.11.0 → 0.12.0

package/dist/cli/config-io.d.ts

@@ -19,10 +19,10 @@ export declare function addPluginToOpenCodeConfig(pluginVersion: string): Promis
 export interface OpenCodeMainConfigUpdate {
     ensurePlugin?: boolean;
     pluginVersion?: string;
-    disableDefaults?: boolean;
 }
+export declare function pluginEntries(value: unknown): unknown[];
+export declare function isManagedOpenCodePlugin(entry: unknown): boolean;
 export declare function updateOpenCodeMainConfig(update: OpenCodeMainConfigUpdate): ConfigMergeResult;
 export declare function writeLiteConfig(installConfig: InstallConfig, targetPath?: string): ConfigMergeResult;
-export declare function disableDefaultAgents(): ConfigMergeResult;
 export declare function canModifyOpenCodeConfig(): boolean;
 export declare function detectCurrentConfig(): DetectedConfig;

package/dist/cli/index.js

@@ -1,13 +1,11 @@
 #!/usr/bin/env node
 import {
-  getOpenCodePath,
-  getOpenCodeVersion,
-  isOpenCodeInstalled,
   opencodeAdapter
-} from "../chunk-HACUJFKI.js";
+} from "../chunk-QOA2AETX.js";
 import {
   CODEX_PLUGIN_ID,
   CODEX_ROLE_NAMES,
+  OPENCODE_VERSION_REQUIREMENT,
   REQUIRED_SKILLS,
   SUPPORTED_OPERATION_HARNESSES,
   applyClaudeCodePlan,
@@ -52,16 +50,22 @@ import {
   getClaudeCodeStatus,
   getCodexModelRoles,
   getCodexStatus,
+  getLegacyOpenCodeSkillBackupRoot,
   getModelOptions,
   getOpenCodeModelRoles,
+  getOpenCodePath,
   getOpenCodeStatus,
+  getOpenCodeVersion,
   getOperationHarness,
   getPiModelRoles,
   getPiStatus,
   getRequiredSkillInstallCommand,
+  inspectLegacyOpenCodeSkills,
   inspectPiPackageSkills,
   installRequiredSkill,
   isMigratableLegacyRole,
+  isOpenCodeInstalled,
+  isSupportedOpenCodeVersion,
   listOperationHarnesses,
   normalizeEffortSelection,
   parseCodexToml,
@@ -76,11 +80,11 @@ import {
   safeAtomicWriteFileSync,
   scalarLocation,
   syncOpenCodeOwnedSkills
-} from "../chunk-I5TXGNSG.js";
-import "../chunk-62L3ORXN.js";
+} from "../chunk-SEF6PFM6.js";
+import "../chunk-MIDGZE34.js";
 import {
   piAdapter
-} from "../chunk-5WPP6IY7.js";
+} from "../chunk-7F33WUSD.js";
 import {
   ALL_AGENT_NAMES,
   detectCurrentConfig,
@@ -91,7 +95,7 @@ import {
   resolveExecutingPackageVersion,
   updateOpenCodeMainConfig,
   writeLiteConfig
-} from "../chunk-DNPKVFOB.js";
+} from "../chunk-NY2IPJ7V.js";
 
 // src/cli/index.ts
 import { pathToFileURL } from "url";
@@ -577,6 +581,34 @@ import { existsSync } from "fs";
 import { homedir } from "os";
 import { join as join2 } from "path";
 import { cwd } from "process";
+
+// src/cli/opencode-skill-consent.ts
+import { createInterface as createInterface2 } from "readline/promises";
+async function requestOpenCodeSkillMoveConsent(options) {
+  if (options.dryRun) return false;
+  if (options.moveLegacyOpenCodeSkills) return true;
+  if (!isInteractiveRuntime(detectRuntimeContext())) return false;
+  const copies = inspectLegacyOpenCodeSkills(options.homeDir);
+  if (!copies.length) return false;
+  console.log(
+    copies.map(({ sourcePath }) => `Legacy skill: ${sourcePath}`).join("\n")
+  );
+  const prompt = createInterface2({
+    input: process.stdin,
+    output: process.stdout
+  });
+  try {
+    return /^(y|yes)$/i.test(
+      (await prompt.question(
+        `Move these shadowing copies to a new backup under ${getLegacyOpenCodeSkillBackupRoot(options.homeDir)}? [y/N] `
+      )).trim()
+    );
+  } finally {
+    prompt.close();
+  }
+}
+
+// src/cli/install.ts
 var GREEN = "\x1B[32m";
 var BLUE = "\x1B[34m";
 var YELLOW = "\x1B[33m";
@@ -617,7 +649,7 @@ function printWarning(message) {
 async function checkOpenCodeInstalled() {
   const installed = await isOpenCodeInstalled();
   if (!installed) {
-    printError("OpenCode is not installed on this system.");
+    printError(OPENCODE_VERSION_REQUIREMENT);
     printInfo("Install it with:");
     console.log(
       `     ${BLUE}curl -fsSL https://opencode.ai/install | bash${RESET}`
@@ -629,6 +661,12 @@ async function checkOpenCodeInstalled() {
     return { ok: false };
   }
   const version = await getOpenCodeVersion();
+  if (!isSupportedOpenCodeVersion(version)) {
+    printError(
+      `${OPENCODE_VERSION_REQUIREMENT} Detected: ${version ?? "unavailable"}.`
+    );
+    return { ok: false };
+  }
   const path = getOpenCodePath();
   const detectedVersion = version ?? "";
   const pathInfo = path ? ` (${DIM}${path}${RESET})` : "";
@@ -650,7 +688,7 @@ function formatConfigSummary(dryRun) {
   lines.push(`${BOLD}Configuration Summary${RESET}`);
   lines.push("");
   lines.push(`  ${BOLD}Preset:${RESET} ${BLUE}openai${RESET}`);
-  lines.push(`  ${SYMBOLS.check} Seven-role adaptive thoth-agents roster`);
+  lines.push(`  ${SYMBOLS.check} Six-role adaptive thoth-agents roster`);
   lines.push(`  ${SYMBOLS.check} OpenAI models by default`);
   lines.push(
     `  ${SYMBOLS.check} Proportional SDD and ID-named substantial-change records`
@@ -661,27 +699,31 @@ function formatConfigSummary(dryRun) {
   lines.push(
     `  ${DIM}\u25CB thoth-mem remains the owner of hooks, MCP, skill, lifecycle, persistence, receipts, and recovery.${RESET}`
   );
-  lines.push(`  ${SYMBOLS.check} Global thoth-owned OpenCode skills`);
+  lines.push(`  ${SYMBOLS.check} Package-provided thoth-owned OpenCode skills`);
   lines.push(`  ${SYMBOLS.check} Required external skills for this harness`);
   return lines.join("\n");
 }
 function installOwnedSkillsForOpenCode(dryRun, dependencies) {
   const result = syncOpenCodeOwnedSkills({
     dryRun,
+    moveLegacyOpenCodeSkills: dependencies.moveLegacyOpenCodeSkills,
     homeDir: dependencies.homeDir ?? homedir(),
     packageRoot: dependencies.opencodeOwnedSkillPackageRoot
   });
   for (const skill of result.skills) {
-    printInfo(`  - ${skill.name}: ${skill.destinationPath}`);
+    printInfo(`  - ${skill.name}: ${skill.sourcePath}`);
+  }
+  for (const notice of result.notices ?? []) {
+    printInfo(notice);
   }
   if (!result.success) {
     printError(
-      `Failed to synchronize global thoth-owned OpenCode skills: ${result.error ?? "unknown error"}`
+      `Failed to inspect package-provided thoth-owned OpenCode skills: ${result.error ?? "unknown error"}`
     );
     return false;
   }
   printSuccess(
-    dryRun ? "Global thoth-owned OpenCode skills planned" : "Global thoth-owned OpenCode skills synchronized"
+    dryRun ? "Package-provided thoth-owned OpenCode skills planned" : "Package-provided thoth-owned OpenCode skills available"
   );
   return true;
 }
@@ -719,14 +761,12 @@ function installRequiredSkillsForHarness(harness, dryRun, homeDir = homedir()) {
 }
 function printThothMemSetupResult(result, dryRun) {
   printInfo(`Provider command: ${result.command} ${result.args.join(" ")}`);
-  for (const step of result.steps) {
-    printInfo(`thoth-mem: ${step.name} [${step.outcome}]`);
-  }
+  for (const action of result.actions) printInfo(`thoth-mem action: ${action}`);
+  for (const warning of result.warnings)
+    printWarning(`thoth-mem warning: ${warning}`);
+  if (result.restartRequired) printWarning("thoth-mem: restart required");
   for (const diagnostic of result.diagnostics) printInfo(diagnostic);
   if (result.receipt) printInfo(`thoth-mem receipt: ${result.receipt}`);
-  for (const action of result.manualActions) {
-    printWarning(`thoth-mem manual action: ${action}`);
-  }
   if (!result.success) {
     printError(`thoth-mem setup is incomplete: ${result.status}`);
     if (result.error) printError(result.error);
@@ -800,7 +840,7 @@ async function runInstall(config, dependencies, pluginVersion) {
   printStep(
     step++,
     totalSteps,
-    "Configuring the thoth-agents plugin and OpenCode default agents..."
+    "Configuring the pinned thoth-agents plugin (OpenCode 2.2.6+)..."
   );
   if (config.dryRun) {
     printInfo("Dry run mode - skipping main config update");
@@ -808,8 +848,7 @@ async function runInstall(config, dependencies, pluginVersion) {
     const updateMainConfig = dependencies.updateOpenCodeMainConfig ?? updateOpenCodeMainConfig;
     const mainConfigResult = updateMainConfig({
       ensurePlugin: true,
-      pluginVersion,
-      disableDefaults: true
+      pluginVersion
     });
     if (!handleStepResult(mainConfigResult, "Main config updated")) return 1;
   }
@@ -842,8 +881,16 @@ ${JSON.stringify(liteConfig, null, 2)}
   printStep(
     step++,
     totalSteps,
-    "Synchronizing global thoth-owned OpenCode skills..."
+    "Inspecting package-provided thoth-owned OpenCode skills..."
   );
+  dependencies = {
+    ...dependencies,
+    moveLegacyOpenCodeSkills: await requestOpenCodeSkillMoveConsent({
+      dryRun: config.dryRun,
+      homeDir: dependencies.homeDir,
+      moveLegacyOpenCodeSkills: dependencies.moveLegacyOpenCodeSkills
+    })
+  };
   if (!installOwnedSkillsForOpenCode(config.dryRun, dependencies)) return 1;
   printStep(step++, totalSteps, "Installing required external skills...");
   if (!installRequiredSkillsForHarness(
@@ -875,7 +922,7 @@ ${JSON.stringify(liteConfig, null, 2)}
   const modelsInfo = "Default configuration uses OpenAI models.";
   console.log(`${BOLD}${modelsInfo}${RESET}`);
   console.log(
-    `  ${DIM}Includes the seven-role adaptive roster, native parallel delegation, and proportional SDD governance.${RESET}`
+    `  ${DIM}Includes the six-role adaptive roster, native parallel delegation, and proportional SDD governance.${RESET}`
   );
   return 0;
 }
@@ -965,7 +1012,6 @@ async function runPiInstall(config, dependencies, packageVersion, executingPacka
 function createInstallConfig(args) {
   return {
     agent: args.agent ?? "opencode",
-    hasTmux: args.tmux === "yes",
     ...args.localPackageRoot ? { localPackageRoot: args.localPackageRoot } : {},
     ...args.localPiRuntimeRoot ? { localPiRuntimeRoot: args.localPiRuntimeRoot } : {},
     dryRun: args.dryRun,
@@ -973,6 +1019,10 @@ function createInstallConfig(args) {
   };
 }
 async function install(args, dependencies = {}) {
+  dependencies = {
+    ...dependencies,
+    moveLegacyOpenCodeSkills: args.moveLegacyOpenCodeSkills
+  };
   const config = createInstallConfig(args);
   const resolvePackageVersion = dependencies.resolveExecutingPackageVersion ?? resolveExecutingPackageVersion;
   const packageVersion = resolvePackageVersion();
@@ -1244,11 +1294,12 @@ Commands:
   model                 Preview role model/provider settings
 
 Options:
-  --tmux=yes|no          Enable tmux integration (yes/no)
   --no-tui               Non-interactive mode
   --dry-run              Simulate install without writing files
   --apply                Apply a reviewed update, sync, or model plan
   --trust-hooks          Consent to Codex plugin hooks running outside the sandbox (install/update)
+  --move-legacy-opencode-skills
+                         Confirm backup move of shadowing owned OpenCode skills (install/update)
   --reset                Repair managed installer-owned targets
   --agent=opencode|codex|claude|pi
                          Select OpenCode plugin install (default), Codex/Claude setup, or complete Pi-native setup
@@ -1265,7 +1316,7 @@ Generate options:
 
 OpenCode plugin config and the npm binary are separate surfaces.
 OpenCode loads the plugin with config such as:
-  plugin: ["${exactPluginEntry}"]
+  plugins: ["${exactPluginEntry}"]
 
 That plugin entry does not create a global thoth-agents command.
 Run this CLI through a global install, npx, or pnpm dlx.
@@ -1276,9 +1327,11 @@ The official record is $XDG_CONFIG_HOME/thoth-agents/install-state.json,
 or ~/.config/thoth-agents/install-state.json when XDG_CONFIG_HOME is unset.
 Codex and Claude marketplace versions remain native-manager-owned and do not prove
 that CLI-managed agents, skills, configuration, or provider setup are aligned.
-Runtime release checks notify only; use the latest CLI install or interactive CLI Update.
+Use the latest CLI install or interactive CLI Update to change the pinned release.
 
-OpenCode install configures the adaptive six-role roster and native task delegation.
+OpenCode 2.2.6 or later is required before applying configuration.
+OpenCode install configures the adaptive six-role roster and native subagent delegation.
+The plugin provides its five owned skills from its installed package; no global copies are written.
 Provider capability is external and reported only from caller-supplied evidence.
 
 External required skills are installed for every harness:
@@ -1298,7 +1351,7 @@ Examples:
   pnpm dlx thoth-agents@latest install --agent=claude --dry-run
   pnpm dlx thoth-agents@latest install --agent=pi --dry-run
   node dist/cli/index.js install --agent=pi --local-package-root="<absolute-path>"
-  pnpm dlx thoth-agents install --no-tui --tmux=no
+  pnpm dlx thoth-agents install --no-tui
   pnpm dlx thoth-agents install --dry-run
   pnpm dlx thoth-agents install --reset
   pnpm dlx thoth-agents generate --harness=codex --dry-run
@@ -1480,6 +1533,10 @@ async function runOperationCommand(command, args, services) {
       buildOperationPlan(command, args, {
         ...services.operationContext(),
         trustHooks,
+        moveLegacyOpenCodeSkills: selectedHarness(args) === "opencode" ? await requestOpenCodeSkillMoveConsent({
+          moveLegacyOpenCodeSkills: args.moveLegacyOpenCodeSkills,
+          dryRun: !args.apply || args.dryRun
+        }) : false,
         replaceLegacyAgents: args.replaceLegacyAgents
       }),
       args,
@@ -1554,12 +1611,6 @@ var operationCommands = /* @__PURE__ */ new Set([
   "sync",
   "model"
 ]);
-function parseBooleanArg(name, value) {
-  if (value !== "yes" && value !== "no") {
-    throw new Error(`${name} must be yes or no.`);
-  }
-  return value;
-}
 function parseOperationHarness(value) {
   if (value !== "opencode" && value !== "codex" && value !== "claude" && value !== "pi") {
     throw new Error(
@@ -1636,6 +1687,8 @@ function parseOperationArgs(args) {
       result.apply = true;
     } else if (arg === "--replace-legacy-agents") {
       result.replaceLegacyAgents = true;
+    } else if (arg === "--move-legacy-opencode-skills") {
+      result.moveLegacyOpenCodeSkills = true;
     } else if (arg === "--trust-hooks") {
       result.trustHooks = true;
     } else if (arg === "--dry-run") {
@@ -1682,8 +1735,8 @@ function parseInstallArgs(args) {
     if (arg === void 0) break;
     if (arg === "--no-tui") {
       result.tui = false;
-    } else if (arg.startsWith("--tmux=")) {
-      result.tmux = parseBooleanArg("--tmux", arg.split("=")[1] ?? "");
+    } else if (arg === "--move-legacy-opencode-skills") {
+      result.moveLegacyOpenCodeSkills = true;
     } else if (arg === "--trust-hooks") {
       result.trustHooks = true;
     } else if (arg === "--dry-run") {

package/dist/cli/install.d.ts

@@ -9,6 +9,7 @@ import type { ThothMemSetupOptions, ThothMemSetupResult } from './thoth-mem-inst
 import type { InstallArgs, InstallConfig } from './types';
 export interface InstallDependencies {
     homeDir?: string;
+    moveLegacyOpenCodeSkills?: boolean;
     opencodeOwnedSkillPackageRoot?: string;
     runThothMemSetup?: (options: ThothMemSetupOptions) => ThothMemSetupResult;
     resolveExecutingPackageVersion?: () => ExecutingPackageVersionResult;

package/dist/cli/opencode-skill-consent.d.ts

@@ -0,0 +1,5 @@
+export declare function requestOpenCodeSkillMoveConsent(options: {
+    moveLegacyOpenCodeSkills?: boolean;
+    dryRun?: boolean;
+    homeDir?: string;
+}): Promise<boolean>;

package/dist/cli/operations/opencode.d.ts

@@ -8,6 +8,7 @@ import { installRequiredSkill } from '../skills';
 import type { ConfigMergeResult } from '../types';
 import type { HarnessAction, HarnessStatusReport, ModelConfigInput, OperationApplyResult, OperationContext, OperationPlan } from './types';
 export interface OpenCodeOperationContext extends OperationContext {
+    getOpenCodeVersion?: () => string | null;
     resolveExecutingPackageVersion?: () => ExecutingPackageVersionResult;
     updateOpenCodeMainConfig?: (update: OpenCodeMainConfigUpdate) => ConfigMergeResult;
     writeLiteConfig?: typeof writeLiteConfig;
@@ -21,7 +22,7 @@ export declare const opencodeOperationAdapter: {
     readonly id: "opencode";
     readonly displayName: "OpenCode";
     readonly available: true;
-    readonly description: "OpenCode plugin and configuration surfaces.";
+    readonly description: "OpenCode 2.2.6 or later: pinned plugin and configuration surfaces.";
     readonly actions: HarnessAction[];
 };
 export declare function getOpenCodeStatus(context?: OperationContext, evidence?: ProviderEvidenceInput): HarnessStatusReport;

package/dist/cli/operations/types.d.ts

@@ -136,6 +136,7 @@ export interface OperationApplyResult {
     disclaimers: OperationDisclaimer[];
 }
 export interface OperationContext {
+    moveLegacyOpenCodeSkills?: boolean;
     cwd: string;
     env?: Readonly<Record<string, string | undefined>>;
 }

package/dist/cli/owned-skills.d.ts

@@ -1,6 +1,7 @@
 import { type ThothOwnedSkillName } from '../harness/core/owned-skills';
 export interface OpenCodeOwnedSkillSyncOptions {
     dryRun?: boolean;
+    moveLegacyOpenCodeSkills?: boolean;
     homeDir?: string;
     packageRoot?: string;
 }
@@ -13,6 +14,9 @@ export interface OpenCodeOwnedSkillSyncResult {
     success: boolean;
     status: 'planned' | 'installed' | 'failed';
     skills: OpenCodeOwnedSkillSyncEntry[];
+    notices?: string[];
+    backupRoot?: string;
+    legacyMoves?: LegacyOpenCodeSkillMove[];
     error?: string;
 }
 export interface PiPackageSkillInspectionResult {
@@ -31,6 +35,18 @@ export declare function getOpenCodeOwnedSkillEntries(options?: Pick<OpenCodeOwne
 export declare function getPiOwnedSkillEntries(options: {
     packageRoot: string;
 }): OpenCodeOwnedSkillSyncEntry[];
+export interface LegacyOpenCodeSkillMove {
+    sourcePath: string;
+    destinationPath: string;
+    status: 'planned' | 'moved' | 'failed';
+}
+export declare function getLegacyOpenCodeSkillBackupRoot(homeDir?: string): string;
+export declare function inspectLegacyOpenCodeSkills(homeDir?: string): Array<{
+    name: ThothOwnedSkillName;
+    sourcePath: string;
+    label: string;
+}>;
+export declare function legacyOpenCodeSkillNotice(path: string): string;
 export declare function syncOpenCodeOwnedSkills(options?: OpenCodeOwnedSkillSyncOptions): OpenCodeOwnedSkillSyncResult;
 export declare function inspectPiPackageSkills(options: {
     packageRoot: string;

package/dist/cli/paths.d.ts

@@ -6,7 +6,7 @@
  * 2. XDG_CONFIG_HOME/opencode
  * 3. ~/.config/opencode
  */
-export declare function getConfigDir(): string;
+export declare function getConfigDir(homeDir?: string): string;
 export declare function getOpenCodeConfigPaths(): string[];
 export declare function getConfigJson(): string;
 export declare function getConfigJsonc(): string;

package/dist/cli/providers.d.ts

@@ -7,5 +7,5 @@ type ModelMapping = {
 export declare const MODEL_MAPPINGS: {
     readonly openai: Record<string, ModelMapping>;
 };
-export declare function generateLiteConfig(installConfig: InstallConfig): Record<string, unknown>;
+export declare function generateLiteConfig(_installConfig: InstallConfig): Record<string, unknown>;
 export {};

package/dist/cli/system.d.ts

@@ -9,7 +9,9 @@ type OpenCodeVersionInvocation = {
 export declare function getOpenCodeVersionInvocation(opencodePath: string, platform?: typeof process.platform): OpenCodeVersionInvocation;
 export declare function resolveOpenCodePath(): string;
 export declare function isOpenCodeInstalled(): Promise<boolean>;
-export declare function isTmuxInstalled(): Promise<boolean>;
+export declare const OPENCODE_VERSION_REQUIREMENT = "OpenCode 2.2.6 or later is required; install or upgrade OpenCode before applying configuration.";
+export declare function isSupportedOpenCodeVersion(output: string | null): boolean;
+export declare function getOpenCodeVersionSync(): string | null;
 export declare function getOpenCodeVersion(): Promise<string | null>;
 export declare function getOpenCodePath(): string | null;
 export declare function fetchLatestVersion(packageName: string): Promise<string | null>;

package/dist/cli/thoth-mem-install.d.ts

@@ -1,12 +1,8 @@
-import { type NpxCommand, type NpxCommandOptions } from './npx-command';
+import type { NpxCommand, NpxCommandOptions } from './npx-command';
 import type { InstallAgent } from './types';
+export declare const THOTH_MEM_PACKAGE_SPEC = "thoth-mem@>=0.7.0";
 export declare const THOTH_MEM_SETUP_TIMEOUT_MS = 120000;
-export type ThothMemSetupStatus = 'complete' | 'failed' | 'partial' | 'requires_user_action';
-export type ThothMemSetupOutcome = 'planned' | 'skipped' | 'confirmed' | 'failed' | 'unavailable';
-export interface ThothMemSetupStep {
-    name: string;
-    outcome: ThothMemSetupOutcome;
-}
+export type ThothMemSetupStatus = 'planned' | 'complete' | 'unsupported' | 'requires-user-action';
 export interface ThothMemCommandResult {
     exitCode: number | null;
     stdout: string;
@@ -29,15 +25,19 @@ export interface ThothMemSetupResult {
     status: ThothMemSetupStatus | 'invalid';
     changed: boolean;
     harness: InstallAgent;
-    target?: string;
-    steps: ThothMemSetupStep[];
+    actions: string[];
+    warnings: string[];
+    restartRequired?: boolean;
     diagnostics: string[];
-    manualActions: string[];
     receipt: string | null;
     command: string;
     args: string[];
     exitCode: number | null;
     error?: string;
 }
+export declare function executeThothMemCommand(command: string, args: readonly string[], options: {
+    cwd?: string;
+    timeoutMs: number;
+}): ThothMemCommandResult;
 export declare function getThothMemSetupCommand(harness: InstallAgent, dryRun: boolean, options?: NpxCommandOptions): NpxCommand;
 export declare function runThothMemSetup(options: ThothMemSetupOptions): ThothMemSetupResult;

package/dist/cli/tui/index.js

@@ -2,10 +2,10 @@ import {
   defaultTuiOperations,
   effortChoicesForModel,
   listOperationHarnesses
-} from "../../chunk-I5TXGNSG.js";
-import "../../chunk-62L3ORXN.js";
-import "../../chunk-5WPP6IY7.js";
-import "../../chunk-DNPKVFOB.js";
+} from "../../chunk-SEF6PFM6.js";
+import "../../chunk-MIDGZE34.js";
+import "../../chunk-7F33WUSD.js";
+import "../../chunk-NY2IPJ7V.js";
 
 // src/cli/tui/index.tsx
 import { render } from "ink";
@@ -974,7 +974,7 @@ function App({
       setView("harness");
     } else if (view === "action") {
       setView("root");
-    } else if (view === "preview" || view === "hookTrust") {
+    } else if (view === "preview" || view === "hookTrust" || view === "skillMove") {
       setView(previewBackView);
     } else if (view === "modelRoles") {
       setView("manageHarness");
@@ -1003,6 +1003,12 @@ function App({
       setView("hookTrust");
       return;
     }
+    if (harness === "opencode" && (action === "install" || action === "update") && (operations.legacyOpenCodeSkillCopies?.().length ?? 0) > 0) {
+      setPendingHookAction(action);
+      setHookTrustSelected(0);
+      setView("skillMove");
+      return;
+    }
     setPlan(operations.plan(harness, action));
     setView("preview");
   }
@@ -1194,6 +1200,19 @@ function App({
       if (view !== "root") goBack();
       return;
     }
+    if (view === "skillMove") {
+      if (key.upArrow || key.downArrow || input === "j" || input === "k")
+        setHookTrustSelected((current) => current === 0 ? 1 : 0);
+      if (key.return) {
+        setPlan(
+          operations.plan("opencode", pendingHookAction, {
+            moveLegacyOpenCodeSkills: hookTrustSelected === 1
+          })
+        );
+        setView("preview");
+      }
+      return;
+    }
     if (view === "hookTrust") {
       if (key.upArrow || key.downArrow || input === "j" || input === "k")
         setHookTrustSelected((current) => current === 0 ? 1 : 0);
@@ -1505,6 +1524,35 @@ function App({
       )
     ] });
   }
+  if (view === "skillMove") {
+    return /* @__PURE__ */ jsxs7(Box8, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx8(
+        Header,
+        {
+          title: "Move legacy OpenCode skills?",
+          subtitle: "These copies shadow the packaged skills. Backup only; never delete."
+        }
+      ),
+      /* @__PURE__ */ jsx8(
+        Menu,
+        {
+          items: [
+            {
+              id: "no",
+              label: "No \u2014 leave copies unchanged",
+              detail: "Copies will continue to shadow packaged skills."
+            },
+            {
+              id: "yes",
+              label: "Yes \u2014 move copies to a new hidden backup",
+              detail: "Keep the original contents in a reversible backup."
+            }
+          ],
+          selected: hookTrustSelected
+        }
+      )
+    ] });
+  }
   if (view === "hookTrust") {
     return /* @__PURE__ */ jsxs7(Box8, { flexDirection: "column", children: [
       /* @__PURE__ */ jsx8(

package/dist/cli/tui/operations.d.ts

@@ -5,12 +5,14 @@ import type { HarnessStatusReport, ModelRoleInput, OperationApplyResult, Operati
 import { type ModelOption } from './model-catalog';
 export type TuiAction = 'status' | 'list' | 'install' | 'update' | 'sync' | 'model';
 export interface TuiOperations {
+    legacyOpenCodeSkillCopies?: () => string[];
     status(harness: HarnessId, evidence?: ProviderEvidenceInput): HarnessStatusReport;
     providerCapability?(harness: HarnessId): Promise<ProviderCapabilityEvidence>;
     modelRoles(harness: HarnessId): ModelRoleInput[];
     modelOptions(harness: HarnessId): Promise<ModelOption[]>;
     plan(harness: HarnessId, action: Exclude<TuiAction, 'status' | 'list'>, options?: {
         trustHooks?: boolean;
+        moveLegacyOpenCodeSkills?: boolean;
     }): OperationPlan;
     modelPlan(harness: HarnessId, roles: ModelRoleInput[]): OperationPlan;
     restoreModelPlan(harness: HarnessId, options: readonly ModelOption[]): OperationPlan;

package/dist/cli/types.d.ts

@@ -1,11 +1,10 @@
-export type BooleanArg = 'yes' | 'no';
 export type InstallAgent = 'opencode' | 'codex' | 'claude' | 'pi';
 export interface InstallArgs {
+    moveLegacyOpenCodeSkills?: boolean;
     tui: boolean;
     agent?: InstallAgent;
     localPackageRoot?: string;
     localPiRuntimeRoot?: string;
-    tmux?: BooleanArg;
     dryRun?: boolean;
     trustHooks?: boolean;
     reset?: boolean;
@@ -23,6 +22,7 @@ export interface CliModelRoleArg {
     effort?: EffortSelection;
 }
 export interface OperationArgs {
+    moveLegacyOpenCodeSkills?: boolean;
     replaceLegacyAgents?: boolean;
     harness?: OperationHarnessArg;
     all?: boolean;
@@ -57,7 +57,6 @@ export interface OpenCodeConfig {
 }
 export interface InstallConfig {
     agent: InstallAgent;
-    hasTmux: boolean;
     localPackageRoot?: string;
     localPiRuntimeRoot?: string;
     dryRun?: boolean;
@@ -71,6 +70,5 @@ export interface ConfigMergeResult {
 export interface DetectedConfig {
     isInstalled: boolean;
     hasOpenAI: boolean;
-    hasTmux: boolean;
 }
 import type { EffortSelection } from './model-effort';

package/dist/config/loader.d.ts

@@ -9,7 +9,7 @@ import { type PluginConfig } from './schema';
  *
  * JSONC format is preferred over JSON (allows comments and trailing commas).
  * Project config takes precedence over user config. Nested objects (agents,
- * tmux, fallback, and harness generation options) are
+ * fallback, and harness generation options) are
  * deep-merged, while top-level arrays are replaced entirely
  * by project config.
  *