pluidr 0.7.6 → 0.8.0

package/bin/pluidr.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { run } from "../src/cli/index.js"
-
-run(process.argv)
+import { run } from "../src/cli/index.js"
+
+run(process.argv)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pluidr",
-  "version": "0.7.6",
+  "version": "0.8.0",
   "description": "Opinionated Engineering Workflow for OpenCode — Plan, Build, Review.",
   "keywords": [
     "opencode",

package/src/cli/commands/doctor.js

@@ -1,134 +1,137 @@
-import { existsSync, readFileSync, readdirSync } from "node:fs"
-import { join } from "node:path"
-import { getConfigDir, getConfigPath, getPromptsDir, getThemesDir, getTuiConfigPath } from "../../core/paths.js"
-import { findSqueezePath } from "../../core/squeezeInstaller.js"
-
-const EXPECTED_PROMPT_COUNT = 18
-const PLUGIN_FILES = ["pluidr-flow.js", "pluidr-squeeze.js"]
-
-export function cleanJsonc(content) {
-  return content.replace(
-    /\\"|"(?:\\"|[^"])*"|(\/\/.*|\/\*[\s\S]*?\*\/)|(,\s*(?=[\]}]))/g,
-    (m, g1, g2) => g1 ? "" : g2 ? "" : m
-  )
-}
-
-export function collectChecks() {
-  const configDir = getConfigDir()
-  const configPath = getConfigPath()
-  const promptsDir = getPromptsDir()
-  const pluginsDir = join(configDir, "plugins")
-  const packageJsonPath = join(configDir, "package.json")
-  const binDir = join(configDir, "bin")
-  const themesDir = getThemesDir()
-
-  const checks = []
-
-  // 1. opencode.jsonc exists
-  const configExists = existsSync(configPath)
-  checks.push({ component: "opencode.jsonc", pass: configExists })
-
-  // 2. All 18 prompt files exist
-  let promptCount = 0
-  if (existsSync(promptsDir)) {
-    try {
-      const files = readdirSync(promptsDir).filter((f) => f.endsWith(".txt"))
-      promptCount = files.length
-    } catch {
-      promptCount = 0
-    }
-  }
-  checks.push({ component: "18 prompt files", pass: promptCount === EXPECTED_PROMPT_COUNT, detail: `${promptCount}/${EXPECTED_PROMPT_COUNT}` })
-
-  // 3. Both plugin files exist
-  let pluginsFound = 0
-  for (const f of PLUGIN_FILES) {
-    if (existsSync(join(pluginsDir, f))) pluginsFound++
-  }
-  checks.push({ component: "plugin files", pass: pluginsFound === PLUGIN_FILES.length, detail: `${pluginsFound}/${PLUGIN_FILES.length}` })
-
-  // 3b. Theme configuration verification
-  const themeExists = existsSync(join(themesDir, "pluidr-contrast.json"))
-  const tuiConfigPath = getTuiConfigPath()
-  let tuiConfigValid = false
-  let tuiDetail = "missing mapping"
-  if (existsSync(tuiConfigPath)) {
-    try {
-      const content = readFileSync(tuiConfigPath, "utf-8")
-      const parsed = JSON.parse(content)
-      if (parsed.theme === "pluidr-contrast") {
-        tuiConfigValid = true
-        tuiDetail = ""
-      } else {
-        tuiDetail = `theme: ${parsed.theme || "none"}`
-      }
-    } catch {
-      tuiDetail = "corrupted tui.json"
-    }
-  }
-  checks.push({
-    component: themeExists && tuiConfigValid ? "pluidr-contrast theme configured" : "pluidr-contrast theme not configured",
-    pass: themeExists && tuiConfigValid,
-    detail: !themeExists ? "missing theme file" : tuiDetail
-  })
-
-  // 4. package.json with @opencode-ai/plugin dependency
-  let pkgValid = false
-  if (existsSync(packageJsonPath)) {
-    try {
-      const pkg = JSON.parse(readFileSync(packageJsonPath, "utf-8"))
-      pkgValid = !!(pkg.dependencies && pkg.dependencies["@opencode-ai/plugin"])
-    } catch {
-      pkgValid = false
-    }
-  }
-  checks.push({ component: "package.json + plugin dep", pass: pkgValid })
-
-  // 5. Squeeze binary exists
-  let squeezeFound = false
-  const squeezeOnPath = findSqueezePath()
-  if (squeezeOnPath) {
-    squeezeFound = true
-  } else {
-    const binName = process.platform === "win32" ? "squeeze.exe" : "squeeze"
-    squeezeFound = existsSync(join(binDir, binName))
-  }
-  checks.push({ component: "squeeze binary tested", pass: squeezeFound })
-
-  // 6. Config is valid JSON/JSONC
-  let configValid = false
-  if (configExists) {
-    try {
-      const content = readFileSync(configPath, "utf-8")
-      const cleaned = cleanJsonc(content)
-      JSON.parse(cleaned)
-      configValid = true
-    } catch {
-      configValid = false
-    }
-  }
-  checks.push({ component: "config JSON validity", pass: configValid })
-
-  return checks
-}
-
-export async function runDoctor() {
-  const checks = collectChecks()
-  const allPass = checks.every((c) => c.pass)
-
-  console.log("\nPluidr Doctor — Installation Health Check\n")
-  for (const c of checks) {
-    const icon = c.pass ? "\u2713" : "\u2717"
-    const detail = c.detail ? ` (${c.detail})` : ""
-    console.log(`  ${icon} ${c.component}${detail}`)
-  }
-  console.log("")
-
-  if (allPass) {
-    console.log("All checks passed.")
-  } else {
-    console.log("Some checks failed. Re-run `pluidr init` to repair.")
-  }
-
-  process.exit(allPass ? 0 : 1)
-}
+import { existsSync, readFileSync, readdirSync } from "node:fs"
+import { join } from "node:path"
+import { getConfigDir, getConfigPath, getPromptsDir, getThemesDir, getTuiConfigPath, getCommandsDir } from "../../core/paths.js"
+
+const EXPECTED_PROMPT_COUNT = 8
+const PLUGIN_FILES = ["pluidr-flow.js", "pluidr-squeeze.js"]
+const EXPECTED_COMMAND_FILES = ["squeeze-quick.md", "squeeze-health.md", "squeeze-dashboard.md"]
+
+export function cleanJsonc(content) {
+  return content.replace(
+    /\\"|"(?:\\"|[^"])*"|(\/\/.*|\/\*[\s\S]*?\*\/)|(,\s*(?=[\]}]))/g,
+    (m, g1, g2) => g1 ? "" : g2 ? "" : m
+  )
+}
+
+export function collectChecks() {
+  const configDir = getConfigDir()
+  const configPath = getConfigPath()
+  const promptsDir = getPromptsDir()
+  const pluginsDir = join(configDir, "plugins")
+  const packageJsonPath = join(configDir, "package.json")
+  const binDir = join(configDir, "bin")
+  const themesDir = getThemesDir()
+
+  const checks = []
+
+  // 1. opencode.jsonc exists
+  const configExists = existsSync(configPath)
+  checks.push({ component: "opencode.jsonc", pass: configExists })
+
+  // 2. All 8 prompt files exist
+  let promptCount = 0
+  if (existsSync(promptsDir)) {
+    try {
+      const files = readdirSync(promptsDir).filter((f) => f.endsWith(".txt"))
+      promptCount = files.length
+    } catch {
+      promptCount = 0
+    }
+  }
+  checks.push({ component: "8 prompt files", pass: promptCount === EXPECTED_PROMPT_COUNT, detail: `${promptCount}/${EXPECTED_PROMPT_COUNT}` })
+
+  // 3. Both plugin files exist
+  let pluginsFound = 0
+  for (const f of PLUGIN_FILES) {
+    if (existsSync(join(pluginsDir, f))) pluginsFound++
+  }
+  checks.push({ component: "plugin files", pass: pluginsFound === PLUGIN_FILES.length, detail: `${pluginsFound}/${PLUGIN_FILES.length}` })
+
+  // 3a. Slash command files exist
+  let commandsFound = 0
+  const commandsDir = getCommandsDir()
+  for (const f of EXPECTED_COMMAND_FILES) {
+    if (existsSync(join(commandsDir, f))) commandsFound++
+  }
+  checks.push({ component: "slash command files", pass: commandsFound === EXPECTED_COMMAND_FILES.length, detail: `${commandsFound}/${EXPECTED_COMMAND_FILES.length}` })
+
+  // 3b. Theme configuration verification (accepts any valid pluidr theme)
+  const ALLOWED_THEMES = new Set(["pluidr-dark", "pluidr-light", "pluidr-colorful"])
+  const tuiConfigPath = getTuiConfigPath()
+  let activeTheme = "pluidr-dark" // default fallback
+  let tuiConfigValid = false
+  let tuiDetail = "missing mapping"
+  
+  if (existsSync(tuiConfigPath)) {
+    try {
+      const content = readFileSync(tuiConfigPath, "utf-8")
+      const parsed = JSON.parse(content)
+      if (parsed.theme && ALLOWED_THEMES.has(parsed.theme)) {
+        activeTheme = parsed.theme
+        tuiConfigValid = true
+        tuiDetail = ""
+      } else {
+        tuiDetail = `theme: ${parsed.theme || "none"}`
+      }
+    } catch {
+      tuiDetail = "corrupted tui.json"
+    }
+  }
+
+  const themeExists = existsSync(join(themesDir, `${activeTheme}.json`))
+  checks.push({
+    component: themeExists && tuiConfigValid ? `${activeTheme} theme configured` : "theme not configured",
+    pass: themeExists && tuiConfigValid,
+    detail: !themeExists ? `missing theme file ${activeTheme}.json` : tuiDetail
+  })
+
+  // 4. package.json with @opencode-ai/plugin dependency
+  let pkgValid = false
+  if (existsSync(packageJsonPath)) {
+    try {
+      const pkg = JSON.parse(readFileSync(packageJsonPath, "utf-8"))
+      pkgValid = !!(pkg.dependencies && pkg.dependencies["@opencode-ai/plugin"])
+    } catch {
+      pkgValid = false
+    }
+  }
+  checks.push({ component: "package.json + plugin dep", pass: pkgValid })
+
+
+  // 6. Config is valid JSON/JSONC
+  let configValid = false
+  if (configExists) {
+    try {
+      const content = readFileSync(configPath, "utf-8")
+      const cleaned = cleanJsonc(content)
+      JSON.parse(cleaned)
+      configValid = true
+    } catch {
+      configValid = false
+    }
+  }
+  checks.push({ component: "config JSON validity", pass: configValid })
+
+  return checks
+}
+
+export async function runDoctor() {
+  const checks = collectChecks()
+  const allPass = checks.every((c) => c.pass)
+
+  console.log("\nPluidr Doctor — Installation Health Check\n")
+  for (const c of checks) {
+    const icon = c.pass ? "\u2713" : "\u2717"
+    const detail = c.detail ? ` (${c.detail})` : ""
+    console.log(`  ${icon} ${c.component}${detail}`)
+  }
+  console.log("")
+
+  if (allPass) {
+    console.log("All checks passed.")
+  } else {
+    console.log("Some checks failed. Re-run `pluidr init` to repair.")
+  }
+
+  process.exit(allPass ? 0 : 1)
+}

