opencodekit 0.14.0 → 0.14.1

package/dist/index.js

@@ -750,7 +750,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.14.0",
+  version: "0.14.1",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   type: "module",
   repository: {
@@ -764,10 +764,7 @@ var package_default = {
   bin: {
     ock: "dist/index.js"
   },
-  files: [
-    "dist",
-    "README.md"
-  ],
+  files: ["dist", "README.md"],
   scripts: {
     dev: "bun run src/index.ts",
     build: "bun run build.ts && mkdir -p dist/template && rsync -av --exclude=node_modules --exclude=dist --exclude=.git --exclude=coverage --exclude=.next --exclude=.turbo --exclude=logs --exclude=package-lock.json .opencode/ dist/template/.opencode/",
@@ -779,14 +776,7 @@ var package_default = {
     lint: "biome check .",
     "lint:fix": "biome check --fix ."
   },
-  keywords: [
-    "cli",
-    "opencodekit",
-    "template",
-    "agents",
-    "mcp",
-    "opencode"
-  ],
+  keywords: ["cli", "opencodekit", "template", "agents", "mcp", "opencode"],
   author: "OpenCodeKit",
   license: "MIT",
   engines: {
@@ -812,9 +802,7 @@ var package_default = {
     "@types/node": "^22.10.1",
     typescript: "^5.7.2"
   },
-  trustedDependencies: [
-    "@beads/bd"
-  ]
+  trustedDependencies: ["@beads/bd"]
 };
 
 // src/commands/agent.ts
@@ -3777,6 +3765,7 @@ import {
   readdirSync as readdirSync3,
   writeFileSync as writeFileSync4
 } from "node:fs";
+import { homedir, platform } from "node:os";
 import { basename as basename2, dirname, join as join4 } from "node:path";
 import { fileURLToPath } from "node:url";
 var import_picocolors8 = __toESM(require_picocolors(), 1);
@@ -3795,6 +3784,15 @@ var EXCLUDED_FILES = [
   "yarn.lock",
   "pnpm-lock.yaml"
 ];
+function getGlobalConfigDir() {
+  const os = platform();
+  if (os === "win32") {
+    const appData = process.env.APPDATA || process.env.LOCALAPPDATA || join4(homedir(), "AppData", "Roaming");
+    return join4(appData, "opencode");
+  }
+  const xdgConfig = process.env.XDG_CONFIG_HOME || join4(homedir(), ".config");
+  return join4(xdgConfig, "opencode");
+}
 function detectMode(targetDir) {
   const opencodeDir = join4(targetDir, ".opencode");
   if (existsSync4(opencodeDir)) {
@@ -3854,9 +3852,46 @@ async function copyOpenCodeOnly(templateRoot, targetDir) {
 async function initCommand(options = {}) {
   if (process.argv.includes("--quiet"))
     return;
+  oe(import_picocolors8.default.bgCyan(import_picocolors8.default.black(" OpenCodeKit ")));
+  if (options.global) {
+    const globalDir = getGlobalConfigDir();
+    const os = platform();
+    const osName = os === "win32" ? "Windows" : os === "darwin" ? "macOS" : "Linux";
+    f2.info(`Installing to global config (${osName})`);
+    f2.info(`Target: ${import_picocolors8.default.cyan(globalDir)}`);
+    const templateRoot2 = getTemplateRoot();
+    if (!templateRoot2) {
+      f2.error("Template not found. Please reinstall opencodekit.");
+      $e(import_picocolors8.default.red("Failed"));
+      process.exit(1);
+    }
+    if (existsSync4(globalDir) && !options.force) {
+      f2.warn(`Global config already exists at ${globalDir}`);
+      f2.info(`Use ${import_picocolors8.default.cyan("--force")} to overwrite`);
+      $e("Nothing to do");
+      return;
+    }
+    const s2 = de();
+    s2.start("Copying to global config");
+    const opencodeSrc = join4(templateRoot2, ".opencode");
+    if (!existsSync4(opencodeSrc)) {
+      s2.stop("Failed");
+      f2.error("Template .opencode/ not found");
+      $e(import_picocolors8.default.red("Failed"));
+      process.exit(1);
+    }
+    await copyDir(opencodeSrc, globalDir);
+    s2.stop("Done");
+    le(`Global config installed at:
+${globalDir}
+
+This provides default agents, skills, and tools
+for all OpenCode projects on this machine.`, "Global Installation Complete");
+    $e(import_picocolors8.default.green("Ready!"));
+    return;
+  }
   const targetDir = process.cwd();
   const mode = detectMode(targetDir);
-  oe(import_picocolors8.default.bgCyan(import_picocolors8.default.black(" OpenCodeKit ")));
   if (mode === "already-initialized" && !options.force) {
     f2.warn("Already initialized (.opencode/ exists)");
     f2.info(`Use ${import_picocolors8.default.cyan("--force")} to reinitialize`);
@@ -6010,7 +6045,7 @@ var cli = cac("ock");
 cli.option("--verbose", "Enable verbose logging");
 cli.option("--quiet", "Suppress all output");
 cli.version(`${packageVersion}`);
-cli.command("init", "Initialize OpenCodeKit in current directory").option("--force", "Reinitialize even if already exists").option("--beads", "Also initialize .beads/ for multi-agent coordination").action(initCommand);
+cli.command("init", "Initialize OpenCodeKit in current directory").option("--force", "Reinitialize even if already exists").option("--beads", "Also initialize .beads/ for multi-agent coordination").option("--global", "Install to global OpenCode config (~/.config/opencode/)").action(initCommand);
 cli.command("agent [action]", "Manage agents (list, add, view)").action(async (action) => {
   if (!action) {
     console.log(`

package/dist/template/.opencode/AGENTS.md

@@ -20,6 +20,41 @@ Everything else is guidelines, not laws.
 
 If yes → Delegate. If no → Execute directly.
 
+## Question Tool
+
+**Rule**: Use `question` tool to gather user input when interpretation matters.
+
+### When to Use
+
+Use the question tool when ambiguous requests could lead to significantly different implementations—if "add auth" could mean OAuth, JWT, or session-based, ask before building the wrong thing. Use it when multiple valid approaches exist and user preference matters, like choosing between frameworks or patterns. Always ask before destructive operations like deleting branches, resetting hard, or force pushing. When user preferences affect the outcome—naming conventions, file structure, coding style—let them choose. For gathering multiple selections at once, use `multiple: true` to let users pick several options.
+
+### When NOT to Use
+
+Skip the question tool for trivial decisions where any reasonable choice works. If you already have enough context from the conversation, just proceed. When you can make a sensible default, mention what you're doing and continue—don't stop for permission on every small choice. Subagents like explore, scout, and review should never ask questions; they report findings back to the leader agent who decides what to do.
+
+### Question Design
+
+```typescript
+question({
+  questions: [
+    {
+      header: "Auth Type", // Max 12 chars
+      question: "Which authentication approach?",
+      multiple: false, // true for multi-select
+      options: [
+        { label: "JWT (Recommended)", description: "Stateless, scalable" },
+        { label: "Session-based", description: "Traditional, server-side" },
+        { label: "OAuth 2.0", description: "Third-party providers" },
+      ],
+    },
+  ],
+});
+```
+
+** Design Rule**: Use `question` tool to gather user input when interpretation matters.
+
+Put your recommended option first with "(Recommended)" in the label. Keep options to 3-5 choices—more than that overwhelms users. Write short, clear descriptions that explain the tradeoff. Users can always select "Other" to provide custom input, so you don't need to cover every edge case.
+
 ## Anti-Hallucination (The Truth)
 
 - **Check First**: Run `bd show <id>` before starting major work.
@@ -57,9 +92,9 @@ If yes → Delegate. If no → Execute directly.
 
 **Leader Only**: `build` and `rush` agents own the DB. Subagents read-only.
 
-- **Start**: `bd_init()` → `bd_claim()`
-- **Work**: `bd_reserve()` (Lock files!) → Edit
-- **Finish**: `bd_done()` → **RESTART SESSION**
+- **Start**: `bd ready` → `bd update <id> --status in_progress`
+- **Work**: `bd-reserve({ paths: [...] })` (Lock files!) → Edit
+- **Finish**: `bd close <id> --reason "..."` → `bd sync` → **RESTART SESSION**
 
 ## Core Constraints
 

package/dist/template/.opencode/agent/build.md

@@ -62,7 +62,50 @@ Before ANY action on a new request, do two things.
 
 **First, check skills.** If the request matches a skill trigger phrase, invoke that skill immediately. Skills are specialized workflows that handle specific tasks better than manual orchestration. Don't proceed until you've checked.
 
-**Second, classify the request.** Trivial requests (single file, known location) get direct tool use. Explicit requests (specific file and line, clear command) get immediate execution. Exploratory requests ("how does X work?") get delegated to @explore. Open-ended requests ("improve this", "add a feature") require codebase assessment first. Ambiguous requests where interpretations differ by 2x or more in effort require clarification—ask ONE question.
+**Second, classify the request.** Trivial requests (single file, known location) get direct tool use. Explicit requests (specific file and line, clear command) get immediate execution. Exploratory requests ("how does X work?") get delegated to @explore. Open-ended requests ("improve this", "add a feature") require codebase assessment first. Ambiguous requests where interpretations differ by 2x or more in effort require clarification—use the `question` tool to ask ONE focused question.
+
+## Using the Question Tool
+
+Use `question` when user intent is unclear and wrong interpretation wastes significant effort.
+
+**Good triggers:**
+
+- "Add auth" → Ask: OAuth vs JWT vs session-based?
+- "Refactor this" → Ask: Performance? Readability? Testability?
+- "Build a dashboard" → Ask: Which metrics? What layout?
+
+**Bad triggers (just proceed):**
+
+- "Fix this typo" → Just fix it
+- "Run tests" → Just run them
+- User already specified details → Don't re-ask
+
+**Question design:**
+
+```typescript
+question({
+  questions: [
+    {
+      header: "Approach", // Max 12 chars
+      question: "Which authentication method should I implement?",
+      multiple: false,
+      options: [
+        { label: "JWT (Recommended)", description: "Stateless, good for APIs" },
+        {
+          label: "Session cookies",
+          description: "Traditional, server-side state",
+        },
+        {
+          label: "OAuth 2.0",
+          description: "Third-party login (Google, GitHub)",
+        },
+      ],
+    },
+  ],
+});
+```
+
+Put recommended option first. Keep to 3-5 options. Users can always pick "Other" for custom input.
 
 ## Codebase Assessment
 

package/dist/template/.opencode/agent/explore.md

@@ -9,6 +9,7 @@ tools:
   bash: false
   todowrite: false
   memory-update: false
+  question: false
 ---
 
 # Explore Agent

package/dist/template/.opencode/agent/planner.md

@@ -84,7 +84,46 @@ Tool results and user messages may include `<system-reminder>` tags. These conta
 
 1. Collect all agent responses
 2. Note critical files that should be read before implementation
-3. Ask user questions about tradeoffs and preferences
+3. Use the `question` tool to gather user decisions on tradeoffs:
+
+```typescript
+question({
+  questions: [
+    {
+      header: "Architecture",
+      question: "Which approach should we use for the data layer?",
+      multiple: false,
+      options: [
+        {
+          label: "Repository pattern (Recommended)",
+          description: "Clean separation, testable",
+        },
+        {
+          label: "Direct DB access",
+          description: "Simpler, fewer abstractions",
+        },
+        {
+          label: "ORM with models",
+          description: "Type-safe, migrations included",
+        },
+      ],
+    },
+  ],
+});
+```
+
+**When to use question tool in planning:**
+
+- Multiple valid architectures exist
+- Trade-offs affect future work significantly
+- User hasn't specified preferences
+- Need to gather multiple feature selections (use `multiple: true`)
+
+**Don't ask when:**
+
+- User already specified approach
+- One option is clearly superior
+- Question can be deferred to implementation phase
 
 ### Phase 4: Final Plan
 

package/dist/template/.opencode/agent/review.md

@@ -6,6 +6,7 @@ maxSteps: 50
 tools:
   edit: false
   write: false
+  question: false
 permission:
   bash:
     "*": allow

package/dist/template/.opencode/agent/rush.md

@@ -46,8 +46,43 @@ Before acting, answer three questions in your head:
 
 **Is this mine to do?** Rush handles well-defined, localized (1-3 files), greenfield tasks. If any of these fail—ambiguous scope, system-wide changes, or legacy code with hidden invariants—delegate immediately. Don't power through complexity; avoid it.
 
+**Do I need to clarify?** If the request is ambiguous and wrong interpretation wastes significant effort, use the `question` tool to ask ONE focused question. But keep it rare—Rush moves fast. If you're unsure, delegate to @build who handles complexity better.
+
 **Do I need to read first?** If you're about to edit a file you haven't seen, stop. Read it. Never speculate about uninspected code.
 
+## Using the Question Tool (Sparingly)
+
+Rush uses questions rarely—only when wrong interpretation would waste significant effort AND the task is still small enough for Rush.
+
+**Good triggers (still ask fast):**
+
+- "Delete this" → Ask: Which files/branches specifically?
+- "Rename X" → Ask: New name preference?
+- Binary choice that user must decide
+
+**Bad triggers (delegate instead):**
+
+- "Add auth" → Too complex for Rush, delegate to @build
+- Multiple design decisions → Delegate to @planner
+- Research needed → Delegate to @scout
+
+**If you need to ask more than ONE question, the task is too complex for Rush. Delegate.**
+
+```typescript
+question({
+  questions: [
+    {
+      header: "Confirm",
+      question: "Delete feature/old-auth branch?",
+      options: [
+        { label: "Yes, delete it", description: "Removes remote and local" },
+        { label: "No, keep it", description: "Abort operation" },
+      ],
+    },
+  ],
+});
+```
+
 ## Bail Triggers
 
 Delegate immediately when you hit any of these:

package/dist/template/.opencode/agent/scout.md

@@ -8,6 +8,7 @@ tools:
   write: false
   bash: false
   memory-update: false
+  question: false
 ---
 
 # Scout Agent

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

@@ -275,7 +275,56 @@ bd create "[Idea name]" -t task -p 2
 
 ## Output
 
+```markdown
+Brainstorm Complete: $ARGUMENTS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Duration: [N] minutes
+Ideas generated: [N]
+Ideas evaluated: [N]
+
+Top 3:
+
+1. [Idea 1] - Score: [N]
+2. [Idea 2] - Score: [N]
+3. [Idea 3] - Score: [N]
+
+Recommendation: [Chosen approach]
+Confidence: [High/Medium/Low]
+
+Artifacts:
+
+- .beads/artifacts/<bead-id>/brainstorm.md (if bead)
+- Observation created ✓
+
+Follow-up beads: [N] created
 ```
+
+**Use question tool for next steps:**
+
+```typescript
+question({
+  questions: [
+    {
+      header: "Next Step",
+      question: "What should we do next with $ARGUMENTS?",
+      options: [
+        {
+          label: "Research approach (Recommended)",
+          description: "Validate with /research",
+        },
+        { label: "Create implementation plan", description: "Plan with /plan" },
+        {
+          label: "Explore more",
+          description: "Continue brainstorming other aspects",
+        },
+        { label: "Done for now", description: "Save findings, revisit later" },
+      ],
+    },
+  ],
+});
+```
+
 Brainstorm Complete: $ARGUMENTS
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
@@ -284,6 +333,7 @@ Ideas generated: [N]
 Ideas evaluated: [N]
 
 Top 3:
+
 1. [Idea 1] - Score: [N]
 2. [Idea 2] - Score: [N]
 3. [Idea 3] - Score: [N]
@@ -292,21 +342,25 @@ Recommendation: [Chosen approach]
 Confidence: [High/Medium/Low]
 
 Artifacts:
+
 - .beads/artifacts/<bead-id>/brainstorm.md (if bead)
 - Observation created ✓
 
 Follow-up beads: [N] created
+
 ```
 
 **Next steps:**
 
 ```
+
 If ready to proceed:
-  /research <bead-id>   # Validate approach
-  /plan <bead-id>       # Create implementation plan
+/research <bead-id> # Validate approach
+/plan <bead-id> # Create implementation plan
 
 If need more exploration:
-  /brainstorm <new-aspect>   # Continue ideation
+/brainstorm <new-aspect> # Continue ideation
+
 ```
 
 ## Anti-Patterns
@@ -316,3 +370,4 @@ If need more exploration:
 - ❌ **Infinite brainstorming** - Time box and decide
 - ❌ **No decision** - Brainstorming must produce a recommendation
 - ❌ **No capture** - Undocumented ideas are lost ideas
+```

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

@@ -116,17 +116,27 @@ git commit -m "$ARGUMENTS: [what was done]
 Closes: $ARGUMENTS"
 ```
 
-## Close The Task (Ask First)
+## Close The Task (Use Question Tool)
 
-**Ask the user:**
-
-```
-Close bead $ARGUMENTS?
-- Yes, close it
-- No, keep it open for now
+```typescript
+question({
+  questions: [
+    {
+      header: "Close",
+      question: "Should I close bead $ARGUMENTS?",
+      options: [
+        {
+          label: "Yes, close it (Recommended)",
+          description: "All gates passed, task complete",
+        },
+        { label: "No, keep open", description: "Need more work or review" },
+      ],
+    },
+  ],
+});
 ```
 
-If user confirms:
+If user confirms close:
 
 ```bash
 bd close $ARGUMENTS --reason "Completed: [1-line summary]"

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

@@ -115,23 +115,32 @@ git status
 git diff --cached --stat
 ```
 
-**Present to user:**
+**Use question tool to get commit decision:**
 
+```typescript
+question({
+  questions: [
+    {
+      header: "Commit",
+      question: "Fix Complete: $ARGUMENTS. What should I do next?",
+      options: [
+        {
+          label: "Commit changes (Recommended)",
+          description: "Git commit and bd sync",
+        },
+        {
+          label: "Show diff first",
+          description: "Review changes before committing",
+        },
+        {
+          label: "Skip commit",
+          description: "I'll review and commit manually",
+        },
+      ],
+    },
+  ],
+});
 ```
-Fix Complete: $ARGUMENTS
-━━━━━━━━━━━━━━━━━━━━━━━
-
-Root cause: [brief]
-Changes: [files]
-Tests: Pass ✓
-
-Would you like me to:
-1. Commit these changes
-2. Show full diff first
-3. Skip commit (I'll review manually)
-```
-
-**Wait for user confirmation before committing.**
 
 If user confirms:
 

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

@@ -67,7 +67,25 @@ If dirty, ask whether to stash, commit, or continue.
 Create a branch if not already on one for this task:
 
 ```bash
-git checkout -b $ARGUMENTS 2>/dev/null || echo "Already on branch"
+# Get current branch (parent branch)
+PARENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
+
+# Get task title for readable branch name
+BEAD_INFO=$(bd show $ARGUMENTS --json 2>/dev/null)
+BEAD_TITLE=$(echo "$BEAD_INFO" | jq -r '.title // ""' | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | cut -c1-40)
+BEAD_TYPE=$(echo "$BEAD_INFO" | jq -r '.type // "task"')
+
+# Map bead type to branch prefix
+case "$BEAD_TYPE" in
+  "bug") PREFIX="fix" ;;
+  "feature"|"epic") PREFIX="feat" ;;
+  "refactor") PREFIX="refactor" ;;
+  *) PREFIX="feat" ;;
+esac
+
+# Create branch: <parent>/<type>/<bead-id>-<description>
+BRANCH_NAME="${PARENT_BRANCH}/${PREFIX}/$ARGUMENTS-${BEAD_TITLE}"
+git checkout -b "$BRANCH_NAME" 2>/dev/null || echo "Already on branch"
 ```
 
 Mark the task in progress (if not already):
@@ -104,7 +122,7 @@ First, get a quick codebase overview:
 
 ```typescript
 // Quick overview of relevant directories
-repo-map({ path: "src", format: "compact", maxDepth: 3 });
+repo - map({ path: "src", format: "compact", maxDepth: 3 });
 ```
 
 Then search for relevant patterns and learnings:
@@ -296,25 +314,32 @@ git status
 git diff --cached --stat
 ```
 
-**Present to user:**
+**Use question tool to get commit decision:**
 
+```typescript
+question({
+  questions: [
+    {
+      header: "Commit",
+      question: "Implementation Complete: $ARGUMENTS. What should I do next?",
+      options: [
+        {
+          label: "Commit changes (Recommended)",
+          description: "Git commit and bd sync",
+        },
+        {
+          label: "Show diff first",
+          description: "Review changes before committing",
+        },
+        {
+          label: "Skip commit",
+          description: "I'll review and commit manually",
+        },
+      ],
+    },
+  ],
+});
 ```
-Implementation Complete: $ARGUMENTS
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Type: [epic/task/subtask]
-Tests: Pass ✓
-Changes: [files modified]
-
-Subtasks: [N completed / M total] (if applicable)
-
-Would you like me to:
-1. Commit these changes
-2. Show full diff first
-3. Skip commit (I'll review manually)
-```
-
-**Wait for user confirmation before committing.**
 
 If user confirms:
 

package/dist/template/.opencode/command/import-plan.md

@@ -46,7 +46,7 @@ Before importing, check for existing beads with similar titles:
 
 Compare plan titles against existing beads:
 
-```
+````
 Duplicate Check:
 ━━━━━━━━━━━━━━━━
 
@@ -59,8 +59,19 @@ Options:
 2. Force import (create duplicates)
 3. Cancel import
 
-Select option (1/2/3):
-```
+```typescript
+question({
+  questions: [{
+    header: "Duplicates",
+    question: "Potential duplicates found. What should I do?",
+    options: [
+      { label: "Skip duplicates (Recommended)", description: "Import only new items" },
+      { label: "Force import", description: "Create duplicate beads anyway" },
+      { label: "Cancel import", description: "Stop and review plan" }
+    ]
+  }]
+});
+````
 
 If `--force` flag set, skip this check and import everything.
 
@@ -78,7 +89,7 @@ Parse the plan for:
 
 Report:
 
-```
+````
 Plan Analysis: [filename]
 ━━━━━━━━━━━━━━━━━━━━━━━━
 
@@ -95,10 +106,21 @@ Structure:
 │   └── [Issue 1] [L] → depends on [Epic 1/Issue 2]
 └── ...
 
-Proceed with import? (yes/modify/cancel)
-```
-
-**STOP and wait for approval** (unless `--dry-run`, then just show preview).
+```typescript
+question({
+  questions: [{
+    header: "Import",
+    question: "Plan analyzed. Should I proceed with import?",
+    options: [
+      { label: "Proceed with import (Recommended)", description: "Create epics and issues" },
+      { label: "Modify plan", description: "Need changes before importing" },
+      { label: "Cancel", description: "Stop and review plan" }
+    ]
+  }]
+});
+````
+
+**STOP and wait for user approval** (unless `--dry-run`, then just show preview).
 
 ---