Reference Packages, config files, CLI commands, categories, install flags, and environment variables.
A flat reference for the things you look up mid-session: command names, config paths, agent options, install flags, and the env vars that flip telemetry off.
The upstream rename is transitional and both packages are still published. Prefer oh-my-openagent and leave oh-my-opencode as a compatibility alias.
Name Purpose oh-my-openagentPreferred upstream npm package and primary installer command. oh-my-opencodeCompatibility package, still published during the rename transition. oh-my-openagent plugin entryPreferred OpenCode plugin entry when the installer can register it. oh-my-opencode plugin entryLegacy entry still recognized during transition; doctor warns when it's still in opencode.json.
Command Purpose bunx oh-my-openagent installInteractive installer. bunx oh-my-openagent install --no-tui ...Non-interactive setup for agent-driven installs. bunx oh-my-openagent doctorSystem, config, tool, and model-resolution diagnostics. bunx oh-my-openagent run <message>OpenCode session runner with completion enforcement. bunx oh-my-openagent get-local-versionShow installed plugin version and update status. bunx oh-my-openagent refresh-model-capabilitiesRefresh the cached model capabilities snapshot from models.dev. bunx oh-my-openagent versionVersion information. bunx oh-my-openagent mcp oauth login|logout|status ...OAuth helper for remote MCP servers (PKCE + dynamic client registration).
User config loads first; project config can override it. JSONC is supported.
Scope Paths Project .opencode/oh-my-openagent.json[c], .opencode/oh-my-opencode.json[c]User ~/.config/opencode/oh-my-openagent.json[c], ~/.config/opencode/oh-my-opencode.json[c]
{ "$schema" : "https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/oh-my-opencode.schema.json" , "agents" : { "oracle" : { "model" : "openai/gpt-5.4" , "variant" : "high" }, "explore" : { "model" : "github-copilot/grok-code-fast-1" } }, "categories" : { "quick" : { "model" : "opencode/gpt-5-nano" }, "visual-engineering" : { "model" : "google/gemini-3.1-pro" } } } If your installed package exposes a renamed schema, use the path reported by doctor.
Option Meaning modelExplicit provider/model override. variantVariant such as max, high, medium, low, or xhigh. fallback_modelsOrdered chain used when a model or provider fails. prompt, prompt_appendReplace or extend an agent prompt; file:// URIs supported. toolsRestrict the tools available to an agent. disableDisable a specific agent. permissionControl permissions such as edit, bash, and webfetch.
Category Purpose visual-engineeringFrontend, UI/UX, design, styling, animation. ultrabrainHard logic, architecture, deep reasoning. deepAutonomous research plus end-to-end implementation. artistryCreative or unconventional work. quickTrivial single-file changes, typo fixes, simple modifications. unspecified-low, unspecified-highGeneric low/high-effort fallback categories. writingDocumentation and prose.
Flag Meaning --claude=no|yes|max20Claude provider mode. --openai=no|yesOpenAI/ChatGPT provider mode. --gemini=no|yesGemini provider mode. --copilot=no|yesGitHub Copilot fallback provider. --opencode-go=no|yesOpenCode Go subscription path. --opencode-zen=no|yesopencode/ model catalog path.--zai-coding-plan=no|yesZ.ai Coding Plan path. --kimi-for-coding=no|yesKimi for Coding path. --vercel-ai-gateway=no|yesVercel AI Gateway path. --skip-authSkip post-install auth guidance.
Variable Meaning OMO_SEND_ANONYMOUS_TELEMETRY=0Disable anonymous active-install telemetry. OMO_DISABLE_POSTHOG=1Disable PostHog telemetry. OPENCODE_CONFIG_DIROverride OpenCode config directory.
