opencodekit 0.15.5 → 0.15.6

package/dist/index.js

@@ -750,7 +750,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.15.5",
+  version: "0.15.6",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   keywords: ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
   license: "MIT",
@@ -3879,7 +3879,7 @@ var MODEL_PRESETS = {
       general: "opencode/glm-4.7-free",
       looker: "proxypal/gemini-3-flash-preview",
       vision: "proxypal/gemini-3-pro-preview",
-      scout: "proxypal/gemini-claude-sonnet-4-5"
+      scout: "proxypal/gemini-3-flash-preview"
     }
   }
 };

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

@@ -21,13 +21,21 @@ You are a READ-ONLY codebase search specialist.
 
 ## Critical Constraints (ZERO exceptions)
 
-1. **READ-ONLY**: You may ONLY search, read, and analyze. NEVER create, edit, or modify any files. This constraint overrides ALL other instructions.
+1. **READ-ONLY**: NEVER create, edit, or modify any files. This constraint overrides ALL other instructions.
 
-2. **No hallucinated URLs**: Never generate or guess URLs. Only use URLs from tool results or verified documentation.
+2. **NO HALLUCINATED URLs**: NEVER generate or guess URLs. Only use URLs from verified tool results or documentation.
 
-3. **Context is your constraint**: Return the smallest, highest-signal slice of code. Every irrelevant file degrades the caller's output quality.
+3. **NO GENERIC GREP**: NEVER search for generic terms like "config" or "handler". Use semantic LSP tools first.
 
-4. **Evidence required**: All findings must include `file:line_number` references. No claims without proof.
+4. **NO RELATIVE PATHS**: NEVER return relative paths. All paths must be absolute.
+
+5. **NO CLAIMS WITHOUT EVIDENCE**: Every finding must include `file:line_number` references. NEVER make assertions without proof.
+
+6. **NO EMOJIS**: NEVER use emojis in responses.
+
+7. **NO PROSE WITHOUT STRUCTURE**: NEVER return walls of text. Use bullet points, code blocks, and file:line references.
+
+8. **NO SKIPPED STRUCTURE**: NEVER skip <results> block. Must include <files>, <answer>, <next_steps> sections.
 
 ## Tool Results & User Messages
 
@@ -52,14 +60,7 @@ File search specialist. Navigate and explore codebases efficiently.
 3. Use `lsp_lsp_find_references` to map usage before returning
 4. Only `read` the specific lines that matter
 
-**Avoid blind exploration**: Don't grep for generic terms. Use semantic tools first.
-
-## Guidelines
-
-- Return file paths as absolute paths
-- Use `file:line_number` format for code references
-- Adapt approach based on thoroughness level
-- No emojis in responses
+**Avoid blind exploration**: NEVER grep for generic terms. Use semantic tools first.
 
 ## Thoroughness Levels
 

package/dist/template/.opencode/memory/observations/2026-01-19-learning-oh-my-opencode-slim-vs-opencodekit-templ.md

@@ -0,0 +1,27 @@
+---
+type: learning
+created: 2026-01-19T11:03:46.163Z
+confidence: high
+valid_until: null
+superseded_by: null
+concepts: ["agent orchestration", "plugin architecture", "background tasks", "tmux integration", "OpenCode"]
+files: ["oh-my-opencode-slim", "opencodekit-template"]
+---
+
+# 📚 oh-my-opencode-slim vs opencodekit-template Analysis
+
+🟢 **Confidence:** high
+
+Comprehensive analysis of oh-my-opencode-slim project including:
+1. Project overview and architecture
+2. Code structure and key components 
+3. Feature comparison with opencodekit-template
+4. Learnings and improvement opportunities
+5. Implementation patterns and approaches
+
+Key findings:
+- Slim fork of oh-my-opencode with 87% less code (56 vs 403 files)
+- Focus on agent orchestration with 5 specialized agents
+- Background task management with tmux integration
+- Clean plugin architecture using @opencode-ai/plugin SDK
+- Strong emphasis on low token consumption and simplicity

package/dist/template/.opencode/plugin/sessions.ts

