opencodekit 0.1.0 → 0.2.1

package/dist/index.js

@@ -750,7 +750,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.1.0",
+  version: "0.2.1",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   type: "module",
   repository: {
@@ -1968,6 +1968,18 @@ async function configCommand(action) {
     case "theme":
       await editTheme(configPath);
       break;
+    case "tui":
+      await editTui(configPath);
+      break;
+    case "tools":
+      await editTools(configPath);
+      break;
+    case "share":
+      await editShare(configPath);
+      break;
+    case "autoupdate":
+      await editAutoupdate(configPath);
+      break;
     case "show":
       showConfig(configPath);
       break;
@@ -1978,6 +1990,10 @@ async function configCommand(action) {
         "permission",
         "keybinds",
         "theme",
+        "tui",
+        "tools",
+        "share",
+        "autoupdate",
         "show"
       ]);
   }
@@ -2000,6 +2016,23 @@ function showConfig(configPath) {
   }
   console.log(import_picocolors7.default.bold("  Theme"));
   console.log(`    ${import_picocolors7.default.cyan(config.theme || "system")}`);
+  console.log(import_picocolors7.default.bold("  Share"));
+  console.log(`    ${import_picocolors7.default.cyan(config.share || "manual")}`);
+  const autoupdateDisplay = config.autoupdate === "notify" ? "notify" : config.autoupdate === false ? "disabled" : "enabled";
+  console.log(import_picocolors7.default.bold("  Autoupdate"));
+  console.log(`    ${import_picocolors7.default.cyan(autoupdateDisplay)}`);
+  if (config.tui && Object.keys(config.tui).length > 0) {
+    console.log(import_picocolors7.default.bold("  TUI"));
+    if (config.tui.scroll_speed !== undefined) {
+      console.log(`    scroll_speed: ${import_picocolors7.default.cyan(String(config.tui.scroll_speed))}`);
+    }
+    if (config.tui.scroll_acceleration !== undefined) {
+      console.log(`    scroll_acceleration: ${import_picocolors7.default.cyan(String(config.tui.scroll_acceleration))}`);
+    }
+    if (config.tui.diff_style) {
+      console.log(`    diff_style: ${import_picocolors7.default.cyan(config.tui.diff_style)}`);
+    }
+  }
   if (config.mcp && Object.keys(config.mcp).length > 0) {
     console.log(import_picocolors7.default.bold("  MCP Servers"));
     for (const [name, server] of Object.entries(config.mcp)) {
@@ -2007,6 +2040,13 @@ function showConfig(configPath) {
       console.log(`    ${status} ${name}`);
     }
   }
+  if (config.tools && Object.keys(config.tools).length > 0) {
+    console.log(import_picocolors7.default.bold("  Tools"));
+    for (const [tool, enabled] of Object.entries(config.tools)) {
+      const status = enabled === false ? import_picocolors7.default.red("off") : import_picocolors7.default.green("on");
+      console.log(`    ${status} ${tool}`);
+    }
+  }
   if (config.keybinds && Object.keys(config.keybinds).length > 0) {
     console.log(import_picocolors7.default.bold("  Keybinds"));
     for (const [action, key] of Object.entries(config.keybinds)) {
@@ -2017,55 +2057,74 @@ function showConfig(configPath) {
 }
 async function configMenu(configPath) {
   oe(import_picocolors7.default.bgCyan(import_picocolors7.default.black(" Configuration ")));
-  const action = await ie({
-    message: "What do you want to configure?",
-    options: [
-      { value: "model", label: "Model - change default model" },
-      {
-        value: "small_model",
-        label: "Small Model - change small model"
-      },
-      { value: "agent", label: "Agents - configure agent models" },
-      { value: "theme", label: "Theme - change UI theme" },
-      { value: "mcp", label: "MCP - manage MCP servers" },
-      {
-        value: "permission",
-        label: "Permissions - bash/edit permissions"
-      },
-      { value: "keybinds", label: "Keybinds - keyboard shortcuts" },
-      { value: "show", label: "Show - view current config" },
-      { value: "exit", label: "Exit" }
-    ]
-  });
-  if (lD(action) || action === "exit") {
-    $e("Done");
-    return;
-  }
-  switch (action) {
-    case "model":
-      await editModel(configPath);
-      break;
-    case "small_model":
-      await editModel(configPath, "small_model");
-      break;
-    case "agent":
-      await editAgentModel(configPath);
-      break;
-    case "theme":
-      await editTheme(configPath);
-      break;
-    case "mcp":
-      await editMCP(configPath);
-      break;
-    case "permission":
-      await editPermissions(configPath);
-      break;
-    case "keybinds":
-      await editKeybinds(configPath);
-      break;
-    case "show":
-      showConfig(configPath);
-      break;
+  while (true) {
+    const action = await ie({
+      message: "What do you want to configure?",
+      options: [
+        { value: "model", label: "Model - change default model" },
+        {
+          value: "small_model",
+          label: "Small Model - change small model"
+        },
+        { value: "agent", label: "Agents - configure agent models" },
+        { value: "theme", label: "Theme - change UI theme" },
+        { value: "tui", label: "TUI - scroll speed, diff style" },
+        { value: "mcp", label: "MCP - manage MCP servers" },
+        { value: "tools", label: "Tools - enable/disable tools" },
+        {
+          value: "permission",
+          label: "Permissions - bash/edit permissions"
+        },
+        { value: "keybinds", label: "Keybinds - keyboard shortcuts" },
+        { value: "share", label: "Share - sharing settings" },
+        { value: "autoupdate", label: "Autoupdate - update behavior" },
+        { value: "show", label: "Show - view current config" },
+        { value: "exit", label: "Exit" }
+      ]
+    });
+    if (lD(action) || action === "exit") {
+      $e("Done");
+      return;
+    }
+    switch (action) {
+      case "model":
+        await editModel(configPath);
+        break;
+      case "small_model":
+        await editModel(configPath, "small_model");
+        break;
+      case "agent":
+        await editAgentModel(configPath);
+        break;
+      case "theme":
+        await editTheme(configPath);
+        break;
+      case "tui":
+        await editTui(configPath);
+        break;
+      case "mcp":
+        await editMCP(configPath);
+        break;
+      case "tools":
+        await editTools(configPath);
+        break;
+      case "permission":
+        await editPermissions(configPath);
+        break;
+      case "keybinds":
+        await editKeybinds(configPath);
+        break;
+      case "share":
+        await editShare(configPath);
+        break;
+      case "autoupdate":
+        await editAutoupdate(configPath);
+        break;
+      case "show":
+        showConfig(configPath);
+        break;
+    }
+    console.log();
   }
 }
 async function editModel(configPath, modelType = "model") {
@@ -2102,6 +2161,11 @@ async function editModel(configPath, modelType = "model") {
   const configuredProviderIds = new Set(Object.keys(localProviders));
   const allProviders = Object.values(modelsDevData);
   const quickOptions = [];
+  quickOptions.push({
+    value: "__back__",
+    label: "← Back",
+    hint: "return to menu"
+  });
   for (const [providerId2, providerConfig] of Object.entries(localProviders)) {
     const modelsDevProvider2 = modelsDevData[providerId2];
     const localModels = providerConfig.models || {};
@@ -2129,10 +2193,12 @@ async function editModel(configPath, modelType = "model") {
     options: quickOptions
   });
   if (lD(quickPick)) {
-    ue("Cancelled");
     return;
   }
   let providerId = quickPick;
+  if (providerId === "__back__") {
+    return;
+  }
   if (providerId === "__custom__") {
     const customModel = await te({
       message: `Enter ${modelLabel}`,
@@ -2186,10 +2252,21 @@ async function editModel(configPath, modelType = "model") {
   const modelsDevProvider = modelsDevData[providerId];
   const localProviderConfig = localProviders[providerId];
   let modelOptions = [];
+  modelOptions.push({
+    value: "__back__",
+    label: "← Back",
+    hint: "return to provider selection"
+  });
   if (modelsDevProvider && Object.keys(modelsDevProvider.models || {}).length > 0) {
-    modelOptions = getModelsForProvider(modelsDevProvider);
+    modelOptions = [
+      modelOptions[0],
+      ...getModelsForProvider(modelsDevProvider)
+    ];
   } else if (localProviderConfig?.models && Object.keys(localProviderConfig.models).length > 0) {
-    modelOptions = getModelsFromLocalConfig(localProviderConfig.models);
+    modelOptions = [
+      modelOptions[0],
+      ...getModelsFromLocalConfig(localProviderConfig.models)
+    ];
   } else {
     f2.warn(`No models found for ${providerId}`);
     return;
@@ -2198,8 +2275,7 @@ async function editModel(configPath, modelType = "model") {
     message: `Select model from ${providerId}`,
     options: modelOptions
   });
-  if (lD(selectedModel)) {
-    ue("Cancelled");
+  if (lD(selectedModel) || selectedModel === "__back__") {
     return;
   }
   const fullModelId = `${providerId}/${selectedModel}`;
@@ -2287,9 +2363,9 @@ async function editAgentModel(configPath) {
     console.log(`    ${import_picocolors7.default.cyan(name)}: ${model}${builtIn}${disabled}`);
   }
   console.log();
-  const selectedAgent = await ie({
-    message: "Select agent to configure",
-    options: agentNames.map((name) => {
+  const agentOptions = [
+    { value: "__back__", label: "← Back", hint: "return to menu" },
+    ...agentNames.map((name) => {
       const info = agentInfoMap.get(name);
       return {
         value: name,
@@ -2297,8 +2373,12 @@ async function editAgentModel(configPath) {
         hint: info?.model || "(default)"
       };
     })
+  ];
+  const selectedAgent = await ie({
+    message: "Select agent to configure",
+    options: agentOptions
   });
-  if (lD(selectedAgent)) {
+  if (lD(selectedAgent) || selectedAgent === "__back__") {
     return;
   }
   const agentName = selectedAgent;
@@ -2306,6 +2386,11 @@ async function editAgentModel(configPath) {
   const action = await ie({
     message: `Configure ${agentName}`,
     options: [
+      {
+        value: "__back__",
+        label: "← Back",
+        hint: "return to agent list"
+      },
       { value: "model", label: "Change model" },
       {
         value: "toggle",
@@ -2314,7 +2399,7 @@ async function editAgentModel(configPath) {
       { value: "description", label: "Edit description" }
     ]
   });
-  if (lD(action)) {
+  if (lD(action) || action === "__back__") {
     return;
   }
   if (action === "toggle") {
@@ -2373,6 +2458,11 @@ async function editAgentModel(configPath) {
   const localProviders = config.provider || {};
   const allProviders = Object.values(modelsDevData);
   const quickOptions = [];
+  quickOptions.push({
+    value: "__back__",
+    label: "← Back",
+    hint: "return to agent list"
+  });
   quickOptions.push({
     value: "__default__",
     label: "Default - use session model",
@@ -2408,6 +2498,9 @@ async function editAgentModel(configPath) {
     return;
   }
   let providerId = quickPick;
+  if (providerId === "__back__") {
+    return;
+  }
   if (providerId === "__default__") {
     if (!config.agent[agentName]) {
       config.agent[agentName] = {};
@@ -2515,12 +2608,13 @@ async function editMCP(configPath) {
   const action = await ie({
     message: "MCP Servers",
     options: [
+      { value: "__back__", label: "← Back", hint: "return to menu" },
       { value: "toggle", label: "Toggle server on/off" },
       { value: "add", label: "Add new server" },
       { value: "remove", label: "Remove server" }
     ]
   });
-  if (lD(action)) {
+  if (lD(action) || action === "__back__") {
     return;
   }
   switch (action) {
@@ -2663,6 +2757,7 @@ async function editPermissions(configPath) {
   const action = await ie({
     message: "Edit permission",
     options: [
+      { value: "__back__", label: "← Back", hint: "return to menu" },
       { value: "edit", label: "edit - file editing" },
       {
         value: "external",
@@ -2671,7 +2766,7 @@ async function editPermissions(configPath) {
       { value: "bash", label: "bash - add command pattern" }
     ]
   });
-  if (lD(action)) {
+  if (lD(action) || action === "__back__") {
     return;
   }
   const permValue = await ie({
@@ -2726,6 +2821,7 @@ async function editKeybinds(configPath) {
   const action = await ie({
     message: "Select keybind to edit",
     options: [
+      { value: "__back__", label: "← Back", hint: "return to menu" },
       { value: "leader", label: "leader - prefix key" },
       {
         value: "command_list",
@@ -2742,7 +2838,7 @@ async function editKeybinds(configPath) {
       { value: "custom", label: "Custom keybind" }
     ]
   });
-  if (lD(action)) {
+  if (lD(action) || action === "__back__") {
     return;
   }
   let keybindName = action;
@@ -2829,6 +2925,216 @@ async function editTheme(configPath) {
   saveConfig(configPath, config);
   f2.success(`Theme set to ${import_picocolors7.default.cyan(selectedTheme)}`);
 }
+async function editTui(configPath) {
+  const config = loadConfig(configPath);
+  if (!config.tui) {
+    config.tui = {};
+  }
+  const setting = await ie({
+    message: "TUI Setting",
+    options: [
+      {
+        value: "__back__",
+        label: "← Back",
+        hint: "return to menu"
+      },
+      {
+        value: "scroll_speed",
+        label: "Scroll Speed",
+        hint: `current: ${config.tui.scroll_speed ?? "default"}`
+      },
+      {
+        value: "scroll_acceleration",
+        label: "Scroll Acceleration",
+        hint: `current: ${config.tui.scroll_acceleration ?? "default"}`
+      },
+      {
+        value: "diff_style",
+        label: "Diff Style",
+        hint: `current: ${config.tui.diff_style ?? "unified"}`
+      }
+    ]
+  });
+  if (lD(setting) || setting === "__back__") {
+    return;
+  }
+  if (setting === "diff_style") {
+    const style = await ie({
+      message: "Diff style",
+      options: [
+        { value: "unified", label: "Unified", hint: "single column" },
+        { value: "split", label: "Split", hint: "side by side" }
+      ]
+    });
+    if (lD(style)) {
+      return;
+    }
+    config.tui.diff_style = style;
+    saveConfig(configPath, config);
+    f2.success(`Diff style set to ${import_picocolors7.default.cyan(style)}`);
+  } else {
+    const settingKey = setting;
+    const value = await te({
+      message: `${settingKey === "scroll_speed" ? "Scroll speed" : "Scroll acceleration"}`,
+      placeholder: "e.g. 1.0, 2.0",
+      initialValue: String(config.tui[settingKey] ?? ""),
+      validate: (v2) => {
+        if (v2 && Number.isNaN(Number(v2)))
+          return "Must be a number";
+      }
+    });
+    if (lD(value)) {
+      return;
+    }
+    config.tui[settingKey] = value ? Number(value) : undefined;
+    saveConfig(configPath, config);
+    f2.success(`${settingKey} set to ${import_picocolors7.default.cyan(value || "default")}`);
+  }
+}
+async function editTools(configPath) {
+  const config = loadConfig(configPath);
+  if (!config.tools) {
+    config.tools = {};
+  }
+  const commonTools = [
+    "read",
+    "glob",
+    "grep",
+    "edit",
+    "write",
+    "bash",
+    "webfetch",
+    "todowrite",
+    "todoread"
+  ];
+  console.log();
+  console.log(import_picocolors7.default.bold("  Tool Status"));
+  for (const tool of commonTools) {
+    const status = config.tools[tool] === false ? import_picocolors7.default.red("off") : import_picocolors7.default.green("on");
+    console.log(`    ${status} ${tool}`);
+  }
+  console.log();
+  const action = await ie({
+    message: "Select action",
+    options: [
+      { value: "__back__", label: "← Back", hint: "return to menu" },
+      { value: "toggle", label: "Toggle tool on/off" },
+      { value: "custom", label: "Add custom tool" }
+    ]
+  });
+  if (lD(action) || action === "__back__") {
+    return;
+  }
+  if (action === "toggle") {
+    const allTools = [
+      ...new Set([...commonTools, ...Object.keys(config.tools)])
+    ];
+    const selected = await ie({
+      message: "Select tool to toggle",
+      options: allTools.map((tool) => ({
+        value: tool,
+        label: tool,
+        hint: config.tools?.[tool] === false ? "off" : "on"
+      }))
+    });
+    if (lD(selected)) {
+      return;
+    }
+    const toolName = selected;
+    const wasEnabled = config.tools[toolName] !== false;
+    config.tools[toolName] = !wasEnabled;
+    saveConfig(configPath, config);
+    const status = config.tools[toolName] ? import_picocolors7.default.green("enabled") : import_picocolors7.default.red("disabled");
+    f2.success(`${toolName}: ${status}`);
+  } else {
+    const toolName = await te({
+      message: "Tool name",
+      placeholder: "e.g. my-custom-tool",
+      validate: (v2) => {
+        if (!v2)
+          return "Tool name is required";
+      }
+    });
+    if (lD(toolName)) {
+      return;
+    }
+    const enabled = await se({
+      message: "Enable this tool?",
+      initialValue: true
+    });
+    if (lD(enabled)) {
+      return;
+    }
+    config.tools[toolName] = enabled;
+    saveConfig(configPath, config);
+    f2.success(`Added ${toolName}: ${enabled ? import_picocolors7.default.green("on") : import_picocolors7.default.red("off")}`);
+  }
+}
+async function editShare(configPath) {
+  const config = loadConfig(configPath);
+  const current = config.share || "manual";
+  f2.info(`Current share setting: ${import_picocolors7.default.cyan(current)}`);
+  const selected = await ie({
+    message: "Share setting",
+    options: [
+      {
+        value: "manual",
+        label: "Manual",
+        hint: "share when requested"
+      },
+      {
+        value: "auto",
+        label: "Auto",
+        hint: "automatically share sessions"
+      },
+      { value: "disabled", label: "Disabled", hint: "never share" }
+    ]
+  });
+  if (lD(selected)) {
+    return;
+  }
+  const shareValue = selected;
+  config.share = shareValue;
+  saveConfig(configPath, config);
+  f2.success(`Share set to ${import_picocolors7.default.cyan(shareValue)}`);
+}
+async function editAutoupdate(configPath) {
+  const config = loadConfig(configPath);
+  const current = config.autoupdate ?? true;
+  const display = current === "notify" ? "notify" : current ? "enabled" : "disabled";
+  f2.info(`Current autoupdate: ${import_picocolors7.default.cyan(display)}`);
+  const selected = await ie({
+    message: "Autoupdate behavior",
+    options: [
+      {
+        value: "true",
+        label: "Enabled",
+        hint: "auto-update OpenCode"
+      },
+      {
+        value: "notify",
+        label: "Notify",
+        hint: "notify but don't auto-update"
+      },
+      {
+        value: "false",
+        label: "Disabled",
+        hint: "never update automatically"
+      }
+    ]
+  });
+  if (lD(selected)) {
+    return;
+  }
+  const selectedValue = selected;
+  if (selectedValue === "notify") {
+    config.autoupdate = "notify";
+  } else {
+    config.autoupdate = selectedValue === "true";
+  }
+  saveConfig(configPath, config);
+  f2.success(`Autoupdate set to ${import_picocolors7.default.cyan(selectedValue)}`);
+}
 
 // src/commands/upgrade.ts
 import { join as join5, dirname as dirname2 } from "node:path";

package/dist/template/.opencode/command/analyze-project.md

@@ -1,5 +1,5 @@
 ---
-description: Analyze project structure and status
+description: Analyze project structure, status, and ready work
 agent: planner
 ---
 
@@ -12,6 +12,16 @@ agent: planner
 3. **CI:** Check build status
 4. **Dependencies:** Check for outdated packages
 
+## Ready Work
+
+Find actionable tasks with no blockers:
+
+```bash
+bd ready
+```
+
+This shows beads that are unblocked and ready to start. Use `/implement <bead-id>` to begin work on any of these.
+
 ## Detailed Analysis (On Request)
 
 ### Task Overview
@@ -23,6 +33,16 @@ bd ready
 
 For active beads, read spec from `.beads/artifacts/<bead-id>/spec.md`
 
+### Blocked Work
+
+Check what's blocking progress:
+
+```bash
+bd list --status blocked
+```
+
+For each blocked bead, identify the blocker and either resolve it or escalate.
+
 ### Project Structure
 
 - Key directories
@@ -33,7 +53,8 @@ For active beads, read spec from `.beads/artifacts/<bead-id>/spec.md`
 
 ### Recommendations
 
-- Tasks ready to start
-- Areas needing attention
-- Dependency updates needed
-- Code patterns to follow
+- **Immediate:** Tasks from `bd ready` to start now
+- **Blocked:** Dependencies preventing progress
+- **Attention:** Areas needing cleanup or refactoring
+- **Updates:** Dependency updates needed
+- **Patterns:** Code patterns to follow

package/dist/template/.opencode/command/commit.md

@@ -1,11 +1,39 @@
 ---
-description: Commit with verification
+description: Commit with verification and optional bead traceability
+argument-hint: "[bead-id]"
 ---
 
 # Commit
 
 use_skill("verification-before-completion")
 
+## Workflow
+
 1. Run all tests/lints
 2. Verify output shows success
-3. Then commit with conventional message format
+3. Commit with conventional message format
+
+## Bead Integration (Optional)
+
+If a bead ID is provided (`$ARGUMENTS`), include it in the commit message for traceability:
+
+```
+<type>(<scope>): <description>
+
+<bead-id>: <what was done for this bead>
+
+[optional body]
+```
+
+**Example:**
+
+```
+feat(auth): add OAuth2 login flow
+
+bd-a1b2c3: implement token refresh mechanism
+
+- Added refresh token storage
+- Integrated with session manager
+```
+
+If no bead ID is provided, proceed with standard conventional commit format.

package/dist/template/.opencode/command/fix-ci.md

@@ -1,5 +1,5 @@
 ---
-description: Analyze Github Actions logs and fix issues
+description: Analyze Github Actions logs and fix issues with bead tracking
 argument-hint: "[github-actions-url]"
 ---
 
@@ -7,14 +7,41 @@ argument-hint: "[github-actions-url]"
 
 <url>$ARGUMENTS</url>
 
+## Create Bug Bead
+
+CI failures are P0 bugs. Create a bead to track:
+
+```bash
+bd create --title "Fix CI: <failure summary>" --type bug --priority p0 --json
+```
+
+Save the bead ID for tracking. Add the CI run reference:
+
+```bash
+bd edit <bead-id> --note "CI Run: $ARGUMENTS"
+```
+
 ## Workflow
 
-- Use `build` agent to read the GitHub Actions logs, analyze and find the root causes of the issues.
-- For complex CI/CD problems (≥3 phases), delegate to `planner` agent to create a detailed implementation plan.
-- Use `build` agent to implement the fixes step by step.
-- Use `review` agent to run tests, ensure quality and security, then report back.
-- If there are issues or failed tests, `build` agent will fix them and repeat the process until all tests pass.
+1. **Analyze:** Use `build` agent to read the GitHub Actions logs, analyze and find the root causes of the issues.
+
+2. **Plan:** For complex CI/CD problems (≥3 phases), delegate to `planner` agent to create a detailed implementation plan. Save plan to `.beads/artifacts/<bead-id>/spec.md`.
+
+3. **Fix:** Use `build` agent to implement the fixes step by step.
+
+4. **Verify:** Use `review` agent to run tests, ensure quality and security, then report back.
+
+5. **Iterate:** If there are issues or failed tests, `build` agent will fix them and repeat the process until all tests pass.
+
+## Close Bead
+
+Once CI passes:
+
+```bash
+bd close <bead-id> --reason "CI fixed: <summary of fix>"
+```
 
 ## Notes
 
 - If `gh` command is not available, instruct the user to install and authorize GitHub CLI first.
+- If the fix reveals systemic issues, create related beads for follow-up work.

package/dist/template/.opencode/command/fix-types.md

@@ -1,10 +1,35 @@
 ---
-description: Fix type errors
+description: Fix type errors with optional bead tracking
+argument-hint: "[bead-id]"
 ---
 
+# Fix Type Errors
+
 Run `bun run typecheck` and fix all type errors.
 
 ## Rules
 
-- Fix all of type errors and repeat the process until there are no more type errors.
-- Do not use `any` just to pass the type check.
+- Fix all type errors and repeat the process until there are no more type errors.
+- Do not use `any` just to pass the type check.
+- Prefer proper typing over type assertions where possible.
+
+## Bead Integration (Optional)
+
+If a bead ID is provided (`$ARGUMENTS`), track the type fixing work:
+
+1. **Before fixing:** Note the initial error count
+
+   ```bash
+   bd edit $ARGUMENTS --note "Type errors found: <count>"
+   ```
+
+2. **After fixing:** Update with resolution
+   ```bash
+   bd edit $ARGUMENTS --note "Type errors resolved: <summary of fixes>"
+   ```
+
+If type errors reveal deeper issues requiring refactoring, create a follow-up bead:
+
+```bash
+bd create --title "Refactor: <type issue summary>" --type task --related $ARGUMENTS
+```

package/dist/template/.opencode/command/issue.md

@@ -1,5 +1,5 @@
 ---
-description: Analyze GitHub issue and create implementation plan
+description: Analyze GitHub issue and create bead for tracking
 argument-hint: "[issue-number]"
 agent: build
 ---
@@ -19,8 +19,24 @@ gh issue view $ARGUMENTS
 3. **Current:** What happens now?
 4. **Steps:** How to reproduce?
 
+## Create Tracking Bead
+
+Create a bead to track this work, linking it to the GitHub issue:
+
+```bash
+bd create --title "<issue title>" --type task --priority <p1|p2|p3> --json
+```
+
+Save the bead ID for subsequent commands. Add the GitHub issue reference:
+
+```bash
+bd edit <bead-id> --note "GitHub issue: #$ARGUMENTS"
+```
+
 ## Implementation Plan
 
+Save to `.beads/artifacts/<bead-id>/spec.md`:
+
 1. **Files to change:** Identify affected code
 2. **Testing strategy:** How to verify fix
 3. **Risks/edge cases:** What could go wrong
@@ -38,4 +54,12 @@ gh issue view $ARGUMENTS
 - [ ] Test cases to verify
 - [ ] Performance considerations
 
-**Next:** Start implementing the planned solution.
+## Discovered Work
+
+If analysis reveals additional issues, create child beads:
+
+```bash
+bd create --title "<discovered issue>" --type discovered --parent <parent-bead-id>
+```
+
+**Next:** Use `/implement <bead-id>` to start implementation.

package/dist/template/.opencode/command/pr.md

@@ -1,5 +1,6 @@
 ---
-description: Create and submit pull request with proper formatting
+description: Create and submit pull request with bead traceability
+argument-hint: "[bead-id]"
 ---
 
 ## Create Pull Request
@@ -14,13 +15,18 @@ Create a pull request following these steps:
 
 2. **Push branch**: `!git push -u origin $(git branch --show-current)`
 
-3. **Generate PR content:**
+3. **Check for bead context:**
+   - If `$ARGUMENTS` contains a bead ID, fetch bead details: `bd show $ARGUMENTS --json`
+   - Use bead title and spec to inform PR content
+   - Reference the bead in the PR body for traceability
+
+4. **Generate PR content:**
    - Title: Clear, descriptive (under 60 chars)
    - Summary: What and why this change matters
    - Testing: How to verify the changes
    - Breaking changes: Note any API/behavior changes
 
-4. **Create PR**: `!gh pr create --title "Generated Title" --body "Generated Description"`
+5. **Create PR**: `!gh pr create --title "Generated Title" --body "Generated Description"`
 
 **Template format:**
 
@@ -28,9 +34,20 @@ Create a pull request following these steps:
 ## Summary
 - Brief description of changes
 
+## Bead Reference
+Closes: bd-XXXXX (if applicable)
+
 ## Testing
 - How to test these changes
 
 ## Breaking Changes
 - None / List any breaking changes
 ```
+
+## After PR Created
+
+If a bead ID was provided, update the bead with PR link:
+
+```bash
+bd edit $ARGUMENTS --note "PR created: <pr-url>"
+```

package/dist/template/.opencode/command/research-ui.md

@@ -1,6 +1,6 @@
 ---
-description: Large-scale UI/UX research using Gemini CLI
-argument-hint: "[research topic or path]"
+description: Large-scale UI/UX research using Gemini CLI with bead artifact storage
+argument-hint: "[bead-id] [research topic or path]"
 agent: review
 ---
 
@@ -9,6 +9,10 @@ agent: review
 use_skill("gemini-large-context")
 use_skill("ui-ux-research")
 
+## Parse Arguments
+
+Extract bead ID (if provided) and research topic from `$ARGUMENTS`. If no bead ID provided, research findings will be saved to memory instead.
+
 ## When to Use Gemini CLI
 
 For a single component, use local tools—they're faster and sufficient. When researching patterns across multiple files or comparing implementations throughout a codebase, switch to Gemini CLI's non-interactive mode to scan entire directories at once. For analyzing images like mockups or screenshots, start Gemini in interactive mode and reference the image directly.
@@ -19,9 +23,21 @@ Point Gemini at the relevant directories and ask about the topic. Include both c
 
 For image analysis, start interactive mode and reference the image file, then describe what aspects you want analyzed.
 
-## What to Do With Findings
+## Save Findings
+
+### With Bead ID
+
+Save research findings to bead artifacts for traceability:
+
+```bash
+# Save to .beads/artifacts/<bead-id>/research-ui.md
+bd edit <bead-id> --note "UI research completed: <key findings summary>"
+```
+
+### Without Bead ID
 
-Synthesize the key patterns you discovered, note any inconsistencies between different parts of the codebase, and formulate concrete recommendations. Save significant findings to `.opencode/memory/research/YYYY-MM-DD-$ARGUMENTS.md` using the research template.
+Save to memory for general reference:
+`.opencode/memory/research/YYYY-MM-DD-<topic>.md`
 
 ## Common Research Topics
 

package/dist/template/.opencode/command/ui-review.md

@@ -1,6 +1,6 @@
 ---
-description: Review UI/UX design or mockup
-argument-hint: "[path to image or component]"
+description: Review UI/UX design or mockup with optional bead tracking
+argument-hint: "[bead-id] [path to image or component]"
 agent: review
 ---
 
@@ -9,6 +9,10 @@ agent: review
 use_skill("ui-ux-research")
 use_skill("frontend-aesthetics")
 
+## Parse Arguments
+
+Extract bead ID (if provided) and path/component from `$ARGUMENTS`. If a bead ID is present, findings will be recorded to the bead.
+
 ## How to Analyze
 
 First, determine what you're reviewing. If it's an image or screenshot, start Gemini in interactive mode and reference the image to analyze it. If it's component code, analyze it directly with local tools. For large codebases spanning many files, use Gemini's non-interactive mode to scan the entire directory.
@@ -23,6 +27,26 @@ For accessibility, verify color contrast meets WCAG AA minimum, check for ARIA l
 
 Provide specific, actionable improvements: suggest alternative fonts, propose color palette changes, identify opportunities for subtle animations, and recommend layout enhancements. Include code snippets when they would help clarify the suggestion.
 
+## Record Findings
+
+### With Bead ID
+
+Update the bead with review findings:
+
+```bash
+bd edit <bead-id> --note "UI Review: <summary of issues found and recommendations>"
+```
+
+If review reveals implementation tasks, create child beads:
+
+```bash
+bd create --title "<specific UI fix>" --type task --parent <bead-id>
+```
+
+### Without Bead ID
+
+Output findings directly to the user.
+
 ## Output
 
 Summarize what issues you found, what specific changes you recommend, and show before/after comparisons for significant improvements.

package/dist/template/.opencode/dcp.jsonc

@@ -12,7 +12,7 @@
   // AI analysis strategies (deduplication runs automatically on every request)
   "strategies": {
     // Strategies to run when session goes idle
-    "onIdle": ["ai-analysis"],
+    "onIdle": [""],
     // Strategies to run when AI calls prune tool
     "onTool": ["ai-analysis"],
   },

package/dist/template/.opencode/memory/_templates/task-design.md

@@ -0,0 +1,59 @@
+# Design Document
+
+**Bead ID:** [bead-id]
+**Created:** [date]
+**Status:** Draft | Validated
+
+## Problem Statement
+
+What we're solving and why it matters:
+
+## Approaches Considered
+
+### Option A: [Name]
+
+- **Pros:** [advantages]
+- **Cons:** [drawbacks]
+
+### Option B: [Name]
+
+- **Pros:** [advantages]
+- **Cons:** [drawbacks]
+
+### Chosen Approach
+
+[Which option and why]
+
+## Architecture
+
+High-level structure and how components fit together:
+
+### Components
+
+- [Component 1]: [purpose]
+- [Component 2]: [purpose]
+
+### Data Flow
+
+[How data moves through the system]
+
+## Error Handling
+
+How the design handles failure cases:
+
+- [Error scenario 1]: [handling approach]
+- [Error scenario 2]: [handling approach]
+
+## Testing Strategy
+
+How we'll validate this design works:
+
+- [Testing approach 1]
+- [Testing approach 2]
+
+## Open Questions
+
+Unresolved items to address during implementation:
+
+- [ ] [Question 1]
+- [ ] [Question 2]

package/dist/template/.opencode/opencode.json

@@ -9,7 +9,7 @@
     },
     "build": {
       "description": "Primary development agent with full codebase access",
-      "model": "github-copilot/claude-opus-4.5"
+      "model": "proxypal/gemini-claude-opus-4-5-thinking"
     },
     "rush": {
       "description": "Fast primary agent for small, well-defined tasks",
@@ -35,60 +35,23 @@
   "experimental": {
     "batch_tool": true,
     "chatMaxRetries": 2,
-    "primary_tools": [
-      "edit",
-      "write",
-      "bash",
-      "prune"
-    ]
+    "primary_tools": ["edit", "write", "bash", "prune"]
   },
   "formatter": {
     "biome": {
-      "command": [
-        "npx",
-        "@biomejs/biome",
-        "check",
-        "--write",
-        "$FILE"
-      ],
-      "extensions": [
-        ".js",
-        ".jsx",
-        ".ts",
-        ".tsx",
-        ".json",
-        ".jsonc"
-      ]
+      "command": ["npx", "@biomejs/biome", "check", "--write", "$FILE"],
+      "extensions": [".js", ".jsx", ".ts", ".tsx", ".json", ".jsonc"]
     },
     "java-formatter": {
-      "command": [
-        "google-java-format",
-        "--replace",
-        "$FILE"
-      ],
+      "command": ["google-java-format", "--replace", "$FILE"],
       "environment": {
         "JAVA_HOME": "{env:JAVA_HOME}"
       },
-      "extensions": [
-        ".java"
-      ]
+      "extensions": [".java"]
     },
     "prettier": {
-      "command": [
-        "npx",
-        "prettier",
-        "--write",
-        "$FILE"
-      ],
-      "extensions": [
-        ".html",
-        ".css",
-        ".scss",
-        ".sass",
-        ".md",
-        ".yaml",
-        ".yml"
-      ]
+      "command": ["npx", "prettier", "--write", "$FILE"],
+      "extensions": [".html", ".css", ".scss", ".sass", ".md", ".yaml", ".yml"]
     }
   },
   "keybinds": {
@@ -110,10 +73,7 @@
       "type": "local"
     },
     "augment-context-engine": {
-      "command": [
-        "auggie",
-        "--mcp"
-      ],
+      "command": ["auggie", "--mcp"],
       "enabled": false,
       "type": "local"
     },
@@ -136,10 +96,7 @@
       "url": "http://localhost:27495/mcp"
     },
     "playwright": {
-      "command": [
-        "npx",
-        "@playwright/mcp@latest"
-      ],
+      "command": ["npx", "@playwright/mcp@latest"],
       "enabled": false,
       "type": "local"
     }

package/dist/template/.opencode/package.json

@@ -15,9 +15,9 @@
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^20.0.0",
+    "@types/node": "^20.19.27",
     "fs": "^0.0.1-security",
     "path": "^0.12.7",
-    "typescript": "^5.0.0"
+    "typescript": "^5.9.3"
   }
 }

package/dist/template/.opencode/superpowers/skills/brainstorming/SKILL.md

@@ -14,6 +14,7 @@ Start by understanding the current project context, then ask questions one at a
 ## The Process
 
 **Understanding the idea:**
+
 - Check out the current project state first (files, docs, recent commits)
 - Ask questions one at a time to refine the idea
 - Prefer multiple choice questions when possible, but open-ended is fine too
@@ -21,11 +22,13 @@ Start by understanding the current project context, then ask questions one at a
 - Focus on understanding: purpose, constraints, success criteria
 
 **Exploring approaches:**
+
 - Propose 2-3 different approaches with trade-offs
 - Present options conversationally with your recommendation and reasoning
 - Lead with your recommended option and explain why
 
 **Presenting the design:**
+
 - Once you believe you understand what you're building, present the design
 - Break it into sections of 200-300 words
 - Ask after each section whether it looks right so far
@@ -35,11 +38,13 @@ Start by understanding the current project context, then ask questions one at a
 ## After the Design
 
 **Documentation:**
-- Write the validated design to `docs/plans/YYYY-MM-DD-<topic>-design.md`
+
+- Write the validated design to `.beads/artifacts/<bead-id>/design.md` using template from `.opencode/memory/_templates/task-design.md`
 - Use elements-of-style:writing-clearly-and-concisely skill if available
 - Commit the design document to git
 
 **Implementation (if continuing):**
+
 - Ask: "Ready to set up for implementation?"
 - Use superpowers:using-git-worktrees to create isolated workspace
 - Use superpowers:writing-plans to create detailed implementation plan

package/dist/template/.opencode/superpowers/skills/writing-plans/SKILL.md

@@ -20,6 +20,7 @@ Assume they are a skilled developer, but know almost nothing about our toolset o
 ## Bite-Sized Task Granularity
 
 **Each step is one action (2-5 minutes):**
+
 - "Write the failing test" - step
 - "Run it to make sure it fails" - step
 - "Implement the minimal code to make the test pass" - step
@@ -46,10 +47,11 @@ Assume they are a skilled developer, but know almost nothing about our toolset o
 
 ## Task Structure
 
-```markdown
+````markdown
 ### Task N: [Component Name]
 
 **Files:**
+
 - Create: `exact/path/to/file.py`
 - Modify: `exact/path/to/existing.py:123-145`
 - Test: `tests/exact/path/to/test.py`
@@ -61,6 +63,7 @@ def test_specific_behavior():
     result = function(input)
     assert result == expected
 ```
+````
 
 **Step 2: Run test to verify it fails**
 
@@ -85,6 +88,7 @@ Expected: PASS
 git add tests/path/test.py src/path/file.py
 git commit -m "feat: add specific feature"
 ```
+
 ```
 
 ## Remember
@@ -98,7 +102,7 @@ git commit -m "feat: add specific feature"
 
 After saving the plan, offer execution choice:
 
-**"Plan complete and saved to `docs/plans/<filename>.md`. Two execution options:**
+**"Plan complete and saved to `.beads/artifacts/<bead-id>/plan.md`. Two execution options:**
 
 **1. Subagent-Driven (this session)** - I dispatch fresh subagent per task, review between tasks, fast iteration
 
@@ -114,3 +118,4 @@ After saving the plan, offer execution choice:
 **If Parallel Session chosen:**
 - Guide them to open new session in worktree
 - **REQUIRED SUB-SKILL:** New session uses superpowers:executing-plans
+```

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.1.0",
+	"version": "0.2.1",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"type": "module",
 	"repository": {