omo-config-studio

Visual configuration manager for oh-my-opencode. Browse every model available in opencode and assign them to agents and categories through a web UI, instead of hunting down model IDs and editing JSON by hand.

Quick Start

npx omo-config-studio

That's it. A local server starts and your browser opens. No global install, no config files to create.

The UI is in Chinese. If you'd like to contribute an English locale, PRs are welcome.

Prerequisites

| Requirement | Why | |---|---| | Node.js >= 22.11 | Runtime for the server | | opencode CLI | Source of model data. The tool calls opencode models to list providers and models | | oh-my-opencode | The config layer this tool manages |

Graceful degradation: If opencode CLI is not found, models are read from the config file (may be incomplete). If oh-my-opencode is not installed, you'll get a warning but can still explore models.

Features

• Visual model browser — models grouped by provider, with instant search
• Agent assignment — configure all 11 oh-my-opencode agents (Sisyphus, Oracle, Prometheus, Metis, Momus, Hephaestus, Librarian, Explore, Atlas, Multimodal-Looker, Sisyphus-Junior)
• Category assignment — configure 8 task categories (quick, deep, ultrabrain, visual-engineering, writing, artistry, unspecified-low, unspecified-high)
• Variant support — automatically picks up model variants defined in opencode.json
• Auto-backup — timestamped .bak file created before every save
• JSON preview — inspect the full config before hitting save
• Zero config — detects your opencode setup automatically, no setup wizard needed

How It Works

  ┌──────────────────────────────────────────────────┐
  │  Your browser (localhost:3001)                    │
  │  ┌───────────────┐   ┌────────────────────────┐  │
  │  │  Model Browser │   │  Config Panel           │  │
  │  │  (left panel)  │   │  Agents / Categories /  │  │
  │  │               │   │  Preview tabs            │  │
  │  └───────┬───────┘   └───────────┬────────────┘  │
  │          │ REST API               │                │
  └──────────┼────────────────────────┼───────────────┘
             ▼                        ▼
  ┌──────────────────────────────────────────────────┐
  │  Express server (port 3001)                       │
  │  ┌──────────┐  ┌──────────┐  ┌─────────────────┐ │
  │  │ /api/     │  │ /api/    │  │ /api/schema     │ │
  │  │ models    │  │ config   │  │ (agents + cats) │ │
  │  └────┬─────┘  └────┬─────┘  └─────────────────┘ │
  │       ▼             ▼                             │
  │  opencode CLI   oh-my-opencode.json               │
  │  + opencode.json   (read/write + auto-backup)     │
  └──────────────────────────────────────────────────┘

The server reads models via opencode models CLI and merges variant data from opencode.json. Config changes are written to oh-my-opencode.json with an automatic backup.

API

| Endpoint | Method | Description | |---|---|---| | /api/models | GET | All available models grouped by provider, with variant info | | /api/config/omo | GET | Read current oh-my-opencode.json | | /api/config/omo | PUT | Write new config (auto-backup first) | | /api/config/opencode | GET | Read opencode.json (read-only, for variant details) | | /api/schema | GET | Valid agent IDs and category IDs |

Configuration Paths

The server finds your config directory with this priority:

1. OPENCODE_CONFIG_DIR environment variable
2. ~/.config/opencode/ (if opencode.json exists)
3. %APPDATA%/opencode/ (Windows fallback)
4. Falls back to ~/.config/opencode/

Two files matter:

• opencode.json — read-only. Provider config and variant definitions live here.
• oh-my-opencode.json — read-write. This is where agent/category model assignments are stored.

Related Projects

• opencode — The AI coding CLI that provides model data
• oh-my-opencode — The agent/category config layer this tool manages

License

Apache-2.0

中文文档

可视化 oh-my-opencode 模型配置管理工具。通过 Web UI 浏览 opencode 中所有可用模型，并分配给 OMO 的 agents 和 categories，告别手动查找 model ID 和编辑 JSON。

快速开始

npx omo-config-studio

启动本地服务并自动打开浏览器，无需全局安装，无需额外配置。

前置要求

| 需求 | 说明 | |---|---| | Node.js >= 22.11 | 服务端运行环境 | | opencode CLI | 模型数据来源，工具通过 opencode models 获取可用模型列表 | | oh-my-opencode | 本工具管理的配置层 |

如果未检测到 opencode CLI，工具会从配置文件读取模型（可能不完整）。如果未安装 oh-my-opencode，仍可浏览模型，但配置功能不可用。

功能

• 可视化模型浏览器 — 按 provider 分组展示，支持即时搜索
• Agent 配置 — 支持全部 11 个 oh-my-opencode agent（Sisyphus、Oracle、Prometheus、Metis、Momus、Hephaestus、Librarian、Explore、Atlas、Multimodal-Looker、Sisyphus-Junior）
• Category 配置 — 支持 8 个任务类别（quick、deep、ultrabrain、visual-engineering、writing、artistry、unspecified-low、unspecified-high）
• 模型变体支持 — 自动读取 opencode.json 中定义的 variant
• 自动备份 — 每次保存前生成带时间戳的 .bak 备份文件
• JSON 预览 — 保存前可在预览标签页检查完整配置
• 开箱即用 — 自动检测 opencode 环境，无需额外设置

配置路径

服务端按以下优先级查找配置目录：

1. 环境变量 OPENCODE_CONFIG_DIR
2. ~/.config/opencode/（如果存在 opencode.json）
3. %APPDATA%/opencode/（Windows 回退）
4. 最终回退到 ~/.config/opencode/

关键文件：

• opencode.json 为只读，包含 provider 配置和 variant 定义
• oh-my-opencode.json 为读写，保存 agent/category 的模型分配

相关项目

• opencode — 提供模型数据的 AI 编码 CLI
• oh-my-opencode — 本工具所管理的 agent/category 配置层

许可证

Apache-2.0