drizzy-agent 0.3.1 → 0.4.1

package/README.md

@@ -1,8 +1,6 @@
 # DrizzyAgent
 
-**DrizzyAgent** is an AI agent harness that extends Claude Code (OpenCode fork) with multi-agent orchestration. It provides a powerful system for coding tasks with specialized agents for different types of work.
-
-> If you have a stale cached plugin install, clear it with: `rm -rf ~/.cache/opencode/node_modules/drizzy-agent`
+**DrizzyAgent** is an AI agent harness that extends OpenCode (oh-my-opencode fork) with multi-agent orchestration. It provides a powerful system for coding tasks with specialized agents for different types of work.
 
 Built for those who want the power of multi-model AI agents without the complexity of managing them manually.
 
@@ -98,27 +96,86 @@ Create `.opencode/drizzy-agent.jsonc` or `~/.config/opencode/drizzy-agent.jsonc`
 {
   "agents": {
     "coder": {
-      "model": "claude-opus-4"
+      "model": "anthropic/claude-opus-4-6"
     }
   },
   "categories": {
     "visual-engineering": {
-      "model": "claude-opus-4"
+      "model": "anthropic/claude-opus-4-6"
     }
   },
   "disabled_hooks": []
 }
 ```
 
-### Troubleshooting: Version Display Issues
+### How Configuration Works (Snapshot-Based Defaults)
+
+DrizzyAgent uses a **snapshot-based** configuration system. When you run `drizzy-agent install`, the tool creates a minimal config containing only your provider selections:
+
+```jsonc
+{
+  "$schema": "...",
+  "_install_defaults": {
+    "snapshot_version": 1,
+    "providers": {
+      "claude": "yes",
+      "openai": false,
+      "gemini": false,
+      // ... which providers you selected during install
+    }
+  }
+}
+```
+
+The `_install_defaults` section is **install-managed and read-only**. It captures which providers you selected. The actual `agents` and `categories` configuration is computed at runtime from current fallback rules based on your available providers.
+
+**Benefits of this approach:**
+- Your config stays small and focused on your provider choices
+- Model fallbacks automatically improve with each plugin update
+- No manual updates needed when better models become available
+
+#### Adding Custom Overrides
+
+You can add explicit overrides on top of the computed defaults:
+
+```jsonc
+{
+  "_install_defaults": { /* ... */ },
+  "agents": {
+    "coder": {
+      "model": "claude-opus-4"  // This overrides the computed default
+    }
+  },
+  "categories": {
+    "deep": {
+      "model": "o3-mini"  // Override for specific category
+    }
+  }
+}
+```
+
+Explicit overrides take precedence over computed defaults. Omitting a field means "use the computed default."
 
-If you see an old version (like 3.11.2) instead of the current version, clear the cache:
+#### Updating Provider Selections
+
+Rerun the install command to update provider selections:
 
 ```bash
-rm -rf ~/.cache/opencode/node_modules/drizzy-agent
+bunx drizzy-agent install
 ```
 
-This removes cached data from the previous package name.
+Or manually override by editing `~/.config/opencode/drizzy-agent.jsonc`:
+
+```jsonc
+{
+  "agents": {
+    "coder": { "model": "claude-opus-4" }
+  },
+  "categories": {
+    "deep": { "model": "o3-mini" }
+  }
+}
+```
 
 ## Development