This guide provides a quick summary of how to install the core components. For detailed documentation, please visit the official repositories linked below.
Official Source: opencode.ai | npm package
Open your terminal (PowerShell/CMD/Bash) and run:
npm install -g opencode-aiRun this command to check if it's installed:
opencode --versionOfficial Source: GitHub - code-yeongyu/oh-my-opencode
- Open a fresh OpenCode session (close & reopen if needed).
- Copy and Paste the following prompt into the chat bar, then press Enter:
Install and configure by following the instructions here [https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/README.md](https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/README.md)! Important: Do not edit
opencode.jsonmanually yet. Use the file provided in this Starter Kit (Step 4 below) to avoid crashes.
Official Source: GitHub - obra/superpowers
Once you can open OpenCode, run this command inside the OpenCode terminal:
Fetch and follow instructions from [https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md](https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md)
Troubleshooting: If you see an error like
Module not found: lib/skills-core.js, please refer to our fix guide: guides/FIX_CRASH_AND_BUGS.md.
This is where this repository shines. Instead of configuring everything manually and risking a crash, copy our safe configurations.
-
Locate your config folder:
- Windows:
C:\Users\YOUR_USERNAME\.config\opencode\ - Mac/Linux:
~/.config/opencode/
- Windows:
-
Back up your existing files (if any).
-
Copy files from this repository:
- Copy
configs/opencode.json→ Paste into config folder (Fixes startup crash). - Copy
configs/oh-my-opencode.json→ Paste into config folder (Sets up Agents).
- Copy
-
Restart OpenCode.