opencodekit 0.15.14 → 0.15.16

package/README.md

@@ -80,8 +80,8 @@ Background Plugins:
 Supporting:
   • 30+ Skills (domain expertise loaded on-demand)
   • 26+ Commands (workflow shortcuts)
-  • 3 MCP Services (context7, exa) + grep-search tool + skill-embedded MCPs
-  • Custom Tools (memory-*, observation, grep-search, lsp-*)
+  • 3 MCP Services (context7, exa) + grepsearch tool + skill-embedded MCPs
+  • Custom Tools (memory-*, observation, grepsearch, lsp-*)
   • Beads task tracking (`bd` CLI for multi-session workflows)
   • Manual Handoffs (clean phase transitions)
 ```
@@ -223,9 +223,9 @@ You've successfully set up OpenCodeKit when:
 - ✅ Skills load on-demand (30+ skills)
 - ✅ Delegation is clear (build → specialized subagents)
 - ✅ `/handoff` creates portable bundles (.opencode/memory/handoffs/)
-- ✅ Tools configured (context7, grep-search + skill-embedded MCP)
+- ✅ Tools configured (context7, grepsearch + skill-embedded MCP)
 - ✅ Background plugins active (enforcer, compactor, truncator)
-- ✅ Custom tools available (memory-_, observation, grep-search, lsp-_)
+- ✅ Custom tools available (memory-_, observation, grepsearch, lsp-_)
 - ✅ Environment variables set (.opencode/.env with API keys)
 
 ---

package/dist/index.js

@@ -750,16 +750,9 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.15.14",
+  version: "0.15.16",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
-  keywords: [
-    "agents",
-    "cli",
-    "mcp",
-    "opencode",
-    "opencodekit",
-    "template"
-  ],
+  keywords: ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
   license: "MIT",
   author: "OpenCodeKit",
   repository: {
@@ -769,10 +762,7 @@ var package_default = {
   bin: {
     ock: "dist/index.js"
   },
-  files: [
-    "dist",
-    "README.md"
-  ],
+  files: ["dist", "README.md"],
   type: "module",
   publishConfig: {
     access: "public",
@@ -816,9 +806,7 @@ var package_default = {
   engines: {
     bun: ">=1.3.2"
   },
-  trustedDependencies: [
-    "@beads/bd"
-  ]
+  trustedDependencies: ["@beads/bd"]
 };
 
 // src/commands/agent.ts
@@ -3884,13 +3872,13 @@ var MODEL_PRESETS = {
     }
   },
   recommend: {
-    model: "proxypal/gemini-claude-opus-4-5-thinking",
+    model: "github-copilot/claude-opus-4.5",
     agents: {
-      build: "proxypal/gemini-claude-opus-4-5-thinking",
+      build: "github-copilot/claude-opus-4.5",
       plan: "openai/gpt-5.2",
       review: "openai/gpt-5.2-codex",
       explore: "proxypal/gemini-3-flash-preview",
-      general: "opencode/glm-4.7-free",
+      general: "github-copilot/claude-haiku-4.5",
       looker: "proxypal/gemini-3-flash-preview",
       vision: "proxypal/gemini-3-pro-preview",
       scout: "proxypal/gemini-3-flash-preview",

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

@@ -359,7 +359,26 @@ Before you start implementing, verify the requirements are clear. If interpretat
 
 ### Before claiming done
 
-Before you claim completion, verify these things: you ran `bd close <id>`, you ran `bd sync`, there are no pending LSP nudges, and you saved observations for any important decisions or patterns.
+Before you claim completion, verify these things:
+
+1. **Run Oracle critique** on any significant code changes:
+
+   ```typescript
+   oracle({
+     question: "Is this solution overcomplicated? Could it be 10x simpler?",
+     mode: "critique",
+     context: "<summary of changes>",
+   });
+   ```
+
+   If Oracle suggests simplification, implement it before proceeding.
+
+2. You ran `bd close <id>` with a meaningful reason
+3. You ran `bd sync` to push changes
+4. There are no pending LSP nudges
+5. You saved observations for any important decisions or patterns
+
+**DO NOT skip the Oracle critique for non-trivial changes.** This prevents bloated, overcomplicated solutions that could be 10x simpler.
 
 ---
 

package/dist/template/.opencode/README.md

@@ -189,8 +189,8 @@ Plugins run automatically in every session:
    - Requires: EXA_API_KEY
    - GitHub: https://github.com/exa-labs/exa-mcp-server
 
-3. **grep-search** - Search 1M+ public GitHub repositories via grep.app
-   - Native tool: `grep_search({ query: "...", language: [...] })`
+3. **grepsearch** - Search 1M+ public GitHub repositories via grep.app
+   - Native tool: `grepsearch({ query: "...", language: [...] })`
    - No API key needed (public service)
    - Direct HTTP wrapper (no MCP overhead)
 

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

@@ -4,13 +4,13 @@ mode: primary
 temperature: 0.2
 permission:
   write:
-    "*": deny
+    "*": ask
     ".beads/artifacts/*/*.md": allow
     ".opencode/memory/plans/*.md": allow
     ".opencode/memory/project/*.md": allow
     ".opencode/plans/*.md": allow
   edit:
-    "*": deny
+    "*": ask
     ".beads/artifacts/*/*.md": allow
     ".opencode/memory/plans/*.md": allow
     ".opencode/memory/project/*.md": allow

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

@@ -93,7 +93,7 @@ Run 2-3 tool calls in parallel.
 **Triggers:** "how do others", "compare", "best practices", "production patterns"
 **Target:** Summary, 3-5 code examples, tradeoffs, recommendation
 
-1. Search GitHub with grep_search (vary queries for different angles)
+1. Search GitHub with grepsearch (vary queries for different angles)
 2. Compare 3-5 implementations from different repositories
 3. Synthesize common patterns
 4. Note tradeoffs and edge cases
@@ -101,8 +101,8 @@ Run 2-3 tool calls in parallel.
 ```typescript
 // Run 4-6 external tool calls in parallel
 // Adapt language filter based on research context
