| name | opencode-config-advisor |
| description | Detects, analyzes, and suggests changes to the Opencode CLI configuration file (config.json). Use this when the user complains about Opencode performance, asks to change the default model, or wants to modify CLI behavior. |
Opencode Config Advisor
Goal
To locate the active Opencode configuration file, read its current state, and propose valid JSON modifications to satisfy user requirements (e.g., switching models, increasing context limits, changing output format).
Usage Rules
1. Config Discovery
Always check for the configuration file in the following order of precedence:
- Project Local:
./opencode.json (or .opencode/config.json)
- Global (User):
~/.config/opencode/opencode.json
- Legacy:
~/.opencode.json
Command to use: ls -F ~/.config/opencode/opencode.json ./opencode.json 2>/dev/null
2. Analysis & Safety
- Read First: Always run
cat <path_to_found_config> before suggesting changes.
- Validate JSON: Ensure any proposed changes result in valid JSON. Do not use trailing commas.
- Backup: If executing a write operation, suggest backing up the original file first (
cp config.json config.json.bak).
3. Common Modifications
- Model Switching: Look for
"model" or "default_model". Common values are gpt-4o, claude-3-5-sonnet, gemini-pro.
- Context Window: Look for
"max_tokens" or "context_limit".
- API Keys: NEVER output full API keys in the chat. Use placeholders like
"sk-..." when displaying file content.
Examples
Example 1: Switch Model
User: "Opencode is being too expensive, switch it to a cheaper model."
Agent Execution:
- Locates
~/.config/opencode/opencode.json.
- Reads content.
- Proposes changing
"model": "gpt-4" to "model": "gpt-4o-mini".
Example 2: Debugging
User: "Why is Opencode ignoring my ignores?"
Agent Execution:
- Reads config to check the
"ignore_patterns" or "gitignore" setting.
- Checks if
.gitignore exists in the current directory.
- Suggests adding specific patterns to the config if the global setting is missing.
