Home / FAQ

Frequently Asked Questions

Answers to common questions about Oh My OpenCode, OpenCode plugins, and AI coding workflows

General

Does Oh My OpenCode replace OpenCode?

No. Oh My OpenCode is a plugin that runs on top of OpenCode. You install OpenCode first, then add this plugin to orchestrate agents, hooks, MCPs, and LSP more intelligently. If you uninstall the plugin, your core OpenCode setup continues to work as before.

What is OpenCode?

OpenCode is the open source AI coding agent with 60K+ GitHub stars and 650,000+ developers using it monthly. It supports 75+ model providers (Claude, GPT, Gemini, etc.) and runs locally or in the cloud. Oh My OpenCode adds an orchestration layer on top of it—see our plugin comparison and OpenCode vs Cursor guides for details.

Will it work with my existing OpenCode configuration?

Yes. Oh My OpenCode respects existing opencode.json settings and extends them through its own oh-my-opencode.json files. You can adopt it incrementally: start with defaults, then add project-specific configuration as your needs grow.

Is it only for TypeScript or JavaScript projects?

No. The orchestration layer is language-agnostic. Through LSP and MCPs you can use it with TypeScript, Python, Rust, Go, and any other language supported by your configured language servers. The focus is on build pipelines and repo structure, not one language.

How is this different from IDE-integrated AI features?

Most IDE features focus on inline completions. Oh My OpenCode focuses on project-level workflows: multi-file refactors, build pipeline changes, documentation updates, and cross-repo edits coordinated by specialized agents and hooks.

Can I turn features off if they don't match my workflow?

Yes. Every major capability—agents, hooks, MCPs, LSP servers, and experimental options—can be enabled or disabled via JSON configuration. You keep the core orchestration benefits while trimming what doesn't fit your team or environment.

Installation & Setup

What do I need to install first?

Install OpenCode first (e.g. curl -fsSL https://opencode.ai/install | bash), then install the Oh My OpenCode plugin via bunx oh-my-opencode install or npm install -g oh-my-opencode. Full steps are in our installation guide.

Which OpenCode version do I need?

Use OpenCode 1.0.133 or newer. If you're on 1.0.132 or older, a known OpenCode bug may break config. The fix was merged after 1.0.132—upgrade for the best experience.

Where are configuration files stored?

Project-specific: .opencode/oh-my-opencode.json. User-wide: ~/.config/opencode/oh-my-opencode.json. Project config takes precedence. See configuration for details.

Agents & Features

What is the default agent?

Planner-Sisyphus is the default agent. It provides intelligent planning and task completion. You can switch to or add other agents (Librarian, Explore, Oracle) in agents and configuration.

What are MCPs and why use them?

MCPs (Model Context Protocol) give the agent access to external tools—e.g. up-to-date docs (Context7) and code search (grep.app). Oh My OpenCode wires these in by default. Learn more in MCPs.

What are hooks?

Hooks automate and guard-rail your workflow: context window management, session recovery, task continuation, and more. There are 20+ built-in hooks—see hooks for the full list.

Troubleshooting

Configuration isn't loading. What should I check?

Ensure OpenCode is 1.0.133+, that your JSON is valid, and that you have write access to the config directory. See installation troubleshooting and configuration.

Where can I get help or report a bug?

Open an issue on GitHub Issues. Check existing issues first. For contributing, see contributing.

Related Pages

These pages help you get more traffic and context: