micode 0.8.6 → 0.9.0

package/INSTALL_CLAUDE.md

@@ -160,15 +160,64 @@ Never run this automatically without consent.
 | `ast_grep_replace` | AST-aware code replace |
 | `look_at` | Screenshot analysis |
 
-### Model Override
+### Model Configuration
 
-To use different models, create `~/.config/opencode/micode.json`:
+micode respects your OpenCode default model. Set it in `~/.config/opencode/opencode.json`:
+
+```json
+{
+  "model": "github-copilot/gpt-5-mini"
+}
+```
+
+This model will be used for **all** micode agents automatically.
+
+#### Per-Agent Overrides
+
+To override specific agents, create `~/.config/opencode/micode.json`:
 
 ```json
 {
   "agents": {
-    "commander": { "model": "your-preferred-model" },
-    "brainstormer": { "model": "your-preferred-model" }
+    "brainstormer": { "model": "openai/gpt-4o" }
   }
 }
 ```
+
+**Model resolution priority:**
+1. Per-agent override in `micode.json` (highest)
+2. Default model from `opencode.json` `"model"` field
+3. Plugin default (hardcoded in agent definitions)
+
+#### Model Syntax
+
+Models must use the format `provider/model` where:
+- `provider` is the provider ID from your `opencode.json` (e.g., `openai`, `anthropic`, `github-copilot`)
+- `model` is the model ID configured under that provider
+
+**To find valid model names:**
+
+1. Check your `~/.config/opencode/opencode.json` for the `provider` section
+2. Look for the provider name (the key) and model names under `models`
+
+**Example opencode.json structure:**
+```json
+{
+  "provider": {
+    "github-copilot": {
+      "models": {
+        "gpt-5-mini": { "limit": { "context": 128000 } }
+      }
+    }
+  }
+}
+```
+
+For the above config, use `"model": "github-copilot/gpt-5-mini"`.
+
+**Important:** The provider name must match exactly. If OpenCode shows `github-copilot` as the provider ID, use `github-copilot/model-name` (not `github/copilot:model-name` or other variations).
+
+#### Built-in Models
+
+The following model bypasses validation:
+- `opencode/big-pickle` - OpenCode's default model, always valid

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vtemian
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -87,6 +87,72 @@ Maintain context across sessions with structured compaction. Run `/ledger` to cr
 - **Context Injector** - Injects ARCHITECTURE.md, CODE_STYLE.md
 - **Token-Aware Truncation** - Truncates large tool outputs
 
+## Configuration
+
+### Model Configuration
+
+micode reads your default model from `opencode.json`:
+
+```json
+{
+  "model": "github-copilot/gpt-5-mini",
+  "plugin": ["micode"]
+}
+```
+
+All micode agents will use this model automatically.
+
+### micode.json
+
+Create `~/.config/opencode/micode.json` for micode-specific settings:
+
+```json
+{
+  "agents": {
+    "brainstormer": { "model": "openai/gpt-4o", "temperature": 0.8 },
+    "commander": { "maxTokens": 8192 }
+  },
+  "features": {
+    "mindmodelInjection": true
+  },
+  "compactionThreshold": 0.5,
+  "fragments": {
+    "commander": ["custom-instructions.md"]
+  }
+}
+```
+
+#### Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `agents` | object | Per-agent overrides (model, temperature, maxTokens) |
+| `features.mindmodelInjection` | boolean | Enable mindmodel context injection |
+| `compactionThreshold` | number | Context usage threshold (0-1) for auto-compaction. Default: 0.5 |
+| `fragments` | object | Additional prompt fragments per agent |
+
+#### Model Resolution Priority
+
+1. Per-agent override in `micode.json` (highest)
+2. Default model from `opencode.json` `"model"` field
+3. Plugin default (fallback)
+
+#### Model Syntax
+
+Models use `provider/model` format. The provider must match exactly what's in your `opencode.json`:
+
+```json
+{
+  "provider": {
+    "github-copilot": {
+      "models": { "gpt-5-mini": {} }
+    }
+  }
+}
+```
+
+Use `"model": "github-copilot/gpt-5-mini"` (not `github/copilot:gpt-5-mini`).
+
 ## Development
 
 ```bash