-grep_search({ query: "<pattern 1>" }); // No language filter = search all
-grep_search({ query: "<pattern 2>", language: "<relevant lang>" });
+grepsearch({ query: "<pattern 1>" }); // No language filter = search all
+grepsearch({ query: "<pattern 2>", language: "<relevant lang>" });
 codesearch({ query: "<API usage>", tokensNum: 5000 });
 context7_query_docs({ libraryId: "<id>", topic: "<feature>" });
 ```
@@ -123,7 +123,7 @@ Run 4-6 tool calls in parallel.
 
 Every code reference must include a GitHub permalink. Never link to a branch or tag that can change.
 
-To construct a permalink: use `grep_search` to find code, then build the URL from the repository and file path returned. Format: `https://github.com/owner/repo/blob/<sha>/path/to/file#L10-L20`.
+To construct a permalink: use `grepsearch` to find code, then build the URL from the repository and file path returned. Format: `https://github.com/owner/repo/blob/<sha>/path/to/file#L10-L20`.
 
 ## Tool Priority (External Sources Only)
 
@@ -132,7 +132,7 @@ To construct a permalink: use `grep_search` to find code, then build the URL fro
 | 1        | memory-search | Past research findings                    | Instant |
 | 2        | context7      | Official library docs                     | Fast    |
 | 3        | codesearch    | Exa Code API for SDK/library patterns     | Fast    |
-| 4        | grep_search   | Cross-repo GitHub code search (1M+ repos) | Medium  |
+| 4        | grepsearch   | Cross-repo GitHub code search (1M+ repos) | Medium  |
 | 5        | webfetch      | Specific doc URLs, READMEs, changelogs    | Medium  |
 | 6        | opensrc + LSP | Clone & analyze source code               | Slow    |
 | 7        | websearch     | Tutorials, blog posts, recent news        | Slow    |
@@ -210,14 +210,14 @@ context7_query_docs({ libraryId: nodeId, topic: "streams API" });
 | Empty results     | Try related terms or "API reference"           |
 | API error         | Verify CONTEXT7_API_KEY is set (optional)      |
 
-## grep_search Tool
+## grepsearch Tool
 
 Use for cross-repository code search across 1M+ public GitHub repositories.
 
 ### Schema
 
 ```typescript
-grep_search({
+grepsearch({
   query: string,              // Required - search pattern (literal code, not keywords)
   repo?: string,              // Optional - filter to specific repo (e.g., "vercel/ai")
   language?: string[],        // Optional - e.g., ["TypeScript", "TSX"]
@@ -247,22 +247,22 @@ grep_search({
 
 ```typescript
 // Basic repo search
-grep_search({ query: "batch_tool", repo: "anomalyco/opencode" });
+grepsearch({ query: "batch_tool", repo: "anomalyco/opencode" });
 
 // With language filter
-grep_search({
+grepsearch({
   query: "getServerSession",
   language: ["TypeScript", "TSX"],
 });
 
 // Regex pattern (multi-line)
-grep_search({
+grepsearch({
   query: "(?s)useEffect\\(\\(\\) => {.*removeEventListener",
   useRegexp: true,
 });
 
 // Path filter for specific files
-grep_search({
+grepsearch({
   query: "CORS(",
   language: ["Python"],
   matchCase: true,
@@ -406,8 +406,8 @@ Structure your response as:
 
 ```
 context7 fails → try codesearch for patterns
-codesearch empty → try grep_search with broader query
-grep_search empty → webfetch specific doc URLs if known
+codesearch empty → try grepsearch with broader query
+grepsearch empty → webfetch specific doc URLs if known
 still stuck → opensrc clone + LSP analysis
 last resort → websearch for tutorials/blogs
 ```
@@ -417,10 +417,10 @@ last resort → websearch for tutorials/blogs
 **context7 doesn't find library:**
 
 1. Try `codesearch({ query: "<library> <function> example" })`
-2. Try `grep_search({ query: "import.*from.*<library>", language: ["TypeScript"] })`
+2. Try `grepsearch({ query: "import.*from.*<library>", language: ["TypeScript"] })`
 3. Clone with `npx opensrc <library>` and read source
 
-**grep_search returns nothing:**
+**grepsearch returns nothing:**
 
 - Broaden query: search concepts, not exact function names
 - Remove specific repo filter to search across all repos
@@ -429,7 +429,7 @@ last resort → websearch for tutorials/blogs
 - Search for error messages, config patterns, or import statements
 - Fall back to `codesearch` for conceptual queries
 
-**grep_search API error:**
+**grepsearch API error:**
 
 - The grep.app API may be temporarily unavailable
 - Fall back to `codesearch` for similar functionality
@@ -458,6 +458,6 @@ NO URL GUESSING: Only use URLs from tools or user input.
 CITE EVERYTHING: No claims without source links.
 
 Quick: context7 → codesearch → websearch (2-3 parallel calls)
-Deep: grep_search (4-6 parallel calls) → compare 3-5 repos → synthesize
-Fallback: context7 → codesearch → grep_search → webfetch → opensrc → websearch
+Deep: grepsearch (4-6 parallel calls) → compare 3-5 repos → synthesize
+Fallback: context7 → codesearch → grepsearch → webfetch → opensrc → websearch
 ```

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

@@ -212,7 +212,7 @@ context7_resolve_library_id({
 });
 
 // Real-world implementations
-grep_search({
+grepsearch({
   query: "[pattern to find]",
   language: ["TypeScript", "TSX"],
   path: "components/",

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

@@ -50,7 +50,7 @@ Return file:line references for all findings.`,
 
 ### External Research → @scout (this agent)
 
-Scout handles external sources (context7, grep_search, codesearch, etc.)
+Scout handles external sources (context7, grepsearch, codesearch, etc.)
 
 ### Parallel Execution
 
@@ -60,7 +60,7 @@ Run internal and external research in parallel:
 // Launch both in parallel
 task({ subagent_type: "explore", prompt: "LSP analysis of..." });
 context7_resolve_library_id({ libraryName: "<lib>" });
-grep_search({ query: "<pattern>", language: "TypeScript" });
+grepsearch({ query: "<pattern>", language: "TypeScript" });
 ```
 
 ## Load Context
@@ -107,7 +107,7 @@ If memory search fails (Ollama not running), continue to external sources.
 2. **Official docs** (high trust) - What does the library documentation say?
 3. **Context7** (high trust) - API usage and examples
 4. **Source code** (high trust) - Library implementation (use `source-code-research` skill)
-5. **GitHub examples** (medium trust) - Real-world patterns via codesearch/grep_search
+5. **GitHub examples** (medium trust) - Real-world patterns via codesearch/grepsearch
 6. **Web search** (lower trust) - Only if tiers 1-5 don't answer
 
 ## Research
@@ -161,7 +161,7 @@ npx opensrc <owner>/<repo>         # GitHub repo
 
 ```typescript
 codesearch({ query: "<API usage pattern>", tokensNum: 5000 });
-grep_search({ query: "<code pattern>", language: "TypeScript" });
+grepsearch({ query: "<code pattern>", language: "TypeScript" });
 ```
 
 ## Validate Findings

package/dist/template/.opencode/memory/observations/2026-01-28-decision-gh-grep-mcp-wrapper-vs-native-grep-searc.md

@@ -4,18 +4,18 @@ created: 2026-01-28T16:59:35.621Z
 confidence: high
 valid_until: null
 superseded_by: null
-concepts: ["grep-search", "MCP", "native tool", "architecture", "best practices"]
+concepts: ["grepsearch", "MCP", "native tool", "architecture", "best practices"]
 ---
 
-# 🎯 gh-grep MCP wrapper vs native grep-search tool
+# 🎯 gh-grep MCP wrapper vs native grepsearch tool
 
 🟢 **Confidence:** high
 
 Created two implementations for GitHub code search:
 
-1. **Native tool** (.opencode/tool/grep-search.ts): TypeScript wrapper around grep.app API - WORKING ✅
+1. **Native tool** (.opencode/tool/grepsearch.ts): TypeScript wrapper around grep.app API - WORKING ✅
 2. **MCP skill** (.opencode/skill/gh-grep/): Skill wrapper that calls uvx grep-mcp server - BROKEN ❌
 
-The MCP server has an argument parsing bug ('str' object has no attribute 'get') that prevents tool execution. Even the SKILL.md documentation admits: "Note: The MCP server (grep-mcp) may have bugs. The native grep_search tool is recommended."
+The MCP server has an argument parsing bug ('str' object has no attribute 'get') that prevents tool execution. Even the SKILL.md documentation admits: "Note: The MCP server (grep-mcp) may have bugs. The native grepsearch tool is recommended."
 
 **Key insight**: We already documented the problem and recommended against the MCP approach. The native tool works perfectly and doesn't require external process dependencies.

package/dist/template/.opencode/memory/observations/2026-01-29-learning-karpathy-llm-coding-insights-dec-2025.md

@@ -0,0 +1,44 @@
+---
+type: learning
+created: 2026-01-29T01:59:58.781Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["karpathy", "llm-coding", "best-practices", "declarative", "test-first", "sycophancy", "simplicity", "leverage"]
+---
+
+# 📚 Karpathy LLM coding insights Dec 2025
+
+🟢 **Confidence:** high
+
+From Andrej Karpathy's analysis of LLM-assisted coding (Dec 2025):
+
+KEY PROBLEMS:
+1. Wrong assumptions - models assume without checking
+2. No confusion management - don't seek clarifications
+3. Sycophancy - don't push back when they should
+4. Overcomplicate - bloated abstractions (1000 lines → 100 lines possible)
+5. Side effects - change unrelated code
+6. No cleanup - dead code remains
+
+BEST PRACTICES:
+1. DECLARATIVE > IMPERATIVE - give success criteria, not step-by-step instructions
+2. TEST-FIRST - write tests, then pass them (TDD skill)
+3. LOOPING - LLMs excel at looping until goals met (verification skill)
+4. NAIVE → OPTIMIZED - write correct first, then optimize
+5. BROWSER MCP - put agents in feedback loops with real systems
+
+LEVERAGE PRINCIPLE:
+"Don't tell it what to do, give it success criteria and watch it go"
+
+OPENCODE ALIGNMENT:
+- Oracle tool → anti-sycophancy (critique mode)
+- Question tool → clarification seeking
+- TDD skill → test-first workflow
+- Verification skill → looping until green
+- LSP chain → prevent wrong assumptions
+
+MISSING:
+- Explicit simplicity gate ("can this be 10x simpler?")
+- Dead code cleanup protocol
+- Side-effect prevention checklist

package/dist/template/.opencode/memory/research/opencode-mcp-bug-report.md

@@ -100,7 +100,7 @@ The bug is in **OpenCode's tool response handler**, not the MCP connection layer
 
 - `context7_resolve-library-id` - Native HTTP wrapper (works)
 - `context7_query-docs` - Native HTTP wrapper (works)
-- `grep-search` - Native HTTP wrapper (works)
+- `grepsearch` - Native HTTP wrapper (works)
 - `codesearch` (Exa Code API) - works
 - `websearch` (Exa Web Search) - works