opencodekit 0.15.5 → 0.15.7

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.7",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   keywords: ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
   license: "MIT",
@@ -3866,20 +3866,22 @@ var MODEL_PRESETS = {
       general: "opencode/glm-4.7-free",
       looker: "opencode/gpt-5-nano",
       vision: "opencode/gpt-5-nano",
-      scout: "opencode/big-pickle"
+      scout: "opencode/big-pickle",
+      compaction: "opencode/minimax-m2.1-free"
     }
   },
   recommend: {
     model: "proxypal/gemini-claude-opus-4-5-thinking",
     agents: {
       build: "proxypal/gemini-claude-opus-4-5-thinking",
-      plan: "proxypal/gemini-3-flash-preview",
-      review: "proxypal/gemini-3-pro-preview",
-      explore: "opencode/grok-code",
+      plan: "openai/gpt-5.2",
+      review: "openai/gpt-5.2-codex",
+      explore: "proxypal/gemini-3-flash-preview",
       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",
+      compaction: "proxypal/gemini-2.5-flash"
     }
   }
 };

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

@@ -65,6 +65,10 @@ EXA_API_KEY=your_exa_api_key_here            # Web search
 # Figma integration
 FIGMA_API_KEY=your_figma_api_key_here
 
+# Google Stitch (AI UI design)
+GOOGLE_CLOUD_PROJECT=your_gcp_project_id
+STITCH_ACCESS_TOKEN=$(gcloud auth print-access-token)
+
 # Cloud deployments (devops skill)
 CLOUDFLARE_API_TOKEN=your_token_here
 CLOUDFLARE_ACCOUNT_ID=your_account_id_here
@@ -76,6 +80,7 @@ GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json
 - Context7: https://context7.com
 - Exa: https://exa.ai
 - Figma: https://www.figma.com/developers/api#access-tokens
+- Google Cloud: https://console.cloud.google.com (for Stitch)
 
 ---
 
@@ -200,6 +205,122 @@ Plugins run automatically in every session:
    - No API key needed
    - Use: `skill({ name: "chrome-devtools" })` then `skill_mcp()`
 
