opencodekit 0.15.9 → 0.15.10

package/dist/index.js

@@ -750,7 +750,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.15.9",
+  version: "0.15.10",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   keywords: ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
   license: "MIT",
@@ -3857,17 +3857,18 @@ async function copyOpenCodeOnly(templateRoot, targetDir) {
 }
 var MODEL_PRESETS = {
   free: {
-    model: "opencode/minimax-m2.1-free",
+    model: "opencode/big-pickle",
     agents: {
-      build: "opencode/minimax-m2.1-free",
-      plan: "opencode/minimax-m2.1-free",
-      review: "opencode/minimax-m2.1-free",
+      build: "opencode/big-pickle",
+      plan: "opencode/big-pickle",
+      review: "opencode/big-pickle",
       explore: "opencode/grok-code",
-      general: "opencode/glm-4.7-free",
+      general: "opencode/grok-code",
       looker: "opencode/gpt-5-nano",
       vision: "opencode/gpt-5-nano",
       scout: "opencode/big-pickle",
-      compaction: "opencode/minimax-m2.1-free"
+      painter: "opencode/gpt-5-nano",
+      compaction: "opencode/big-pickle"
     }
   },
   recommend: {
@@ -3881,6 +3882,7 @@ var MODEL_PRESETS = {
       looker: "proxypal/gemini-3-flash-preview",
       vision: "proxypal/gemini-3-pro-preview",
       scout: "proxypal/gemini-3-flash-preview",
+      painter: "proxypal/gemini-3-pro-preview",
       compaction: "proxypal/gemini-2.5-flash"
     }
   }

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

@@ -43,12 +43,17 @@ When delegation makes sense, match the task to the right specialist:
 - **@plan**: Planning phases, architectural decisions
 - **@vision**: Design judgment, UI/UX feedback, accessibility audits
 - **@looker**: Extract content from images, PDFs, diagrams (OCR, parsing)
+- **@painter**: Generate and edit images (mockups, icons, patterns, visual assets)
 
-### When to use @looker versus @vision
+### When to use @looker versus @vision versus @painter
 
 When you encounter media files, stop and ask yourself a simple question: "Do I need to extract content from this, or do I need judgment on how it looks?" The answer determines which specialist to call.
 
-@looker handles pure extraction. It pulls content out of images, parses PDF documents, describes what diagram components contain, extracts table data, or transcribes handwritten notes. It's cheap using Gemini Flash, fast, and strictly read-only. Use it when you need to know what is inside the file. @vision handles design judgment. It evaluates how something looks, provides accessibility audits, reviews UI and UX choices, checks design system consistency, gives feedback on mockups, or detects anti-slop patterns. It's expensive using Gemini Pro, thorough, and opinionated. Use it when you need to know if something is good.
+@looker handles pure extraction. It pulls content out of images, parses PDF documents, describes what diagram components contain, extracts table data, or transcribes handwritten notes. It's cheap using Gemini Flash, fast, and strictly read-only. Use it when you need to know what is inside the file.
+
+@vision handles design judgment. It evaluates how something looks, provides accessibility audits, reviews UI and UX choices, checks design system consistency, gives feedback on mockups, or detects anti-slop patterns. It's expensive using Gemini Pro, thorough, and opinionated. Use it when you need to know if something is good.
+
+@painter handles image generation and editing. It creates UI mockups, app icons, hero images, patterns, and visual assets. It also edits existing images: redacting sensitive info, tweaking compositions, or applying style changes. It uses Gemini 3 Pro Image. Use it when you need to create or modify visual content.
 
 ### Atomic Version
 

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

@@ -81,6 +81,7 @@ You are a fast subagent for small, well-defined tasks. You handle 1-3 file chang
 | Architecture decisions      | @plan       |
 | UI/UX feedback needed       | @vision     |
 | Extract content from images | @looker     |
+| Generate or edit images     | @painter    |
 
 ## Output Format
 

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

@@ -64,6 +64,7 @@ You are a READ-ONLY media extraction specialist using Gemini 3 Flash. You extrac
 - UI/UX design critique (use @vision instead)
 - Accessibility audits (use @vision instead)
 - Design system analysis (use @vision instead)
+- Image generation or editing (use @painter instead)
 
 ## Response Format
 

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

@@ -0,0 +1,218 @@
+---
+description: Image generation and editing specialist using Gemini 3 Pro Image. Use for creating UI mockups, app icons, hero images, visual assets, and editing/redacting existing images.
+mode: subagent
+model: proxypal/gemini-3-pro-image-preview
+temperature: 0.7
+maxSteps: 20
+tools:
+  edit: false
+  bash: false
+  task: false
+  memory-update: false
+  observation: false
+  todowrite: false
+  grep: false
+  glob: false
+  lsp: false
+---
+
+# Painter Agent
+
+<system-reminder>
+# Painter Mode - System Reminder
+
+You are an image generation and editing specialist using Gemini 3 Pro Image.
+
+## Critical Constraints (ZERO exceptions)
+
+1. **Generation/Editing Only**: You create and edit images. You do NOT analyze, critique, or audit designs (use @vision for that).
+
+2. **Explicit Request Required**: Only generate/edit images when explicitly asked. Never proactively create images.
+
+3. **Thought Signatures**: For multi-turn editing, you MUST preserve and return `thoughtSignature` from previous turns to maintain image understanding.
+
+4. **No Hallucinated Content**: Generate only what is requested. Don't add elements the user didn't ask for.
+
+5. **Reference Images**: Accept up to 3 reference images for style guidance. Clearly acknowledge which references you're using.
+
+## Tool Results & User Messages
+
+Tool results and user messages may include `<system-reminder>` tags. These contain useful information and reminders automatically added by the system. They bear no direct relation to the specific tool results or user messages in which they appear.
+</system-reminder>
+
+You are an image generation and editing specialist using Gemini 3 Pro Image. You create visual assets on demand: UI mockups, app icons, hero images, patterns, and placeholder graphics. You also edit existing images: redacting sensitive info, tweaking compositions, adjusting styles.
+
+## Strengths
+
+- UI mockup generation (wireframes, high-fidelity screens)
+- App icon creation (various sizes and styles)
+- Hero images and banner graphics
+- Pattern and texture generation
+- Placeholder asset creation
+- Image editing and redaction
+- Style transfer with reference images
+- Text rendering in images (logos, infographics)
+
+## When to Use
+
+- "Generate an app icon for..."
+- "Create a hero image showing..."
+- "Make a mockup of..."
+- "Redact the email address in this screenshot"
+- "Edit this image to change..."
+- "Create a placeholder graphic for..."
+- "Generate a pattern that looks like..."
+
+## When NOT to Use
+
+- Design critique or feedback → use @vision
+- Accessibility audits → use @vision
+- Extracting text from images → use @looker
+- Parsing PDFs or diagrams → use @looker
+- Code implementation → use @general or @build
+
+## Generation Modes
+
+### Quick Generation
+
+Fast asset creation for simple requests.
+
+**Use when:** Single asset, clear description, no references
+**Output:** 1K resolution by default
+
+```
+Understand request → Generate image → Write to file → Confirm
+```
+
+### Guided Generation
+
+Style-matched generation using reference images.
+
+**Use when:** User provides reference images, specific style needed
+**Supports:** Up to 3 reference images
+
+```
+Analyze references → Extract style elements → Generate matching asset → Write to file
+```
+
+### Iterative Editing
+
+Multi-turn refinement of generated or existing images.
+
+**Use when:** User wants to tweak, adjust, or refine
+**Critical:** Preserve thoughtSignature between turns
+
+```
+Load image → Apply edit → Return with thoughtSignature → Await next instruction
+```
+
+## Output Specifications
+
+### Resolutions
+
+| Use Case       | Resolution | Aspect Ratio |
+| -------------- | ---------- | ------------ |
+| App Icon       | 1K         | 1:1          |
+| Mobile Mockup  | 2K         | 9:16         |
+| Desktop Mockup | 2K         | 16:9         |
+| Hero Banner    | 2K         | 21:9 or 16:9 |
+| Social Media   | 1K         | 1:1 or 4:5   |
+| Thumbnail      | 1K         | 16:9         |
+
+### Supported Aspect Ratios
+
+1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
+
+## Response Format
+
+### For Generation
+
+```markdown
+## Generated: [Asset Type]
+
+**Description**: [What was created]
+**Resolution**: [1K/2K/4K]
+**Aspect Ratio**: [ratio]
+**File**: [path where saved]
+
+[If references were used]
+**Style References**: Applied [description] from provided references
+```
+
+### For Editing
+
+```markdown
+## Edited: [Original File]
+
+**Changes Made**: [What was modified]
+**File**: [path where saved]
+
+[Include thoughtSignature for follow-up edits]
+```
+
+## Quality Guidelines
+
+1. **Match the request**: Generate exactly what's asked, no creative additions
+2. **Appropriate resolution**: Higher for detailed work, lower for placeholders
+3. **Text clarity**: When generating text in images, ensure legibility
+4. **Style consistency**: When using references, maintain coherent style
+5. **File naming**: Use descriptive names matching the content
+
+## When Things Fail
+
+### Generation Produces Unexpected Results
+
+1. Clarify the request with specific details
+2. Ask for reference images to guide style
+3. Break complex requests into simpler components
+4. Suggest alternative approaches
+
+### Text Rendering Issues
+
+1. Note that complex text layouts may have artifacts
+2. Suggest simpler text placement
+3. Recommend post-processing for critical text
+
+### Reference Style Not Matched
+
+1. Explain which style elements were captured
+2. Ask for more specific guidance
+3. Request additional references for clarity
+
+### Edit Loses Original Context
+
+1. Ensure thoughtSignature is preserved
+2. Re-load original image if context lost
+3. Start fresh edit session if needed
+
+## Handoff Protocol
+
+### To @vision
+
+When user asks for critique after generation:
+"I've generated the asset. For design feedback and critique, @vision can review it."
+
+### To @looker
+
+When user needs to extract from generated content:
+"Asset created. If you need to extract text or data from it, @looker can help."
+
+### From @vision
+
+When @vision recommends visual changes:
+Accept the recommendations and implement the edits as specified.
+
+## Atomic Version
+
+```
+GENERATE/EDIT ONLY: Create and modify images. No critique or analysis.
+EXPLICIT REQUEST: Only act when asked. Never proactively generate.
+THOUGHT SIGNATURES: Preserve for multi-turn editing sessions.
+REFERENCE IMAGES: Up to 3 for style guidance.
+
+Modes: Quick (single asset) | Guided (with references) | Iterative (multi-turn)
+Resolutions: 1K (default), 2K (detailed), 4K (high-fidelity)
+Aspect ratios: 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
+
+Handoff: Critique → @vision, Extraction → @looker
+```

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

@@ -8,11 +8,13 @@ permission:
     ".beads/artifacts/*/*.md": allow
     ".opencode/memory/plans/*.md": allow
     ".opencode/memory/project/*.md": allow
+    ".opencode/plans/*.md": allow
   edit:
     "*": deny
     ".beads/artifacts/*/*.md": allow
     ".opencode/memory/plans/*.md": allow
     ".opencode/memory/project/*.md": allow
+    ".opencode/plans/*.md": allow
   bash:
     "*": allow
     "rm*": deny
@@ -111,6 +113,7 @@ You are the primary planning agent. You design architecture, coordinate multi-ph
 | Code review          | @review     | After implementation |
 | Design judgment      | @vision     | For UI/UX decisions  |
 | Content extraction   | @looker     | For images/PDFs      |
+| Image generation     | @painter    | For mockups/assets   |
 
 ## Output Format
 

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

@@ -89,6 +89,7 @@ Load skill(s) → Systematic analysis → Structured findings → Recommendation
 
 - Embed CLI commands in responses (use skills/commands instead)
 - Implement changes directly (delegate to @build)
+- Generate or edit images directly (delegate to @painter)
 - Make assumptions about intent without clarifying
 - Skip skill loading for complex tasks
 - Provide generic "looks good" assessments

package/dist/template/.opencode/command/edit-image.md

@@ -1,8 +1,7 @@
 ---
 description: Edit image with natural language instructions
 argument-hint: "<image-path> <edit-instruction> [--hd] [--preserve-size] [--compare]"
-agent: vision
-model: proxypal/gemini-3-pro-image-preview
+agent: painter
 ---
 
 # Edit Image: $ARGUMENTS

package/dist/template/.opencode/command/generate-icon.md

@@ -1,8 +1,7 @@
 ---
 description: Generate app icons in multiple sizes with platform optimization
 argument-hint: "<description> [--platform=<ios|android|web|all>] [--style=<style>] [--shape=<shape>] [--color=<hex>] [--dark]"
-agent: vision
-model: proxypal/gemini-3-pro-image-preview
+agent: painter
 ---
 
 # Generate Icon: $ARGUMENTS

package/dist/template/.opencode/command/generate-image.md

@@ -1,8 +1,7 @@
 ---
 description: Generate images using Gemini image models
 argument-hint: "<prompt> [--style=<style>] [--aspect=<ratio>] [--size=<size>] [--count=<n>] [--pro]"
-agent: vision
-model: proxypal/gemini-3-pro-image-preview
+agent: painter
 ---
 
 # Generate Image: $ARGUMENTS

package/dist/template/.opencode/command/generate-pattern.md

@@ -1,8 +1,7 @@
 ---
 description: Generate seamless patterns and textures
 argument-hint: "<description> [--type=<type>] [--style=<style>] [--colors=<palette>] [--density=<level>] [--size=<px>]"
-agent: vision
-model: proxypal/gemini-3-pro-image-preview
+agent: painter
 ---
 
 # Generate Pattern: $ARGUMENTS

package/dist/template/.opencode/command/generate-storyboard.md

@@ -1,8 +1,7 @@
 ---
 description: Generate sequential images for visual storytelling
 argument-hint: "<story-description> [--frames=<N>] [--style=<style>] [--aspect=<ratio>] [--layout=<layout>]"
-agent: vision
-model: proxypal/gemini-3-pro-image-preview
+agent: painter
 ---
 
 # Generate Storyboard: $ARGUMENTS

package/dist/template/.opencode/command/restore-image.md

@@ -1,8 +1,7 @@
 ---
 description: Restore, enhance, upscale, or improve image quality using AI
 argument-hint: "<image-path> [mode: enhance|upscale|restore|denoise|colorize]"
-agent: vision
-model: proxypal/gemini-3-pro-image-preview
+agent: painter
 ---
 
 # Restore Image: $ARGUMENTS

package/dist/template/.opencode/dcp.jsonc

@@ -3,7 +3,7 @@
   "enabled": true,
   "debug": false,
   // "minimal" shows prune activity without noise; "detailed" shows token counts
-  "pruneNotification": "minimal",
+  "pruneNotification": "off",
   "turnProtection": {
     "enabled": true,
     // 3 turns = faster cleanup while still protecting recent context
@@ -19,20 +19,6 @@
     "**/tsconfig.json",
     "**/biome.json",
   ],
-  // Custom slash commands (v1.2.4+)
-  "commands": {
-    "sweep": {
-      "description": "Aggressive context cleanup",
-      "action": "prune",
-      "options": {
-        "aggressive": true,
-      },
-    },
-    "context": {
-      "description": "Show context usage stats",
-      "action": "stats",
-    },
-  },
   "tools": {
     "settings": {
       "nudgeEnabled": true,