OpenCode Config Manager
Visual GUI Tool for Managing OpenCode and Oh My OpenCode Configuration Files
Highlights •
Features •
Installation •
Configuration •
Version History
English | 简体中文
✨ Highlights
Say goodbye to manual JSON editing - Configure your AI coding assistant with one click!
Fluent Design Style - Microsoft design language, modern card layout, automatic dark/light theme switching
Zero Learning Curve - Visual operations, no need to memorize JSON structure, easy for beginners
All-in-One Management - Provider, Model, MCP, Agent, Permissions - all in one place
️ Smart Configuration Validation - Auto-detect configuration issues on startup, one-click format error fixes
Cross-Platform Support - Native support for Windows / macOS / Linux
External Import - One-click import from Claude Code, Codex, Gemini, and more
v1.8.0 Latest Version
OCCM Web Edition
Full Web Interface — 17 pages, NiceGUI-based, browser access with glassmorphism CSS design system
Custom Config Path — --config-dir CLI arg / OPENCODE_CONFIG_DIR env var / auto-open browser
Cross-Platform Builds — Windows exe / macOS zip / Linux tar.gz, unified release with desktop
Key Fixes
Provider Save Crash Fix (Issue #1) — hasattr guard for _on_models_fetched
Web Scroll Jank Fix — Removed blur/smooth-scroll, simplified transitions
Improvements
Provider + Model merged into collapsible page
Permission/Category/Rules inline editing
Sidebar grouped navigation with icons
v1.7.0 Version Recap
New Features
Provider Configuration Standardization ⭐⭐⭐
Complete Plugin Management :
Install plugins from GitHub URL
One-click uninstall installed plugins
Browse and search plugin marketplace
View plugin details, version, and author
Technical Implementation :
GitHub API integration for plugin information
JSON-based plugin metadata management
Fuzzy search for plugin name, description, and author
Config File Viewer ⭐⭐
Visual Config Viewer :
JSON syntax highlighting
Dark theme adaptation
Cross-line bracket highlighting
Bracket matching hints
One-click edit config files
Location : Home page → Config file viewer area
Auto-Detect Native Providers ⭐
Environment Variable Detection :
Auto-detect 12 official providers (Anthropic, OpenAI, Google, Azure, etc.)
One-click detection via "Detect Configured" button
Display detection results in table format
Location : Native Provider page → "Detect Configured" button
Bug Fixes
Translation Issues - Fixed hard-coded English text in Chinese mode
Added missing translation keys (common.sdk, common.provider, etc.)
Replaced all hard-coded text with tr() function calls
Plugin Page Startup Errors - Fixed missing QTableWidget and SearchLineEdit imports
macOS Crash Issue - Fixed navigation bar expand timing issue
Mac Install Script - Support multiple directory structures
Config Detection - Added @ai-sdk/openai-compatible to valid npm package list
Skill Marketplace Issues - Fixed 4 issues (selection logic, install display, etc.)
Zhipu GLM Config - Removed non-standard modelListUrl field
UI Improvements
Oh My OpenCode Interface - Use Pivot tabs to switch between Agent and Category
Navigation Menu Simplification - Merged related function pages, reduced menu items
Config Viewer Optimization - Dark theme, cross-line bracket highlighting, bracket matching
v1.5.0 Feature Recap
Complete Multi-Language Support ⭐⭐⭐
Bilingual Support :
Simplified Chinese (zh_CN)
English (en_US)
Auto-detect system language
Dynamic Language Switching : Switch instantly without restart
Chinese AI Platform Support ⭐
5 New Chinese Platforms :
Zhipu GLM (glm-4-plus, glm-4-flash, etc.)
Qwen (qwen-max, qwen-turbo, etc.)
Kimi (Moonshot) (moonshot-v1-8k, moonshot-v1-32k, etc.)
Yi (01.AI) (yi-lightning, yi-large, etc.)
MiniMax (abab6.5s-chat, abab6.5g-chat, etc.)
v1.4.0 Feature Recap
Skill Marketplace ⭐
Built-in Skill Marketplace :
12 curated Skills (Dev Tools, Code Quality, Testing, Documentation, Security, API, Database)
Browse by category + search functionality
One-click installation to specified location
Security Scanning ⭐
Code Security Scanning :
Detects 9 types of dangerous code patterns
Security scoring system (0-100 points)
Risk level visualization (Safe/Low/Medium/High/Critical)
Detailed issue list (line number, risk level, description, code)
v1.3.0 Feature Recap
Skills Installation & Update ⭐
Install Skills from GitHub :
Support GitHub shorthand: user/repo (e.g., vercel-labs/git-release)
Support full URL: https://github.com/user/repo
Auto download, extract, parse SKILL.md
Install to 4 locations: OpenCode global/project, Claude global/project
Import Skills from Local :
Support local path import: ./my-skill or /path/to/skill
Auto validate SKILL.md format
Update Detection & Batch Update :
One-click check updates for all installed Skills
Compare commit hash via GitHub API
Table display update status (Has Update/Latest/Local)
Support selective batch update
Metadata Management :
Auto generate .skill-meta.json to record installation info
Record source, version, installation time, etc.
v1.2.0 Feature Recap
New Features
Oh My MCP Management - New "Oh My MCP" button in MCP Server page, visually manage 3 built-in MCP servers (websearch, context7, grep_app) from Oh My OpenCode, support enable/disable operations, config auto-saved to oh-my-opencode.json
v1.1.9 Feature Recap
Bug Fixes
Fixed MCP config non-compliance causing OpenCode startup failure - When adding MCP via software, OpenCode startup error Invalid input mcp.@modelcontextprotocol/server-sequential-thinking. Now fixed:
MCP key name standardization: Use simplified key names (e.g., sequential-thinking) instead of npm package names with special characters
Remove non-standard fields: description, tags, homepage, docs no longer written to config file, only used for UI display
Fully compliant with OpenCode official MCP config specification
v1.1.8 Feature Recap
Bug Fixes
Fixed startup crash due to abnormal config file format - When permission, mcp, agent fields are non-dict types in config file, program startup error AttributeError: 'str' object has no attribute 'items', now added type checking to ensure program robustness
v1.1.7 Feature Recap
CLI Tool Export
Claude Code Multi-Model Config - Support 4 model fields (main model, Haiku, Sonnet, Opus)
Codex/Gemini Dual-File Preview - Dual-file tab preview (auth.json + config.toml / .env + settings.json)
Base URL Temporary Modification - Can temporarily modify for export without affecting original config
Custom Model Input - Support manual input of custom model names
Syntax Highlighting & Formatting - JSON/TOML/ENV format syntax highlighting + format button
Common Config Feature - Write common config checkbox + edit common config dialog
UI Improvements
Navigation Menu Font Bold - Improve menu readability and visual hierarchy
CLI Export Page Tab Layout - Adopt main tab design for clearer intuition
Monitor Page Start/Stop Toggle - Default not started, need manual start button click
Bug Fixes
Model empty handling optimization
External import feature fixes
Features
Provider Management
✅ Add/Edit/Delete custom API providers
✅ Support multiple SDKs: @ai-sdk/anthropic, @ai-sdk/openai, @ai-sdk/google, @ai-sdk/azure
✅ API key secure show/hide
✅ SDK compatibility smart hints
Model Management
✅ Preset Common Models Quick Select - Claude, GPT-5, Gemini series one-click add
✅ Complete Preset Config - Select preset model auto-fill options and variants
✅ Thinking Mode Support :
Claude: thinking.type, thinking.budgetTokens
OpenAI: reasoningEffort (high/medium/low/xhigh)
Gemini: thinkingConfig.thinkingBudget
MCP Server Management
✅ Local Type - Configure startup command and environment variables
✅ Remote Type - Configure server URL and request headers
✅ Support enable/disable, timeout settings
✅ Preset common MCP servers (Context7, Sentry, etc.)
OpenCode Agent Configuration
✅ Mode Settings - primary / subagent / all
✅ Parameter Config - temperature, maxSteps, hidden, disable
✅ Tool Permissions - Configure available tools for Agent
✅ Preset Templates - build, plan, explore, code-reviewer, etc.
Oh My OpenCode Support
✅ Agent Management - Bind Provider/Model
✅ Category Management - Temperature slider adjustment
✅ Preset Templates - oracle, librarian, explore, etc.
Smart Features
✅ Config Validator - Auto-detect format issues on startup
✅ Auto Fix - One-click fix missing fields and format errors
✅ JSONC Support - Perfect compatibility with commented config files
✅ External Import - Support Claude Code, Codex, Gemini, cc-switch
✅ Backup & Restore - Multi-version backup management, one-click restore
Other Features
✅ GitHub Version Check - Auto-detect latest version
✅ Dark/Light Theme - Auto-switch following system
✅ Global Tooltip - Mouse hover shows parameter descriptions
✅ Unified Save Logic - Save changes directly write to file
Installation
Method 1: Download Pre-compiled Version (Recommended)
Download the executable file for your platform from Releases :
Platform
File
Description
Windows
OpenCodeConfigManager_windows.exe
Single file version, double-click to run
macOS
OpenCode-Config-Manager-MacOS.dmg
DMG image, drag to Applications
Linux
OpenCode-Config-Manager-Linux-x64.tar.gz
Extract and run
Method 2: Run from Source
bash 复制
git clone https://github.com/icysaintdx/OpenCode-Config-Manager.git
cd OpenCode-Config-Manager
pip install PyQt5 PyQt-Fluent-Widgets
python opencode_config_manager_fluent.pySystem Requirements : Python 3.8+
⚙️ Configuration
Config File Locations
Config File
Path
OpenCode
~/.config/opencode/opencode.json
Oh My OpenCode
~/.config/opencode/oh-my-opencode.json
Backup Directory
~/.config/opencode/backups/
Config Priority (High to Low)
Remote Config - Retrieved via .well-known/opencode
Global Config - ~/.config/opencode/opencode.json
Custom Config - Specified by OPENCODE_CONFIG environment variable
Project Config - /opencode.json
.opencode Directory - /.opencode/config.json
Options vs Variants
According to OpenCode Official Documentation :
options : Default config parameters for the model, used in every call
variants : Switchable variant configs, toggle via variant_cycle shortcut
json 复制
{
"provider" : {
"anthropic" : {
"models" : {
"claude-sonnet-4-5-20250929" : {
"options" : {
"thinking" : { "type" : "enabled" , "budgetTokens" : 16000 }
} ,
"variants" : {
"high" : { "thinking" : { "type" : "enabled" , "budgetTokens" : 32000 } } ,
"max" : { "thinking" : { "type" : "enabled" , "budgetTokens" : 64000 } }
}
}
}
}
}
}
Version History