opencodekit 0.5.0 → 0.6.1

package/dist/index.js

@@ -750,7 +750,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.5.0",
+  version: "0.6.1",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   type: "module",
   repository: {

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

@@ -230,6 +230,14 @@ read_session("today")                                 # Today's first session
 read_session("ses_abc123", focus="file changes")      # Specific aspect
 ```
 
+**`summarize_session`** - Generate AI summary of a session
+
+```
+summarize_session("ses_abc123")                       # Trigger AI summarization
+```
+
+Use before `read_session` to get a quick overview of what happened in a past session without loading full context.
+
 ### When to Start New Session
 
 - Completing distinct task from `bd ready`
@@ -281,7 +289,10 @@ Use `find_skills` → `use_skill` when:
 - Complex multi-step work → `writing-plans` → `executing-plans`
 - Finished implementation → `requesting-code-review`
 - Building UI → `frontend-aesthetics`
-- UI/UX with images → `ui-ux-research`
+- UI/UX with images → `ui-ux-research` or `visual-analysis`
+- Accessibility audit → `accessibility-audit`
+- Design system audit → `design-system-audit`
+- Mockups to code → `mockup-to-code`
 - Large codebase research → `gemini-large-context`
 
 Skip for simple questions, quick edits, or conversations.

package/dist/template/.opencode/command/skill-create.md

@@ -11,13 +11,13 @@ Use `use_skill("writing-skills")` to create a new skill.
 ## Workflow
 
 1. **Load skill** - `use_skill("writing-skills")`
-2. **Follow the TDD process** - Test with subagents before writing
-3. **Save to** `.opencode/skills/$ARGUMENTS/`
+2. **Follow by TDD process** - Test with subagents before writing
+3. **Save to** `.opencode/skill/$ARGUMENTS/`
 
 ## Skill Structure
 
 ```
-.opencode/skills/$ARGUMENTS/
+.opencode/skill/$ARGUMENTS/
 ├── SKILL.md          (Main skill definition)
 ├── instructions.md   (Detailed instructions)
 └── tests/            (Test scenarios)

package/dist/template/.opencode/command/skill-optimize.md

@@ -10,7 +10,7 @@ Use `use_skill("writing-skills")` to optimize an existing skill.
 
 ## Workflow
 
-1. **Read current skill** from `.opencode/skills/$ARGUMENTS/` or `.opencode/superpowers/skills/$ARGUMENTS/`
+1. **Read current skill** from `.opencode/skill/$ARGUMENTS/` or `.opencode/superpowers/skills/$ARGUMENTS/`
 2. **Load skill** - `use_skill("writing-skills")`
 3. **Apply TDD process** - Test, refine, verify
 4. **Test changes** with `use_skill("testing-skills-with-subagents")`

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

@@ -0,0 +1,71 @@
+---
+description: Generate AI summary of a previous session for quick context
+argument-hint: "[session_reference]"
+agent: build
+---
+
+# Summarize
+
+Generate an AI summary of a previous session to quickly understand what happened without loading full context.
+
+## Phase 1: Resolve Session
+
+If no argument provided, list recent sessions:
+
+```
+list_sessions(limit=5, project="current")
+```
+
+Parse the session reference:
+
+- Empty or "last" resolves to most recent session
+- "2 ago" or "3 ago" resolves to nth most recent
+- "today" resolves to first session today
+- "ses\_..." uses the session ID directly
+
+## Phase 2: Generate Summary
+
+Trigger AI summarization using the configured compaction model:
+
+```
+summarize_session(session_id)
+```
+
+The summary is generated asynchronously and stored with the session.
+
+## Phase 3: Display Result
+
+Read the session with focus on the generated summary:
+
+```
+read_session(session_id, focus="summary")
+```
+
+Present the summary in a clear, scannable format showing what was accomplished, key decisions made, and any blockers encountered.
+
+## Output
+
+Report the session metadata (ID, timestamp, message count, token usage) followed by the AI-generated summary. Highlight key actions taken during the session.
+
+End with actionable next steps:
+
+- How to load full context if needed
+- How to resume associated work
+
+## Examples
+
+```
+/summarize                    # Summarize most recent session
+/summarize last               # Same as above
+/summarize ses_abc123         # Summarize specific session
+/summarize 2 ago              # Summarize 2nd most recent
+/summarize today              # First session today
+```
+
+## When to Use
+
+Use this command before resuming work to get a quick overview without loading full context. Helpful during handoffs to understand previous session state, for context triage to decide if a session is worth loading, or when researching across multiple past sessions to find relevant work.
+
+## Integration
+
+This command works alongside other session tools. Start with `list_sessions` to discover available sessions, use `/summarize` to quickly understand promising candidates, then load full context with `read_session` only for the most relevant session. This workflow saves context space by avoiding unnecessary full session loads.

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

@@ -11,7 +11,7 @@
 		},
 		"explore": {
 			"description": "Fast codebase search specialist",
-			"model": "proxypal/gemini-3-flash-preview"
+			"model": "opencode/grok-code"
 		},
 		"general": {
 			"disable": true
@@ -21,7 +21,7 @@
 		},
 		"planner": {
 			"description": "Strategic planning agent for architecture and design",
-			"model": "proxypal/gpt-5.2"
+			"model": "proxypal/gpt-5.1"
 		},
 		"review": {
 			"description": "Code review, debugging, and security audit specialist",
@@ -29,7 +29,7 @@
 		},
 		"rush": {
 			"description": "Fast primary agent for small, well-defined tasks",
-			"model": "proxypal/gemini-3-pro-preview"
+			"model": "zai-coding-plan/glm-4.7"
 		},
 		"scout": {
 			"description": "External research specialist for library docs and patterns",
@@ -42,6 +42,7 @@
 	},
 	"autoupdate": false,
 	"experimental": {
+		"lsp": true,
 		"batch_tool": true,
 		"chatMaxRetries": 2,
 		"primary_tools": ["edit", "write", "bash", "prune"]
@@ -124,8 +125,8 @@
 	"plugin": [
 		"opencode-gemini-auth",
 		"@tarquinen/opencode-dcp@latest",
-		"@howaboua/pickle-thinker@0.1.3",
-		"@franlol/opencode-md-table-formatter@0.0.3"
+		"@franlol/opencode-md-table-formatter@0.0.3",
+		"./plugin/skill.ts"
 	],
 	"provider": {
 		"github-copilot": {
@@ -431,6 +432,23 @@
 		},
 		"zai-coding-plan": {
 			"models": {
+				"glm-4.7": {
+					"id": "glm-4.7",
+					"name": "GLM-4.7",
+					"reasoning": true,
+					"interleaved": true,
+					"options": {
+						"reasoningEffort": "high",
+						"reasoningSummary": "true",
+						"temperature": 1,
+						"top_k": 40,
+						"top_p": 0.95,
+						"maxOutputTokens": 131072,
+						"thinking": {
+							"type": "enabled"
+						}
+					}
+				},
 				"glm-4.6": {
 					"attachment": true,
 					"options": {

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

@@ -11,7 +11,7 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@opencode-ai/plugin": "1.0.180"
+    "@opencode-ai/plugin": "1.0.186"
   },
   "devDependencies": {
     "@types/node": "^20.19.27",

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

@@ -61,7 +61,7 @@ function parseDate(dateStr: string): Date | null {
 	return null;
 }
 
-export const SessionsPlugin: Plugin = async ({ directory }) => {
+export const SessionsPlugin: Plugin = async ({ client, directory }) => {
 	const storageDir = join(
 		process.env.HOME || "",
 		".local/share/opencode/storage",
@@ -158,6 +158,31 @@ export const SessionsPlugin: Plugin = async ({ directory }) => {
 
 	return {
 		tool: {
+			summarize_session: tool({
+				description:
+					"Generate an AI summary of a session using the new auto parameter. Useful for quickly understanding what happened in a previous session.",
+				args: {
+					session_id: tool.schema
+						.string()
+						.describe("Session ID to summarize (e.g. 'ses_abc123')"),
+				},
+				async execute(args) {
+					try {
+						// Use compaction model from config: proxypal/gemini-3-flash-preview
+						const result = await client.session.summarize({
+							path: { id: args.session_id },
+							body: {
+								providerID: "proxypal",
+								modelID: "gemini-3-flash-preview",
+							},
+						});
+						return `Session summarized successfully.\n\n${JSON.stringify(result, null, 2)}`;
+					} catch (error) {
+						return `Error summarizing session: ${error instanceof Error ? error.message : String(error)}`;
+					}
+				},
+			}),
+
 			list_sessions: tool({
 				description:
 					"List OpenCode sessions with metadata. Filter by project and date. Use this before read_session to discover available sessions.",

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

@@ -0,0 +1,275 @@
+/**
+ * Skills plugin for OpenCode.ai
+ *
+ * Provides custom tools for loading and discovering skills.
+ * Skills are loaded on-demand via use_skill tool, not auto-injected.
+ *
+ * OpenCode Official Skill Locations:
+ * - Project skills: .opencode/skill/
+ * - Personal skills: ~/.opencode/skill/
+ */
+
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { type Plugin, tool } from "@opencode-ai/plugin";
+
+interface SkillResolution {
+  skillFile: string;
+  sourceType: "project" | "personal";
+  skillPath: string;
+}
+
+interface SkillInfo {
+  path: string;
+  skillFile: string;
+  name: string;
+  description: string;
+  sourceType: "project" | "personal";
+}
+
+interface Frontmatter {
+  name: string;
+  description: string;
+}
+
+// ============================================
+// Skills Core Functions
+// ============================================
+
+function extractFrontmatter(filePath: string): Frontmatter {
+  try {
+    const content = fs.readFileSync(filePath, "utf8");
+    const lines = content.split("\n");
+
+    let inFrontmatter = false;
+    let name = "";
+    let description = "";
+
+    for (const line of lines) {
+      if (line.trim() === "---") {
+        if (inFrontmatter) break;
+        inFrontmatter = true;
+        continue;
+      }
+
+      if (inFrontmatter) {
+        const match = line.match(/^(\w+):\s*(.*)$/);
+        if (match) {
+          const [, key, value] = match;
+          if (key === "name") name = value.trim();
+          if (key === "description") description = value.trim();
+        }
+      }
+    }
+
+    return { name, description };
+  } catch {
+    return { name: "", description: "" };
+  }
+}
+
+function findSkillsInDir(
+  dir: string,
+  sourceType: "project" | "personal",
+  maxDepth = 3,
+): SkillInfo[] {
+  const skills: SkillInfo[] = [];
+
+  if (!fs.existsSync(dir)) return skills;
+
+  function recurse(currentDir: string, depth: number) {
+    if (depth > maxDepth) return;
+
+    const entries = fs.readdirSync(currentDir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const fullPath = path.join(currentDir, entry.name);
+
+      if (entry.isDirectory()) {
+        const skillFile = path.join(fullPath, "SKILL.md");
+        if (fs.existsSync(skillFile)) {
+          const { name, description } = extractFrontmatter(skillFile);
+          skills.push({
+            path: fullPath,
+            skillFile,
+            name: name || entry.name,
+            description: description || "",
+            sourceType,
+          });
+        }
+        recurse(fullPath, depth + 1);
+      }
+    }
+  }
+
+  recurse(dir, 0);
+  return skills;
+}
+
+function stripFrontmatter(content: string): string {
+  const lines = content.split("\n");
+  let inFrontmatter = false;
+  let frontmatterEnded = false;
+  const contentLines: string[] = [];
+
+  for (const line of lines) {
+    if (line.trim() === "---") {
+      if (inFrontmatter) {
+        frontmatterEnded = true;
+        continue;
+      }
+      inFrontmatter = true;
+      continue;
+    }
+
+    if (frontmatterEnded || !inFrontmatter) {
+      contentLines.push(line);
+    }
+  }
+
+  return contentLines.join("\n").trim();
+}
+
+// ============================================
+// Plugin Export
+// ============================================
+
+export const SkillsPlugin: Plugin = async ({ client, directory }) => {
+  const homeDir = os.homedir();
+  const projectSkillsDir = path.join(directory, ".opencode/skill");
+  const personalSkillsDir = path.join(homeDir, ".opencode/skill");
+
+  return {
+    tool: {
+      use_skill: tool({
+        description:
+          "Load and read a specific skill to guide your work. Skills contain proven workflows, mandatory processes, and expert techniques.",
+        args: {
+          skill_name: tool.schema
+            .string()
+            .describe(
+              'Name of skill to load (e.g., "brainstorming", "my-custom-skill", or "project:my-skill")',
+            ),
+        },
+        execute: async (
+          args: { skill_name: string },
+          context: { sessionID: string },
+        ) => {
+          const { skill_name } = args;
+
+          // Resolve with priority: project > personal
+          const forceProject = skill_name.startsWith("project:");
+          const actualSkillName = forceProject
+            ? skill_name.replace(/^project:/, "")
+            : skill_name;
+
+          let resolved: SkillResolution | null = null;
+
+          // Try project skills first
+          if (forceProject) {
+            const projectSkillFile = path.join(
+              projectSkillsDir,
+              actualSkillName,
+              "SKILL.md",
+            );
+            if (fs.existsSync(projectSkillFile)) {
+              resolved = {
+                skillFile: projectSkillFile,
+                sourceType: "project",
+                skillPath: actualSkillName,
+              };
+            }
+          }
+
+          // Fall back to personal resolution
+          if (!resolved && !forceProject) {
+            const personalSkillFile = path.join(
+              personalSkillsDir,
+              skill_name,
+              "SKILL.md",
+            );
+            if (fs.existsSync(personalSkillFile)) {
+              resolved = {
+                skillFile: personalSkillFile,
+                sourceType: "personal",
+                skillPath: skill_name,
+              };
+            }
+          }
+
+          if (!resolved) {
+            return `Error: Skill "${skill_name}" not found.\n\nRun find_skills to see available skills.`;
+          }
+
+          const fullContent = fs.readFileSync(resolved.skillFile, "utf8");
+          const { name, description } = extractFrontmatter(resolved.skillFile);
+          const content = stripFrontmatter(fullContent);
+          const skillDirectory = path.dirname(resolved.skillFile);
+
+          const skillHeader = `# ${name || skill_name}
+# ${description || ""}
+# Supporting tools and docs are in ${skillDirectory}
+# ============================================`;
+
+          // Insert as user message with noReply for persistence across compaction
+          try {
+            await client.session.prompt({
+              path: { id: context.sessionID },
+              body: {
+                noReply: true,
+                parts: [
+                  {
+                    type: "text",
+                    text: `Loading skill: ${name || skill_name}`,
+                  },
+                  { type: "text", text: `${skillHeader}\n\n${content}` },
+                ],
+              },
+            });
+          } catch {
+            // Fallback: return content directly if message insertion fails
+            return `${skillHeader}\n\n${content}`;
+          }
+
+          return `Launching skill: ${name || skill_name}`;
+        },
+      }),
+
+      find_skills: tool({
+        description:
+          "List all available skills in project and personal skill libraries.",
+        args: {},
+        execute: async () => {
+          const projectSkills = findSkillsInDir(projectSkillsDir, "project", 3);
+          const personalSkills = findSkillsInDir(
+            personalSkillsDir,
+            "personal",
+            3,
+          );
+
+          const allSkills = [...projectSkills, ...personalSkills];
+
+          if (allSkills.length === 0) {
+            return `No skills found. Add project skills to .opencode/skill/ or personal skills to ~/.opencode/skill/`;
+          }
+
+          let output = "Available skills:\n\n";
+
+          for (const skill of allSkills) {
+            const namespace = skill.sourceType === "project" ? "project:" : "";
+            const skillName = skill.name || path.basename(skill.path);
+
+            output += `${namespace}${skillName}\n`;
+            if (skill.description) {
+              output += `  ${skill.description}\n`;
+            }
+            output += `  Directory: ${skill.path}\n\n`;
+          }
+
+          return output;
+        },
+      }),
+    },
+  };
+};

package/dist/template/.opencode/{skills → skill}/accessibility-audit/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: accessibility-audit
+description: Use when auditing UI components or pages for accessibility compliance, checking WCAG conformance, identifying keyboard navigation issues, color contrast problems, and pre-launch accessibility verification
+---
+
 # Accessibility Audit Skill
 
 Audit UI accessibility against WCAG 2.1/2.2 guidelines.

package/dist/template/.opencode/{skills → skill}/brainstorming/SKILL.md

@@ -46,8 +46,8 @@ Start by understanding the current project context, then ask questions one at a
 **Implementation (if continuing):**
 
 - Ask: "Ready to set up for implementation?"
-- Use superpowers:using-git-worktrees to create isolated workspace
-- Use superpowers:writing-plans to create detailed implementation plan
+- Use use_skill("using-git-worktrees") to create isolated workspace
+- Use use_skill("writing-plans") to create detailed implementation plan
 
 ## Key Principles
 

package/dist/template/.opencode/{skills → skill}/design-system-audit/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: design-system-audit
+description: Use when auditing existing design systems for consistency, documenting undocumented design tokens, identifying design debt, preparing for design system refactoring, or comparing implementation vs design specs
+---
+
 # Design System Audit Skill
 
 Audit, document, and improve design systems.

package/dist/template/.opencode/{skills → skill}/executing-plans/SKILL.md

@@ -16,28 +16,35 @@ Load plan, review critically, execute tasks in batches, report for review betwee
 ## The Process
 
 ### Step 1: Load and Review Plan
+
 1. Read plan file
 2. Review critically - identify any questions or concerns about the plan
 3. If concerns: Raise them with your human partner before starting
 4. If no concerns: Create TodoWrite and proceed
 
 ### Step 2: Execute Batch
+
 **Default: First 3 tasks**
 
 For each task:
+
 1. Mark as in_progress
 2. Follow each step exactly (plan has bite-sized steps)
 3. Run verifications as specified
 4. Mark as completed
 
 ### Step 3: Report
+
 When batch complete:
+
 - Show what was implemented
 - Show verification output
 - Say: "Ready for feedback."
 
 ### Step 4: Continue
+
 Based on feedback:
+
 - Apply changes if needed
 - Execute next batch
 - Repeat until complete
@@ -45,13 +52,15 @@ Based on feedback:
 ### Step 5: Complete Development
 
 After all tasks complete and verified:
-- Announce: "I'm using the finishing-a-development-branch skill to complete this work."
-- **REQUIRED SUB-SKILL:** Use superpowers:finishing-a-development-branch
+
+- Announce: "I'm using finishing-a-development-branch skill to complete this work."
+- **REQUIRED SUB-SKILL:** Use use_skill("finishing-a-development-branch")
 - Follow that skill to verify tests, present options, execute choice
 
 ## When to Stop and Ask for Help
 
 **STOP executing immediately when:**
+
 - Hit a blocker mid-batch (missing dependency, test fails, instruction unclear)
 - Plan has critical gaps preventing starting
 - You don't understand an instruction
@@ -62,12 +71,14 @@ After all tasks complete and verified:
 ## When to Revisit Earlier Steps
 
 **Return to Review (Step 1) when:**
+
 - Partner updates the plan based on your feedback
 - Fundamental approach needs rethinking
 
 **Don't force through blockers** - stop and ask.
 
 ## Remember
+
 - Review plan critically first
 - Follow plan steps exactly
 - Don't skip verifications

package/dist/template/.opencode/{skills → skill}/frontend-aesthetics/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: frontend-aesthetics
+description: Use when building landing pages, dashboards, forms, or any frontend generation task where you need to prevent generic "AI slop" and create distinctive, intentional designs
+---
+
 # Frontend Aesthetics Skill
 
 Prevent generic "AI slop" frontends. Create distinctive, intentional designs.

package/dist/template/.opencode/{skills → skill}/mockup-to-code/SKILL.md

@@ -1,3 +1,8 @@
+---
+name: mockup-to-code
+description: Use when converting UI mockups, screenshots, Figma/Sketch designs, wireframes, or building component libraries from design systems into production-ready code
+---
+
 # Mockup to Code Skill
 
 Convert UI mockups, screenshots, and designs into production-ready code.