+7. **stitch** - Google Stitch AI-powered UI design generation
+   - Requires: Google Cloud project with Stitch API enabled
+   - Tools: `stitch_list_projects`, `stitch_create_project`, `stitch_generate_screen_from_text`, etc.
+   - See: [Stitch MCP Setup](#stitch-mcp-setup) below
+
+---
+
+## Stitch MCP Setup
+
+Google Stitch MCP enables AI-powered UI design generation directly from OpenCode.
+
+### Prerequisites
+
+1. **Google Cloud CLI** installed: https://cloud.google.com/sdk/docs/install
+2. **Google Cloud Project** with billing enabled
+
+### Setup Steps
+
+**Step 1: Authenticate with Google Cloud**
+
+```bash
+# Login to Google Cloud
+gcloud auth login
+
+# Set your project
+gcloud config set project YOUR_PROJECT_ID
+
+# Set up Application Default Credentials
+gcloud auth application-default login
+```
+
+**Step 2: Enable Stitch MCP**
+
+```bash
+# Enable the Stitch API
+gcloud services enable stitch.googleapis.com --project=YOUR_PROJECT_ID
+
+# Enable Stitch for MCP access (required!)
+gcloud beta services mcp enable stitch.googleapis.com --project=YOUR_PROJECT_ID
+```
+
+**Step 3: Set Environment Variables**
+
+Add to your `.opencode/.env` or export before starting OpenCode:
+
+```bash
+# Google Cloud Project ID
+GOOGLE_CLOUD_PROJECT=your-project-id
+
+# Access token (refresh when expired - tokens last ~1 hour)
+STITCH_ACCESS_TOKEN=$(gcloud auth print-access-token)
+```
+
+**Step 4: Verify Configuration**
+
+The Stitch MCP is pre-configured in `opencode.json`. After setting environment variables, restart OpenCode and test:
+
+```bash
+# In OpenCode, call Stitch tools directly:
+stitch_list_projects
+stitch_create_project --title "My App"
+```
+
+### Available Stitch Tools
+
+| Tool                               | Description                       |
+| ---------------------------------- | --------------------------------- |
+| `stitch_list_projects`             | List all your Stitch projects     |
+| `stitch_create_project`            | Create a new UI design project    |
+| `stitch_get_project`               | Get project details               |
+| `stitch_list_screens`              | List screens in a project         |
+| `stitch_get_screen`                | Get screen details with HTML code |
+| `stitch_generate_screen_from_text` | Generate UI from text prompt      |
+
+### Example Usage
+
+```bash
+# Create a new project
+stitch_create_project --title "E-commerce App"
+
+# Generate a login screen
+stitch_generate_screen_from_text \
+  --projectId "PROJECT_ID" \
+  --prompt "Create a modern login page with email and password fields, social login buttons, and a forgot password link" \
+  --deviceType "MOBILE"
+```
+
+### Troubleshooting
+
+**"Stitch API not enabled":**
+
+```bash
+gcloud beta services mcp enable stitch.googleapis.com --project=YOUR_PROJECT_ID
+```
+
+**"Authentication failed":**
+
+```bash
+# Refresh your access token (expires after ~1 hour)
+export STITCH_ACCESS_TOKEN=$(gcloud auth print-access-token)
+# Restart OpenCode
+```
+
+**"Project not set":**
+
+```bash
+gcloud config set project YOUR_PROJECT_ID
+export GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID
+```
+
+### Documentation
+
+- [Google Stitch](https://stitch.withgoogle.com)
+- [Stitch MCP Setup](https://stitch.withgoogle.com/docs/mcp/setup)
+- [Google Cloud MCP Overview](https://docs.cloud.google.com/mcp/overview)
+
 ---
 
 ## Getting Started Examples
@@ -315,8 +436,8 @@ fi
 
 ---
 
-**OpenCodeKit v0.13.2**  
+**OpenCodeKit v0.15.7**  
 **Architecture:** Two-Layer (Memory + Beads + Git)  
 **New in v0.13.2:** Multimodal support for gemini-claude models (image, PDF input)  
 **Package:** `npx opencodekit` to scaffold new projects  
-**Last Updated:** January 8, 2026
+**Last Updated:** January 21, 2026

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/opencode.json

@@ -6,7 +6,8 @@
       "model": "opencode/minimax-m2.1-free"
     },
     "compaction": {
-      "description": "Session summarizer for context continuity across compactions"
+      "description": "Session summarizer for context continuity across compactions",
+      "model": "opencode/minimax-m2.1-free"
     },
     "explore": {
       "description": "Fast codebase search specialist",
@@ -113,6 +114,16 @@
       "enabled": true,
       "type": "remote",
       "url": "https://mcp.grep.app"
+    },
+    "stitch": {
+      "enabled": false,
+      "type": "remote",
+      "url": "https://stitch.googleapis.com/mcp",
+      "oauth": false,
+      "headers": {
+        "Authorization": "Bearer {env:STITCH_ACCESS_TOKEN}",
+        "X-Goog-User-Project": "{env:GOOGLE_CLOUD_PROJECT}"
+      }
     }
   },
   "model": "opencode/minimax-m2.1-free",
@@ -148,76 +159,146 @@
   },
   "plugin": [
     "@tarquinen/opencode-dcp@latest",
-    "@franlol/opencode-md-table-formatter@0.0.3",
-    "opencode-copilot-auth@0.0.11"
+    "@franlol/opencode-md-table-formatter@0.0.3"
   ],
   "provider": {
     "github-copilot": {
       "models": {
-        "claude-haiku-4.5": {
+        "claude-opus-4.5": {
           "attachment": true,
-          "options": {
-            "thinking": {
-              "budgetTokens": 16000,
-              "type": "enabled"
-            }
-          },
           "reasoning": true,
           "temperature": true,
-          "tool_call": true
+          "tool_call": true,
+          "variants": {
+            "high": {
+              "options": {
+                "thinking": {
+                  "budgetTokens": 32000,
+                  "type": "enabled"
+                }
+              }
+            },
+            "medium": {
+              "options": {
+                "thinking": {
+                  "budgetTokens": 16000,
+                  "type": "enabled"
+                }
+              }
+            }
+          }
         },
-        "claude-opus-4.5": {
+        "claude-sonnet-4.5": {
           "attachment": true,
-          "options": {
-            "thinking": {
-              "budgetTokens": 32000,
-              "type": "enabled"
-            }
-          },
           "reasoning": true,
           "temperature": true,
-          "tool_call": true
+          "tool_call": true,
+          "variants": {
+            "high": {
+              "options": {
+                "thinking": {
+                  "budgetTokens": 16000,
+                  "type": "enabled"
+                }
+              }
+            },
+            "medium": {
+              "options": {
+                "thinking": {
+                  "budgetTokens": 8000,
+                  "type": "enabled"
+                }
+              }
+            }
+          }
         },
-        "claude-sonnet-4.5": {
+        "claude-haiku-4.5": {
           "attachment": true,
-          "options": {
-            "thinking": {
-              "budgetTokens": 16000,
-              "type": "enabled"
-            }
-          },
           "reasoning": true,
           "temperature": true,
-          "tool_call": true
+          "tool_call": true,
+          "variants": {
+            "high": {
+              "options": {
+                "thinking": {
+                  "budgetTokens": 32000,
+                  "type": "enabled"
+                }
+              }
+            },
+            "medium": {
+              "options": {
+                "thinking": {
+                  "budgetTokens": 16000,
+                  "type": "enabled"
+                }
+              }
+            }
+          }
         },
-        "gpt-5.1": {
+        "gpt-5-mini": {
           "attachment": true,
-          "options": {
-            "reasoning": {
-              "effort": "high"
-            }
-          },
           "reasoning": true,
           "temperature": true,
-          "tool_call": true
+          "tool_call": true,
+          "variants": {
+            "high": {
+              "options": {
+                "reasoning": {
+                  "effort": "high"
+                }
+              }
+            },
+            "medium": {
+              "options": {
+                "reasoning": {
+                  "effort": "medium"
+                }
+              }
+            },
+            "low": {
+              "options": {
+                "reasoning": {
+                  "effort": "low"
+                }
+              }
+            }
+          }
         },
-        "gpt-5.1-codex": {
+        "gpt-5.2-codex": {
           "attachment": true,
-          "options": {
-            "reasoning": {
-              "effort": "high"
-            }
-          },
           "reasoning": true,
           "temperature": true,
-          "tool_call": true
+          "tool_call": true,
+          "variants": {
+            "high": {
+              "options": {
+                "reasoning": {
+                  "effort": "high"
+                }
+              }
+            },
+            "medium": {
+              "options": {
+                "reasoning": {
+                  "effort": "medium"
+                }
+              }
+            },
+            "low": {
+              "options": {
+                "reasoning": {
+                  "effort": "low"
+                }
+              }
+            }
+          }
         }
-      },
-      "npm": "@ai-sdk/anthropic"
+      }
     },
     "openai": {
       "models": {
-        "gpt-5": {
+        "gpt-5.2": {
           "variants": {
             "fast": {
               "disabled": true
@@ -236,7 +317,7 @@
             }
           }
         },
-        "gpt-5-codex": {
+        "gpt-5.2-codex": {
           "variants": {
             "fast": {
               "disabled": true

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

@@ -11,7 +11,7 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "1.1.25"
+    "@opencode-ai/plugin": "1.1.28"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",

package/dist/template/.opencode/plugin/copilot-auth.ts

@@ -0,0 +1,322 @@
+/**
+ * GitHub Copilot Auth Plugin
+ * Simplified auth provider without token expiration checks
+ */
+
+import type { Plugin } from "@opencode-ai/plugin";
+
+const CLIENT_ID = "Iv1.b507a08c87ecfe98";
+
+const HEADERS = {
+	"User-Agent": "GitHubCopilotChat/0.35.0",
+	"Editor-Version": "vscode/1.107.0",
+	"Editor-Plugin-Version": "copilot-chat/0.35.0",
+	"Copilot-Integration-Id": "vscode-chat",
+};
+
+const RESPONSES_API_ALTERNATE_INPUT_TYPES = [
+	"file_search_call",
+	"computer_call",
+	"computer_call_output",
+	"web_search_call",
+	"function_call",
+	"function_call_output",
+	"image_generation_call",
+	"code_interpreter_call",
+	"local_shell_call",
+	"local_shell_call_output",
+	"mcp_list_tools",
+	"mcp_approval_request",
+	"mcp_approval_response",
+	"mcp_call",
+	"reasoning",
+];
+
+function normalizeDomain(url: string): string {
+	return url.replace(/^https?:\/\//, "").replace(/\/$/, "");
+}
+
+function getUrls(domain: string) {
+	return {
+		DEVICE_CODE_URL: `https://${domain}/login/device/code`,
+		ACCESS_TOKEN_URL: `https://${domain}/login/oauth/access_token`,
+		COPILOT_API_KEY_URL: `https://api.github.com/copilot_internal/v2/token`,
+	};
+}
+
+export const CopilotAuthPlugin: Plugin = async ({ client }) => {
+	return {
+		auth: {
+			provider: "github-copilot",
+			loader: async (getAuth, provider) => {
+				const info = await getAuth();
+				if (!info || info.type !== "oauth") return {};
+
+				if (provider && provider.models) {
+					for (const model of Object.values(provider.models)) {
+						model.cost = {
+							input: 0,
+							output: 0,
+							cache: {
+								read: 0,
+								write: 0,
+							},
+						};
+					}
+				}
+
+				const enterpriseUrl = info.enterpriseUrl;
+				const baseURL = enterpriseUrl
+					? `https://copilot-api.${normalizeDomain(enterpriseUrl)}`
+					: "https://api.githubcopilot.com";
+
+				return {
+					baseURL,
+					apiKey: "",
+					async fetch(input, init) {
+						const info = await getAuth();
+						if (info.type !== "oauth") return {};
+						if (!info.access) {
+							const domain = info.enterpriseUrl
+								? normalizeDomain(info.enterpriseUrl)
+								: "github.com";
+							const urls = getUrls(domain);
+
+							const response = await fetch(urls.COPILOT_API_KEY_URL, {
+								headers: {
+									Accept: "application/json",
+									Authorization: `Bearer ${info.refresh}`,
+									...HEADERS,
+								},
+							});
+
+							if (!response.ok) {
+								throw new Error(`Token refresh failed: ${response.status}`);
+							}
+
+							const tokenData = await response.json();
+
+							const saveProviderID = info.enterpriseUrl
+								? "github-copilot-enterprise"
+								: "github-copilot";
+							await client.auth.set({
+								path: {
+									id: saveProviderID,
+								},
+								body: {
+									type: "oauth",
+									refresh: info.refresh,
+									access: tokenData.token,
+									expires: tokenData.expires_at * 1000 - 5 * 60 * 1000,
+									...(info.enterpriseUrl && {
+										enterpriseUrl: info.enterpriseUrl,
+									}),
+								},
+							});
+							info.access = tokenData.token;
+						}
+
+						let isAgentCall = false;
+						let isVisionRequest = false;
+						try {
+							const body =
+								typeof init.body === "string"
+									? JSON.parse(init.body)
+									: init.body;
+							if (body?.messages) {
+								isAgentCall = body.messages.some(
+									(msg: any) =>
+										msg.role && ["tool", "assistant"].includes(msg.role),
+								);
+								isVisionRequest = body.messages.some(
+									(msg: any) =>
+										Array.isArray(msg.content) &&
+										msg.content.some((part: any) => part.type === "image_url"),
+								);
+							}
+
+							if (body?.input) {
+								const lastInput = body.input[body.input.length - 1];
+
+								const isAssistant = lastInput?.role === "assistant";
+								const hasAgentType = lastInput?.type
+									? RESPONSES_API_ALTERNATE_INPUT_TYPES.includes(lastInput.type)
+									: false;
+								isAgentCall = isAssistant || hasAgentType;
+
+								isVisionRequest =
+									Array.isArray(lastInput?.content) &&
+									lastInput.content.some(
+										(part: any) => part.type === "input_image",
+									);
+							}
+						} catch {}
+
+						const headers = {
+							...init.headers,
+							...HEADERS,
+							Authorization: `Bearer ${info.access}`,
+							"Openai-Intent": "conversation-edits",
+							"X-Initiator": isAgentCall ? "agent" : "user",
+						};
+						if (isVisionRequest) {
+							headers["Copilot-Vision-Request"] = "true";
+						}
+
+						delete headers["x-api-key"];
+						delete headers["authorization"];
+
+						return fetch(input, {
+							...init,
+							headers,
+						});
+					},
+				};
+			},
+			methods: [
+				{
+					type: "oauth",
+					label: "Login with GitHub Copilot",
+					prompts: [
+						{
+							type: "select",
+							key: "deploymentType",
+							message: "Select GitHub deployment type",
+							options: [
+								{
+									label: "GitHub.com",
+									value: "github.com",
+									hint: "Public",
+								},
+								{
+									label: "GitHub Enterprise",
+									value: "enterprise",
+									hint: "Data residency or self-hosted",
+								},
+							],
+						},
+						{
+							type: "text",
+							key: "enterpriseUrl",
+							message: "Enter your GitHub Enterprise URL or domain",
+							placeholder: "company.ghe.com or https://company.ghe.com",
+							condition: (inputs: any) =>
+								inputs.deploymentType === "enterprise",
+							validate: (value: string) => {
+								if (!value) return "URL or domain is required";
+								try {
+									const url = value.includes("://")
+										? new URL(value)
+										: new URL(`https://${value}`);
+									if (!url.hostname)
+										return "Please enter a valid URL or domain";
+									return undefined;
+								} catch {
+									return "Please enter a valid URL (e.g., company.ghe.com or https://company.ghe.com)";
+								}
+							},
+						},
+					],
+					async authorize(inputs: any = {}) {
+						const deploymentType = inputs.deploymentType || "github.com";
+
+						let domain = "github.com";
+						let actualProvider = "github-copilot";
+
+						if (deploymentType === "enterprise") {
+							const enterpriseUrl = inputs.enterpriseUrl;
+							domain = normalizeDomain(enterpriseUrl);
+							actualProvider = "github-copilot-enterprise";
+						}
+
+						const urls = getUrls(domain);
+
+						const deviceResponse = await fetch(urls.DEVICE_CODE_URL, {
+							method: "POST",
+							headers: {
+								Accept: "application/json",
+								"Content-Type": "application/json",
+								"User-Agent": "GitHubCopilotChat/0.35.0",
+							},
+							body: JSON.stringify({
+								client_id: CLIENT_ID,
+								scope: "read:user",
+							}),
+						});
+
+						if (!deviceResponse.ok) {
+							throw new Error("Failed to initiate device authorization");
+						}
+
+						const deviceData = await deviceResponse.json();
+
+						return {
+							url: deviceData.verification_uri,
+							instructions: `Enter code: ${deviceData.user_code}`,
+							method: "auto",
+							callback: async () => {
+								while (true) {
+									const response = await fetch(urls.ACCESS_TOKEN_URL, {
+										method: "POST",
+										headers: {
+											Accept: "application/json",
+											"Content-Type": "application/json",
+											"User-Agent": "GitHubCopilotChat/0.35.0",
+										},
+										body: JSON.stringify({
+											client_id: CLIENT_ID,
+											device_code: deviceData.device_code,
+											grant_type:
+												"urn:ietf:params:oauth:grant-type:device_code",
+										}),
+									});
+
+									if (!response.ok) return { type: "failed" };
+
+									const data = await response.json();
+
+									if (data.access_token) {
+										const result: {
+											type: "success";
+											refresh: string;
+											access: string;
+											expires: number;
+											provider?: string;
+											enterpriseUrl?: string;
+										} = {
+											type: "success",
+											refresh: data.access_token,
+											access: "",
+											expires: 0,
+										};
+
+										if (actualProvider === "github-copilot-enterprise") {
+											result.provider = "github-copilot-enterprise";
+											result.enterpriseUrl = domain;
+										}
+
+										return result;
+									}
+
+									if (data.error === "authorization_pending") {
+										await new Promise((resolve) =>
+											setTimeout(resolve, deviceData.interval * 1000),
+										);
+										continue;
+									}
+
+									if (data.error) return { type: "failed" };
+
+									await new Promise((resolve) =>
+										setTimeout(resolve, deviceData.interval * 1000),
+									);
+									continue;
+								}
+							},
+						};
+					},
+				},
+			],
+		},
+	};
+};

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/stitch/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: stitch
+description: Google Stitch MCP for AI-powered UI design. Extract design context, generate code from designs, and create screens from descriptions. Use when working with Stitch designs and UI generation.
+---
+
+# Google Stitch MCP
+
+Access Google Stitch UI designs directly through the Model Context Protocol.
+
+## Overview
+
+Stitch MCP is Google's official Model Context Protocol server for interacting with Google Stitch designs. It allows AI agents to extract design context (colors, typography, spacing), generate production-ready code from designs, and create new designs from text descriptions.
+
+## Endpoint
+
+**MCP Server URL**: `https://stitch.googleapis.com/mcp`
+
+**Authentication**: Google Cloud credentials with Bearer token and project ID header
+
+## Prerequisites
+
+1. **Google Cloud Project** with Stitch API enabled
+2. **Google Cloud CLI** (`gcloud`) installed and initialized
+3. **Required IAM Roles**:
+   - `roles/serviceusage.serviceUsageAdmin` (to enable the service)
+   - `roles/mcp.toolUser` (to call MCP tools)
+
+## Setup Steps
+
+### 1. Enable Stitch API in Google Cloud
+
+```bash
+# Set your Google Cloud project
+gcloud config set project PROJECT_ID
+
+# Enable the Stitch MCP service
+gcloud beta services mcp enable stitch.googleapis.com --project=PROJECT_ID
+```
+
+### 2. Get Your Access Token
+
+```bash
+# Authenticate with Google Cloud
+gcloud auth login
+
+# Get your access token
+gcloud auth print-access-token
+```
+
+### 3. Set Environment Variables
+
+```bash
+# Set your Google Cloud project ID
+export GOOGLE_CLOUD_PROJECT="your-project-id"
+
+# Get and set your access token
+export STITCH_ACCESS_TOKEN=$(gcloud auth print-access-token)
+```
+
+### 4. Configuration
+
+Stitch MCP is pre-configured in `opencode.json` as a default MCP server. Once environment variables are set, restart OpenCode and the tools will be available.
+
+## Available Tools
+
+Once configured, the Stitch MCP exposes the following tools:
+
+| Tool                               | Description                       |
+| ---------------------------------- | --------------------------------- |
+| `stitch_list_projects`             | List all your Stitch projects     |
+| `stitch_create_project`            | Create a new UI design project    |
+| `stitch_get_project`               | Get project details               |
+| `stitch_list_screens`              | List screens in a project         |
+| `stitch_get_screen`                | Get screen details with HTML code |
+| `stitch_generate_screen_from_text` | Generate UI from text prompt      |
+
+## Usage Examples
+
+### List Projects
+
+```typescript
+stitch_list_projects({});
+```
+
+### Create a Project
+
+```typescript
+stitch_create_project({
+  title: "My E-commerce App",
+});
+```
+
+### Generate Screen from Text
+
+```typescript
+stitch_generate_screen_from_text({
+  projectId: "my-project-123",
+  prompt:
+    "Create a modern login page with email and password fields, social login buttons, and a forgot password link",
+  deviceType: "MOBILE",
+});
+```
+
+## Troubleshooting
+
+### "Stitch API not enabled"
+
+```bash
+gcloud beta services mcp enable stitch.googleapis.com --project=YOUR_PROJECT_ID
+```
+
+### "Authentication failed"
+
+```bash
+# Refresh your access token (expires after ~1 hour)
+export STITCH_ACCESS_TOKEN=$(gcloud auth print-access-token)
+# Restart OpenCode
+```
+
+### "Project not set"
+
+```bash
+gcloud config set project YOUR_PROJECT_ID
+export GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID
+```
+
+## Documentation
+
+- [Google Stitch](https://stitch.withgoogle.com)
+- [Stitch MCP Setup](https://stitch.withgoogle.com/docs/mcp/setup)
+- [Google Cloud MCP Overview](https://docs.cloud.google.com/mcp/overview)
+
+## Tips
+
+- Access tokens expire after ~1 hour, refresh with `gcloud auth print-access-token`
+- Use descriptive prompts for better UI generation results
+- Test generated code in your target framework before production use

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

@@ -0,0 +1,9 @@
+{
+	"stitch": {
+		"serverUrl": "https://stitch.googleapis.com/mcp",
+		"headers": {
+			"Authorization": "Bearer ${STITCH_ACCESS_TOKEN}",
+			"X-Goog-User-Project": "${GOOGLE_CLOUD_PROJECT}"
+		}
+	}
+}

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.7",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"keywords": ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
 	"license": "MIT",