Initial commit

commands/models.md

@@ -0,0 +1,181 @@
+# Manage Ollama Models
+
+Discover, list, and manage ollama models for the agent pipeline.
+
+**Usage:** `/models [action] [target]`
+
+**Actions:**
+- `discover`: Scan and register all installed ollama models
+- `list`: Show all registered models and capabilities
+- `check <model>`: Verify specific model availability
+- `defaults`: Show default models for each task type
+
+**Examples:**
+- `/models discover` - Scan for new models
+- `/models list` - Show all models
+- `/models check kimi-k2-thinking:cloud` - Check if model available
+- `/models defaults` - Show default selections
+
+---
+
+You are managing the ollama model registry.
+
+**Action:** ${1:-list}
+**Target:** $2
+
+**Your Process:**
+
+1. **Execute Action:**
+
+   **Discover:**
+   ```bash
+   # Scan ollama and update registry
+   ~/.claude/scripts/discover-models.sh
+
+   # Show results
+   cat ~/.claude/model-capabilities.json | python3 -c "
+   import json, sys
+   data = json.load(sys.stdin)
+   print(f'Discovered {len(data[\"models\"])} models:')
+   for model, info in data['models'].items():
+       caps = ', '.join(set(info['capabilities']))
+       print(f'  - {model}: {caps}')
+   "
+   ```
+
+   **List:**
+   ```bash
+   # Show all models with capabilities
+   cat ~/.claude/model-capabilities.json | python3 -c "
+   import json, sys
+   from pathlib import Path
+
+   registry_file = Path.home() / '.claude' / 'model-capabilities.json'
+   with open(registry_file, 'r', encoding='utf-8') as f:
+       data = json.load(f)
+
+   print('## Registered Models\n')
+   for model, info in sorted(data['models'].items()):
+       caps = ', '.join(set(info['capabilities']))
+       family = info.get('family', 'unknown')
+       context = info.get('context_window', 'unknown')
+       cost = info.get('cost', 'unknown')
+
+       print(f'### {model}')
+       print(f'  - Family: {family}')
+       print(f'  - Capabilities: {caps}')
+       if isinstance(context, int):
+           print(f'  - Context: {context:,} tokens')
+       else:
+           print(f'  - Context: {context}')
+       print(f'  - Cost: {cost}')
+       print()
+   "
+   ```
+
+   **Check:**
+   ```bash
+   # Check if specific model is available
+   ~/.claude/scripts/check-model.sh $2
+   ```
+
+   **Defaults:**
+   ```bash
+   # Show default model selections
+   cat ~/.claude/model-capabilities.json | python3 -c "
+   import json, sys
+   from pathlib import Path
+
+   registry_file = Path.home() / '.claude' / 'model-capabilities.json'
+   with open(registry_file, 'r', encoding='utf-8') as f:
+       data = json.load(f)
+
+   print('## Default Models by Task\n')
+   defaults = data.get('user_defaults', {})
+   for task, model in sorted(defaults.items()):
+       print(f'- **{task}**: {model}')
+
+   print('\n## Task Preferences with Fallbacks\n')
+   prefs = data.get('task_preferences', {})
+   for task, config in sorted(prefs.items()):
+       if config.get('preferred'):
+           print(f'### {task}')
+           print(f'  Preferred: {config[\"preferred\"][0]}')
+           if config.get('fallback'):
+               fallbacks = config['fallback'][:3]
+               print(f'  Fallbacks: {\" -> \".join(fallbacks)}')
+           print()
+   "
+   ```
+
+2. **Model Capability Reference:**
+
+   **Vision Models:**
+   - qwen3-vl:235b-instruct-cloud (best vision, 262K context)
+   - qwen3:1.7b (lightweight, has vision)
+
+   **Code Models:**
+   - kimi-k2-thinking:cloud (reasoning + code, 262K context)
+   - deepseek-v3.1:671b-cloud (strong code, 163K context)
+   - qwen2.5-coder:3b (lightweight coder)
+
+   **Reasoning Models:**
+   - kimi-k2-thinking:cloud (explicit thinking)
+   - deepseek-v3.1:671b-cloud (strong reasoning)
+
+   **General Purpose:**
+   - All models have general capability
+   - Prefer larger models for complex tasks
+
+3. **Registry Location:**
+   - File: `~/.claude/model-capabilities.json`
+   - Contains: Models, capabilities, defaults, task preferences
+   - Auto-updated: By discover-models.sh
+
+4. **Capability Taxonomy:**
+   - `vision`: Image analysis, OCR, screenshots
+   - `code`: Code review, refactoring, security
+   - `reasoning`: Multi-step logic, complex analysis
+   - `general`: General purpose tasks
+
+**Common Operations:**
+
+```bash
+# After installing new ollama model
+/models discover
+
+# Before using specific model
+/models check deepseek-v3.1:671b-cloud
+
+# See what's available
+/models list
+
+# Check your defaults
+/models defaults
+```
+
+**Registry Structure:**
+```json
+{
+  "models": {
+    "model-name": {
+      "capabilities": ["code", "reasoning"],
+      "context_window": 128000,
+      "family": "deepseek",
+      "cost": "cloud"
+    }
+  },
+  "user_defaults": {
+    "code": "kimi-k2-thinking:cloud",
+    "vision": "qwen3-vl:235b-instruct-cloud"
+  },
+  "task_preferences": {
+    "code": {
+      "preferred": ["kimi-k2-thinking:cloud"],
+      "fallback": ["deepseek-v3.1:671b-cloud", ...]
+    }
+  }
+}
+```
+
+**Remember:** Keep your model registry up to date for best agent performance!