package/src/cli/commands/init.js

@@ -1,47 +1,134 @@
-import { readFileSync, writeFileSync } from "node:fs"
-import { resolve, dirname } from "node:path"
-import { fileURLToPath } from "node:url"
-import { confirm, isCancel } from "@clack/prompts"
-import { selectModelTier } from "../wizard/selectModelTier.js"
-import { backupExistingConfig } from "../../core/backup.js"
-import { buildConfig } from "../../core/configBuilder.js"
-import { writeConfig } from "../../core/configWriter.js"
-import { writeAgentPrompts } from "../../core/agentPromptWriter.js"
-import { writePluginBundle, writePluginPackageJson } from "../../core/pluginWriter.js"
-import { writeThemes } from "../../core/themeWriter.js"
-import { writeTuiConfig } from "../../core/tuiConfigWriter.js"
-import { installSqueeze } from "../../core/squeezeInstaller.js"
-import { getConfigPath, getConfigDir } from "../../core/paths.js"
-
-const __dirname = dirname(fileURLToPath(import.meta.url))
-const TEMPLATES_DIR = resolve(__dirname, "../../templates")
-
-export async function runInit() {
-  const defaultsPath = resolve(TEMPLATES_DIR, "model-defaults.json")
-  const modelDefaults = JSON.parse(readFileSync(defaultsPath, "utf-8"))
-
-  const tierChoices = await selectModelTier(modelDefaults)
-
-  const squeezeAnswer = await confirm({
-    message: "Install pluidr-squeeze plugin? Reduces bash output tokens by 60-90%.",
-    initialValue: true,
-  })
-
-  const installSqueezePlugin = isCancel(squeezeAnswer) ? false : squeezeAnswer
-
-  backupExistingConfig()
-
-  const configObject = buildConfig(tierChoices, TEMPLATES_DIR)
-  writeConfig(configObject)
-  writeAgentPrompts(TEMPLATES_DIR)
-  writeThemes(TEMPLATES_DIR)
-  writeTuiConfig("pluidr-contrast")
-  writePluginBundle()
-  writePluginPackageJson()
-  if (installSqueezePlugin) {
-    await installSqueeze()
-  }
-
-  const path = getConfigPath().replace(/\\/g, "/").replace(/^\//, "")
-  console.log(`Pluidr setup complete!\nYou can update your agent model settings later in \x1b]8;;file:///${path}\x1b\\opencode.jsonc\x1b]8;;\x1b\\`)
-}
+import { readFileSync, writeFileSync } from "node:fs"
+import { resolve, dirname } from "node:path"
+import { fileURLToPath } from "node:url"
+import { select, isCancel } from "@clack/prompts"
+import { selectModelTier } from "../wizard/selectModelTier.js"
+import { backupExistingConfig } from "../../core/backup.js"
+import { buildConfig } from "../../core/configBuilder.js"
+import { writeConfig } from "../../core/configWriter.js"
+import { writeAgentPrompts } from "../../core/agentPromptWriter.js"
+import { writePluginBundle, writePluginPackageJson } from "../../core/pluginWriter.js"
+import { writeThemes } from "../../core/themeWriter.js"
+import { writeTuiConfig } from "../../core/tuiConfigWriter.js"
+import { writeSkills } from "../../core/skillsWriter.js"
+import { writeCommands } from "../../core/commandsWriter.js"
+import { version } from "../../core/version.js"
+import { getConfigPath } from "../../core/paths.js"
+import { getAnimationType, getLogoLine, ASCII_LOGO_LINES } from "../../core/animation.js"
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const TEMPLATES_DIR = resolve(__dirname, "../../templates")
+
+export async function runInit() {
+  console.log("\x1b[1;36m┌  pluidr init\x1b[0m")
+  
+  // Print initial blank lines so the animation loop can safely clear them
+  for (let i = 0; i < 9; i++) console.log("│")
+
+  const animType = getAnimationType()
+  let frame = 0
+  const animInterval = setInterval(() => {
+    // Clear logo lines (9 rows)
+    process.stdout.write("\x1b[9A\x1b[0J")
+    
+    for (let r = 0; r < 5; r++) {
+      const { text, color } = getLogoLine(ASCII_LOGO_LINES[r], r, frame, animType)
+      console.log("│  " + color + text + "\x1b[0m")
+    }
+    console.log("│");
+    console.log(`│  Spex-driven development, made fluid. • v${version} (Stable)`);
+    console.log("│  \x1b[90mPress any key to begin setup...\x1b[0m");
+    console.log("│");
+    
+    frame++
+  }, 100)
+
+  // Loop until user presses any key (or resolve immediately if not running in TTY)
+  if (process.stdin.isTTY) {
+    await new Promise((resolve) => {
+      const onData = (key) => {
+        if (key === "\u0003") {
+          process.exit(0);
+        }
+        clearInterval(animInterval);
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdin.off("data", onData);
+        resolve();
+      };
+
+      process.stdin.setRawMode(true);
+      process.stdin.resume();
+      process.stdin.setEncoding("utf8");
+      process.stdin.on("data", onData);
+    });
+  } else {
+    clearInterval(animInterval);
+  }
+
+  // Overwrite "Press any key to begin setup..." with "Starting setup wizard..." in place
+  process.stdout.write("\x1b[2A\r│  \x1b[32m✓\x1b[0m Starting setup wizard...\x1b[0K\n│\n\n");
+
+  const defaultsPath = resolve(TEMPLATES_DIR, "model-defaults.json")
+  const modelDefaults = JSON.parse(readFileSync(defaultsPath, "utf-8"))
+
+  // 1. Model Tier Selection Prompts (Directly separated by reasoning, precision, fast)
+  const tierChoices = await selectModelTier(modelDefaults)
+
+  // 2. Theme Selection Prompt
+  const selectedTheme = await select({
+    message: "Select a Default Theme:",
+    options: [
+      { value: "pluidr-dark", label: "pluidr-dark     - Dark High Contrast (Recommended)" },
+      { value: "pluidr-light", label: "pluidr-light    - Light High Contrast" },
+      { value: "pluidr-colorful", label: "pluidr-colorful - Pastel Palette" }
+    ]
+  })
+
+  if (isCancel(selectedTheme)) {
+    console.log("Operation cancelled.")
+    process.exit(0)
+  }
+
+  // 3. Execution steps
+  backupExistingConfig()
+
+  const configObject = buildConfig(tierChoices, TEMPLATES_DIR)
+  writeConfig(configObject)
+  writeAgentPrompts(TEMPLATES_DIR)
+  console.log("│  Writing agent prompts...  \x1b[32m✓\x1b[0m Wrote 8 files to ~/.config/opencode/prompts/")
+
+  writeThemes(TEMPLATES_DIR)
+  console.log("│  Writing themes...         \x1b[32m✓\x1b[0m Installed 3 themes")
+
+  writeSkills(TEMPLATES_DIR)
+  console.log("│  Writing skills...         \x1b[32m✓\x1b[0m Installed 17 developer skill playbooks")
+
+  writeCommands(TEMPLATES_DIR)
+  console.log("│  Writing commands...       \x1b[32m✓\x1b[0m Installed 3 custom slash commands")
+
+  writeTuiConfig(selectedTheme, undefined, "wave")
+  console.log("│  Writing configuration...  \x1b[32m✓\x1b[0m Configured opencode.jsonc and tui.json")
+
+  writePluginBundle()
+  writePluginPackageJson()
+  console.log("│  Installing plugins...     \x1b[32m✓\x1b[0m Installed bundled plugins (pluidr-flow, pluidr-squeeze)");
+
+  const path = getConfigPath().replace(/\\/g, "/").replace(/^\//, "")
+  console.log(`
+======================================================
+  🚀 Pluidr Setup Complete!
+======================================================
+
+You can view the full list of available commands using:
+  $ pluidr --help
+
+To customize your agent model settings, open your config:
+  👉 \x1b]8;;file:///${path}\x1b\\opencode.jsonc\x1b]8;;\x1b\\
+
+To launch OpenCode with your Pluidr pipeline, simply run:
+  $ pluidr
+======================================================
+`)
+  console.log("\x1b[1;36m└  Setup finished!\x1b[0m")
+}

package/src/cli/commands/launch.js

@@ -1,50 +1,101 @@
-import { spawn } from "node:child_process"
-import { confirm, isCancel } from "@clack/prompts"
-import { checkAndPromptUpdate } from "../../core/versionCheck.js"
-import { version } from "../../core/version.js"
-import { collectChecks } from "./doctor.js"
-import { runInit } from "./init.js"
-
-export async function runLaunch() {
-  // 1. Update check
-  const updated = await checkAndPromptUpdate(version)
-  if (updated) {
-    console.log("Update successful. Please run pluidr again to start the new version.")
-    process.exit(0)
-  }
-
-  // 2. Doctor check
-  process.stdout.write("Running doctor...         ")
-  const checks = collectChecks()
-  const allPass = checks.every((c) => c.pass)
-
-  if (allPass) {
-    console.log("✓ All checks passed")
-  } else {
-    const failed = checks.filter((c) => !c.pass)
-    console.log(`✗ ${failed.length} check${failed.length > 1 ? "s" : ""} failed`)
-    for (const c of failed) {
-      const detail = c.detail ? ` (${c.detail})` : ""
-      console.log(`  ✗ ${c.component}${detail}`)
-    }
-
-    const answer = await confirm({ message: "Repair with pluidr init?", initialValue: true })
-    if (!isCancel(answer) && answer) {
-      await runInit()
-    }
-  }
-
-  // 3. Launch opencode
-  console.log("Launching pluidr...")
-  const child = process.platform === "win32"
-    ? spawn("opencode", { stdio: "inherit", shell: true })
-    : spawn("opencode", [], { stdio: "inherit" })
-  child.on("error", (err) => {
-    if (err.code === "ENOENT") {
-      console.error("Error: opencode not found on PATH. Install it from https://opencode.ai")
-    } else {
-      console.error(`Error launching opencode: ${err.message}`)
-    }
-    process.exit(1)
-  })
-}
+import { spawn } from "node:child_process"
+import { confirm, isCancel } from "@clack/prompts"
+import { checkAndPromptUpdate } from "../../core/versionCheck.js"
+import { version } from "../../core/version.js"
+import { collectChecks } from "./doctor.js"
+import { runInit } from "./init.js"
+
+import { getAnimationType, getLogoLine, ASCII_LOGO_LINES } from "../../core/animation.js"
+
+export async function runLaunch() {
+  // 1. Start loading animation
+  for (let i = 0; i < 9; i++) console.log("");
+  
+  const animType = getAnimationType();
+  let frame = 0;
+  let statusMessage = "Loading Pluidr...";
+  
+  const animInterval = setInterval(() => {
+    // Clear logo lines (9 rows)
+    process.stdout.write("\x1b[9A\x1b[0J");
+    
+    for (let r = 0; r < 5; r++) {
+      const { text, color } = getLogoLine(ASCII_LOGO_LINES[r], r, frame, animType);
+      console.log(color + text + "\x1b[0m");
+    }
+    console.log("");
+    console.log(`  Spex-driven development, made fluid. • v${version} (Stable)`);
+    console.log("");
+    
+    // Draw spinning wave indicator
+    const spinner = ["∿", "≋", "≁", "≋"][frame % 4];
+    console.log(`  ${spinner} [ \x1b[36m🌊\x1b[0m ] ${statusMessage}\r`);
+    
+    frame++;
+  }, 100);
+
+  // 2. Perform async checks (enforce minimum 1.5s animation duration for visual quality)
+  const startTime = Date.now();
+  
+  statusMessage = "Checking environment and version...";
+  const updated = await checkAndPromptUpdate(version);
+  if (updated) {
+    clearInterval(animInterval);
+    console.log("Update successful. Please run pluidr again to start the new version.");
+    process.exit(0);
+  }
+ 
+  statusMessage = "Diagnosing installation integrity...";
+  const checks = collectChecks();
+  const allPass = checks.every((c) => c.pass);
+ 
+  // Wait for remainder of minimum duration
+  const elapsed = Date.now() - startTime;
+  if (elapsed < 1500) {
+    await new Promise(resolve => setTimeout(resolve, 1500 - elapsed));
+  }
+ 
+  clearInterval(animInterval);
+
+  // 3. Handle checks outcomes
+  if (allPass) {
+    // Overwrite the spinner line with the success checkmark in place
+    process.stdout.write("\x1b[1A\r  \x1b[32m✓\x1b[0m All checks passed! Spawning OpenCode...\x1b[0K\n\n");
+  } else {
+    // Overwrite the spinner line with the failure message in place
+    process.stdout.write("\x1b[1A\r  \x1b[31m✗\x1b[0m Diagnostics check failed.\x1b[0K\n\n");
+    const failed = checks.filter((c) => !c.pass);
+    console.log(`✗ Pluidr diagnostics found ${failed.length} failure${failed.length > 1 ? "s" : ""}:`);
+    for (const c of failed) {
+      const detail = c.detail ? ` (${c.detail})` : "";
+      console.log(`  ✗ ${c.component}${detail}`);
+    }
+
+    console.log("\nIt looks like Pluidr is not fully initialized yet.");
+    console.log("We highly recommend running the initialization command to set up templates, themes, and configs:");
+    console.log("  $ pluidr init");
+    console.log("\nYou can view all available commands using:");
+    console.log("  $ pluidr --help\n");
+
+    const answer = await confirm({ message: "Run pluidr init now to complete setup?", initialValue: true });
+    if (!isCancel(answer) && answer) {
+      await runInit();
+    } else {
+      process.exit(1);
+    }
+  }
+
+  // 4. Launch opencode
+  console.log("Launching pluidr...");
+  const child = process.platform === "win32"
+    ? spawn("opencode", { stdio: "inherit", shell: true })
+    : spawn("opencode", [], { stdio: "inherit" })
+  child.on("error", (err) => {
+    if (err.code === "ENOENT") {
+      console.error("Error: opencode not found on PATH. Install it from https://opencode.ai");
+    } else {
+      console.error(`Error launching opencode: ${err.message}`);
+    }
+    process.exit(1);
+  })
+}