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

# Clone repository
git clone https://github.com/icysaintdx/OpenCode-Config-Manager.git
cd OpenCode-Config-Manager

# Install dependencies
pip install PyQt5 PyQt-Fluent-Widgets

# Run
python opencode_config_manager_fluent.py

System 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)

1. Remote Config - Retrieved via .well-known/opencode
2. Global Config - ~/.config/opencode/opencode.json
3. Custom Config - Specified by OPENCODE_CONFIG environment variable
4. Project Config - <project>/opencode.json
5. .opencode Directory - <project>/.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

{
  "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

Latest Release

v1.8.0 - 2026-02-17

• 🌐 OCCM Web Edition - Full 17-page web interface with NiceGUI, glassmorphism CSS, cross-platform builds
• 🐛 Issue Fixes - Provider save crash (#1), web scroll jank, multiple web page fixes
• 📦 Unified CI - Desktop + Web 6-platform artifacts in single GitHub Release

v1.7.2 - 2026-02-08

• 🐛 Crash Fixes - Fixed full-config apply crash, GLM balance-query crash, and improved global exception handling
• 📦 Packaging Fixes - Added hidden imports to resolve Skill marketplace requests install errors in packaged builds
• 🧭 UX Improvements - MCP dialog now supports better vertical resize/collapse behavior and theme preference persistence

v1.7.1 - 2026-01-28

• 🎯 Agent Group Management System - Create and manage agent groups, 6 preset templates
• 🎨 Pivot Tab UI - Switch between OpenCode/OMO agents
• 🔢 Agent Count Display - Show selected/total count, tooltip with details
• 🐛 Bug Fixes - Dialog layout optimization, OMO description display fix

v1.7.0 - 2026-01-28

• 🔧 Provider Configuration Standardization - auth.json format fix, Provider naming fix
• 🆕 Z.AI Provider Support - Added zai and zai-coding-plan providers
• 📝 Technical Documentation - Added 5 Provider configuration technical documents

v1.6.0 - 2026-01-27

• 🔌 Plugin Management System - Complete plugin install/uninstall/marketplace functionality
• 📄 Config File Viewer - JSON syntax highlighting, dark theme, bracket matching
• 🔍 Auto-Detect Native Providers - Environment variable detection for 12 official providers
• 🐛 Bug Fixes - Fixed translation issues, Plugin page startup errors, macOS crash
• 🎨 UI Improvements - Pivot tabs for Oh My OpenCode, navigation menu simplification

v1.5.0 - 2026-01-24

• 🌐 Multi-Language Support - Simplified Chinese + English, dynamic switching without restart
• 🇨🇳 Chinese AI Platforms - Support Zhipu GLM, Qwen, Kimi, Yi, MiniMax
• 🐛 Bug Fixes - Fixed Win10 startup error, language switch page misalignment
• 🎨 UI Improvements - Navigation bar width 200px, menu expanded by default

v1.4.0 - 2026-01-20

• ⭐ Skill Marketplace - Built-in 12 curated Skills, browse by category + search
• 🛡️ Security Scanning - Detect 9 dangerous code patterns, security scoring system
• 🎨 UI Improvements - New marketplace button and security scan button

v1.3.0 - 2026-01-20

• 📦 Skills Installation - Support install Skills from GitHub and local
• 🔄 Skills Update - One-click check updates, batch update support
• 📝 Metadata Management - Auto-generate .skill-meta.json to record installation info

v1.2.0 - 2026-01-20

• 🔧 Oh My MCP Management - Visually manage 3 built-in MCP servers from Oh My OpenCode

v1.1.9 - 2026-01-20

• 🐛 Fixed MCP config non-compliance causing OpenCode startup failure

v1.1.8 - 2026-01-20

• 🐛 Fixed startup crash due to abnormal config file format

v1.1.7 - 2026-01-20

• 🆕 CLI Tool Export - Claude Code, Codex, Gemini config export
• 🎨 UI Optimization - Navigation menu font bold, CLI export page tab layout

v1.1.6 - 2026-01-19

• 🆕 Native Provider Support - Manage 12 OpenCode official AI service providers
• 🔐 AuthManager - Independent auth.json file management

v1.0.0 - 2026-01-14

• 🎨 Fluent Design Complete Refactor - Migrated from ttkbootstrap to PyQt5 + QFluentWidgets
• 🌓 Dark/Light Theme - Auto-switch following system

View Full Changelog → | 查看中文更新日志 →

---

---

🔗 Related Projects

• OpenCode - AI Coding Assistant
• Oh My OpenCode - OpenCode Enhancement Plugin

---

📄 License

MIT License

---

🤝 Contributing

Issues and Pull Requests are welcome!

1. Fork this repository
2. Create feature branch (git checkout -b feature/AmazingFeature)
3. Commit changes (git commit -m 'Add some AmazingFeature')
4. Push to branch (git push origin feature/AmazingFeature)
5. Submit Pull Request

---

Made with ❤️ by IcySaint