Installation

Step 1: Install OpenCode

Oh My OpenCode is a plugin for OpenCode, so you need to install OpenCode first:

curl -fsSL https://opencode.ai/install | bash

Or visit opencode.ai for alternative installation methods (npm, bun, brew, etc.).

Step 2: Install Oh My OpenCode

Once OpenCode is installed, add the Oh My OpenCode plugin:

Recommended: Using bunx

bunx oh-my-opencode install

This is the recommended method as mentioned in the OpenCode ecosystem documentation.

Alternative: Using npm

npm install -g oh-my-opencode

Alternative: Using bun

bun install -g oh-my-opencode

Alternative: Using yarn

yarn global add oh-my-opencode

Alternative: Using pnpm

pnpm add -g oh-my-opencode

Step 3: Launch OpenCode

Once both OpenCode and Oh My OpenCode are installed, launch OpenCode in your project directory:

cd your-project
opencode

Oh My OpenCode will automatically be available as part of your OpenCode session. The agents will start indexing your project structure and understanding your build pipeline.

Verification

To verify that everything is set up correctly:

• Check OpenCode version: opencode --version
• Launch OpenCode and verify Oh My OpenCode agents are available
• Configuration files will be created automatically when needed

Configuration

Oh My OpenCode works with OpenCode's configuration system. Configuration files are located at:

• .opencode/oh-my-opencode.json - Project-specific configuration (takes precedence)
• ~/.config/opencode/oh-my-opencode.json - User-wide configuration

Configuration is created automatically when you first use Oh My OpenCode features. You can customize agents, hooks, MCPs, and LSP servers through these JSON files.

Learn About Configuration →

Quick Start

After installation and initialization, you're ready to use Oh My OpenCode! Here's what's enabled by default:

Next Steps

Now that you have Oh My OpenCode installed:

1. Review the configuration guide to customize your setup
2. Explore available agents and configure them to your needs
3. Check out the hooks system for workflow automation
4. Read the full documentation for advanced features

Troubleshooting

Installation Issues

If you encounter issues during installation:

• Make sure you have the latest version of Node.js
• Try using a different package manager
• Check that you have write permissions for global installations
• Clear npm/bun cache: npm cache clean --force or bun pm cache rm

Configuration Issues

If configuration isn't working:

• Ensure you're using OpenCode 1.0.133 or newer
• Check that the configuration file is valid JSON
• Verify file permissions on the configuration directory
• Check the configuration documentation for syntax

Getting Help

If you're still having issues:

• Check the GitHub Issues
• Search existing issues for similar problems
• Open a new issue with details about your problem

Updating

To update Oh My OpenCode to the latest version:

Using npm

npm update -g oh-my-opencode

Using bun

bun update -g oh-my-opencode

The auto-update-checker hook (enabled by default) will notify you when updates are available.

Uninstallation

To uninstall Oh My OpenCode:

Using npm

npm uninstall -g oh-my-opencode

Using bun

bun remove -g oh-my-opencode

Note: This will not remove your configuration files. To completely remove Oh My OpenCode, also delete:

• ~/.config/opencode/oh-my-opencode.json
• .opencode/oh-my-opencode.json (in your projects)

Related Pages

Get more traffic and context from these pages:

• OpenCode Tutorial — Step-by-step from zero to first session
• Configuration — Where config lives and how to customize
• FAQ — Common installation and config questions
• Oh My OpenCode vs OpenCode — What the plugin adds
• Use Cases — When Oh My OpenCode shines
• OpenCode CLI Commands — Common commands reference
• OpenCode Alternatives — Compare with Cursor and other tools