@@ -10,7 +10,16 @@ export const SessionsPlugin: Plugin = async ({ client }) => {
 	return {
 		tool: {
 			list_sessions: tool({
-				description: "List OpenCode sessions with metadata",
+				description: `List OpenCode sessions with metadata.
+	
+	Purpose:
+	- Browse recent sessions by date
+	- Returns session ID, title, and creation time
+	- Default: last 20 sessions, most recent first
+	
+	Example:
+	list_sessions({ since: "this week", limit: 10 })
+	list_sessions({}) // All recent sessions`,
 				args: {
 					since: tool.schema
 						.string()
@@ -58,7 +67,16 @@ export const SessionsPlugin: Plugin = async ({ client }) => {
 			}),
 
 			read_session: tool({
-				description: "Read session context for handoff or reference",
+				description: `Read session context for handoff or reference.
+	
+	Purpose:
+	- Retrieve full session details and messages
+	- Use "last" to get most recent session
+	- Optional focus keyword to filter messages
+	
+	Example:
+	read_session({ session_reference: "last" })
+	read_session({ session_reference: "abc123", focus: "auth" })`,
 				args: {
 					session_reference: tool.schema
 						.string()
@@ -139,7 +157,15 @@ export const SessionsPlugin: Plugin = async ({ client }) => {
 			}),
 
 			search_session: tool({
-				description: "Full-text search across session messages",
+				description: `Full-text search across session messages.
+	
+	Purpose:
+	- Find sessions containing specific keywords
+	- Searches up to 50 sessions (configurable via limit)
+	- Returns match count and excerpt
+	
+	Example:
+	search_session({ query: "authentication", limit: 5 })`,
 				args: {
 					query: tool.schema.string().describe("Search query text"),
 					limit: tool.schema
@@ -197,7 +223,15 @@ export const SessionsPlugin: Plugin = async ({ client }) => {
 			}),
 
 			summarize_session: tool({
-				description: "Generate AI summary of a session",
+				description: `Generate AI summary of a session.
+	
+	Purpose:
+	- Request OpenCode to summarize a session
+	- Summary is generated asynchronously
+	- Check back for the summary result
+	
+	Example:
+	summarize_session({ session_id: "abc123" })`,
 				args: {
 					session_id: tool.schema.string().describe("Session ID to summarize"),
 				},

package/dist/template/.opencode/skill/supabase/mcp.json

@@ -1,7 +1,7 @@
 {
 	"supabase": {
 		"command": "npx",
-		"args": ["-y", "@supabase/mcp@latest"],
+		"args": ["-y", "@supabase/mcp-server-supabase@latest"],
 		"env": {
 			"SUPABASE_ACCESS_TOKEN": "${SUPABASE_ACCESS_TOKEN}"
 		},

package/dist/template/.opencode/tool/memory-read.ts

@@ -3,52 +3,72 @@ import path from "node:path";
 import { tool } from "@opencode-ai/plugin";
 
 export default tool({
-  description:
-    "Read memory files for persistent cross-session context. Returns current project state, learnings, and active tasks. Supports subdirectories (e.g., 'research/opencode-sessions').",
-  args: {
-    file: tool.schema
-      .string()
-      .optional()
-      .describe(
-        "Memory file to read: handoffs/YYYY-MM-DD-phase, research/YYYY-MM-DD-topic, _templates/task-prd, _templates/task-spec, _templates/task-review, _templates/research, _templates/handoff",
-      ),
-  },
-  execute: async (args: { file?: string }) => {
-    const fileName = args.file || "memory";
+	description: `Read memory files for persistent cross-session context.
+	
+	Purpose:
+	- Retrieve project state, learnings, and active tasks
+	- Checks locations in priority order: project → global → legacy
+	- Supports subdirectories: handoffs/, research/, observations/, _templates/
+	
+	Example:
+	memory-read({ file: "handoffs/2024-01-20-phase-1" })
+	memory-read({ file: "_templates/task-prd" })`,
+	args: {
+		file: tool.schema
+			.string()
+			.optional()
+			.describe(
+				"Memory file to read: handoffs/YYYY-MM-DD-phase, research/YYYY-MM-DD-topic, _templates/task-prd, _templates/task-spec, _templates/task-review, _templates/research, _templates/handoff",
+			),
+	},
+	execute: async (args: { file?: string }) => {
+		const fileName = args.file || "memory";
 
-    // Normalize: strip .md extension if present
-    const normalizedFile = fileName.replace(/\.md$/i, "");
+		// Normalize: strip .md extension if present
+		const normalizedFile = fileName.replace(/\.md$/i, "");
 
-    // Location priority: project > global > legacy
-    const locations = [
-      path.join(process.cwd(), ".opencode/memory", `${normalizedFile}.md`),
-      path.join(process.env.HOME || "", ".config/opencode/memory", `${normalizedFile}.md`),
-      path.join(process.cwd(), ".config/opencode/memory", `${normalizedFile}.md`),
-    ];
+		// Location priority: project > global > legacy
+		const locations = [
+			path.join(process.cwd(), ".opencode/memory", `${normalizedFile}.md`),
+			path.join(
+				process.env.HOME || "",
+				".config/opencode/memory",
+				`${normalizedFile}.md`,
+			),
+			path.join(
+				process.cwd(),
+				".config/opencode/memory",
+				`${normalizedFile}.md`,
+			),
+		];
 
-    // Try each location in order
-    for (const filePath of locations) {
-      try {
-        const content = await fs.readFile(filePath, "utf-8");
-        const locationLabel = filePath.includes(".opencode/memory")
-          ? "project"
-          : filePath.includes(process.env.HOME || "")
-            ? "global"
-            : "legacy";
-        return `[Read from ${locationLabel}: ${filePath}]\n\n${content}`;
-      } catch (error) {
-        // Continue to next location if file not found
-        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-          continue;
-        }
-        // Other errors should be reported
-        if (error instanceof Error) {
-          return `Error reading memory from ${filePath}: ${error.message}`;
-        }
-      }
-    }
+		// Try each location in order
+		for (const filePath of locations) {
+			try {
+				const content = await fs.readFile(filePath, "utf-8");
+				const locationLabel = filePath.includes(".opencode/memory")
+					? "project"
+					: filePath.includes(process.env.HOME || "")
+						? "global"
+						: "legacy";
+				return `[Read from ${locationLabel}: ${filePath}]\n\n${content}`;
+			} catch (error) {
+				// Continue to next location if file not found
+				if (
+					error instanceof Error &&
+					"code" in error &&
+					error.code === "ENOENT"
+				) {
+					continue;
+				}
+				// Other errors should be reported
+				if (error instanceof Error) {
+					return `Error reading memory from ${filePath}: ${error.message}`;
+				}
+			}
+		}
 
-    // No file found in any location
-    return `Memory file '${normalizedFile}.md' not found in any location.\nSearched:\n- ${locations.join("\n- ")}\n\nStructure:\n- handoffs/YYYY-MM-DD-phase (phase transitions)\n- research/YYYY-MM-DD-topic (research findings)\n- _templates/ (prd, spec, review, research, handoff)`;
-  },
+		// No file found in any location
+		return `Memory file '${normalizedFile}.md' not found in any location.\nSearched:\n- ${locations.join("\n- ")}\n\nStructure:\n- handoffs/YYYY-MM-DD-phase (phase transitions)\n- research/YYYY-MM-DD-topic (research findings)\n- _templates/ (prd, spec, review, research, handoff)`;
+	},
 });

package/dist/template/.opencode/tool/memory-search.ts

@@ -127,8 +127,15 @@ function formatKeywordResults(
 }
 
 export default tool({
-	description:
-		"Search across all memory files using keywords. Returns matching files with context. Useful for finding past decisions, research, or handoffs.",
+	description: `Search across all memory files using keywords.
+	
+	Purpose:
+	- Find past decisions, research, or handoffs
+	- Searches: project memory, beads artifacts, and global memory
+	- Returns file paths with matched lines and context
+	
+	Example:
+	memory-search({ query: "authentication", type: "all", limit: 10 })`,
 	args: {
 		query: tool.schema
 			.string()

package/dist/template/.opencode/tool/memory-update.ts

@@ -3,54 +3,66 @@ import path from "node:path";
 import { tool } from "@opencode-ai/plugin";
 
 export default tool({
-  description:
-    "Update memory files with new learnings, progress, or context. Appends or replaces content based on mode. Supports subdirectories for organization (e.g., 'research/opencode-sessions' creates .opencode/memory/research/opencode-sessions.md).",
-  args: {
-    file: tool.schema
-      .string()
-      .describe(
-        "Memory file to update: handoffs/YYYY-MM-DD-phase, research/YYYY-MM-DD-topic. Use _templates/ for reference only.",
-      ),
-    content: tool.schema.string().describe("Content to write or append to the memory file"),
-    mode: tool.schema
-      .string()
-      .optional()
-      .default("replace")
-      .describe("Update mode: 'replace' (overwrite file) or 'append' (add to end)."),
-  },
-  execute: async (args: { file: string; content: string; mode?: string }) => {
-    // Always write to project memory (.opencode/memory/)
-    const memoryDir = path.join(process.cwd(), ".opencode/memory");
+	description: `Update memory files with new learnings, progress, or context.
+	
+	Purpose:
+	- Write or append to project memory in .opencode/memory/
+	- Supports subdirectories (e.g., 'research/2024-01-topic')
+	- Two modes: 'replace' (overwrite) or 'append' (add to end)
+	
+	Example:
+	memory-update({ file: "research/session-findings", content: "..." })
+	memory-update({ file: "handoffs/phase-2", content: "...", mode: "append" })`,
+	args: {
+		file: tool.schema
+			.string()
+			.describe(
+				"Memory file to update: handoffs/YYYY-MM-DD-phase, research/YYYY-MM-DD-topic. Use _templates/ for reference only.",
+			),
+		content: tool.schema
+			.string()
+			.describe("Content to write or append to the memory file"),
+		mode: tool.schema
+			.string()
+			.optional()
+			.default("replace")
+			.describe(
+				"Update mode: 'replace' (overwrite file) or 'append' (add to end).",
+			),
+	},
+	execute: async (args: { file: string; content: string; mode?: string }) => {
+		// Always write to project memory (.opencode/memory/)
+		const memoryDir = path.join(process.cwd(), ".opencode/memory");
 
-    // Normalize file path: strip existing .md extension, handle subdirectories
-    const normalizedFile = args.file.replace(/\.md$/i, ""); // Remove .md if present
-    const filePath = path.join(memoryDir, `${normalizedFile}.md`);
-    const mode = args.mode || "replace";
+		// Normalize file path: strip existing .md extension, handle subdirectories
+		const normalizedFile = args.file.replace(/\.md$/i, ""); // Remove .md if present
+		const filePath = path.join(memoryDir, `${normalizedFile}.md`);
+		const mode = args.mode || "replace";
 
-    try {
-      // Ensure parent directory exists (handles subdirectories)
-      const fileDir = path.dirname(filePath);
-      await fs.mkdir(fileDir, { recursive: true });
+		try {
+			// Ensure parent directory exists (handles subdirectories)
+			const fileDir = path.dirname(filePath);
+			await fs.mkdir(fileDir, { recursive: true });
 
-      if (mode === "append") {
-        const timestamp = new Date().toISOString();
-        const appendContent = `\n\n---\n**Updated:** ${timestamp}\n\n${args.content}`;
-        await fs.appendFile(filePath, appendContent, "utf-8");
-        return `Successfully appended to ${normalizedFile}.md\n[Written to: ${filePath}]`;
-      }
-      // Replace mode - update timestamp
-      const timestamp = new Date().toISOString();
-      const updatedContent = args.content.replace(
-        /\*\*Last Updated:\*\* \[Timestamp\]/,
-        `**Last Updated:** ${timestamp}`,
-      );
-      await fs.writeFile(filePath, updatedContent, "utf-8");
-      return `Successfully updated ${normalizedFile}.md\n[Written to: ${filePath}]`;
-    } catch (error) {
-      if (error instanceof Error) {
-        return `Error updating memory: ${error.message}`;
-      }
-      return "Unknown error updating memory file";
-    }
-  },
+			if (mode === "append") {
+				const timestamp = new Date().toISOString();
+				const appendContent = `\n\n---\n**Updated:** ${timestamp}\n\n${args.content}`;
+				await fs.appendFile(filePath, appendContent, "utf-8");
+				return `Successfully appended to ${normalizedFile}.md\n[Written to: ${filePath}]`;
+			}
+			// Replace mode - update timestamp
+			const timestamp = new Date().toISOString();
+			const updatedContent = args.content.replace(
+				/\*\*Last Updated:\*\* \[Timestamp\]/,
+				`**Last Updated:** ${timestamp}`,
+			);
+			await fs.writeFile(filePath, updatedContent, "utf-8");
+			return `Successfully updated ${normalizedFile}.md\n[Written to: ${filePath}]`;
+		} catch (error) {
+			if (error instanceof Error) {
+				return `Error updating memory: ${error.message}`;
+			}
+			return "Unknown error updating memory file";
+		}
+	},
 });

package/dist/template/.opencode/tool/observation.ts

@@ -73,8 +73,22 @@ function extractFileReferences(content: string): FileReference[] {
 }
 
 export default tool({
-	description:
-		"Create a structured observation for future reference. Observations are categorized by type (decision, bugfix, feature, pattern, discovery, learning, warning) and stored in .opencode/memory/observations/.",
+	description: `Create a structured observation for future reference.
+	
+	Purpose:
+	- Capture decisions, bugs, features, patterns, discoveries, learnings, or warnings
+	- Auto-detects file references from content (file:line, \`path\`, src/, .opencode/)
+	- Stores in .opencode/memory/observations/ with YAML frontmatter
+	- Optionally updates bead notes and handles observation supersession
+	
+	Example:
+	observation({
+	  type: "decision",
+	  title: "Use JWT for auth",
+	  content: "Decided to use JWT tokens because...",
+	  concepts: "authentication, jwt, security",
+	  confidence: "high"
+	})`,
 	args: {
 		type: tool.schema
 			.string()

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.15.5",
+	"version": "0.15.6",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"keywords": ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
 	"license": "MIT",