diff options
Diffstat (limited to '.opencode')
| -rw-r--r-- | .opencode/INSTALL.md | 31 |
1 files changed, 29 insertions, 2 deletions
diff --git a/.opencode/INSTALL.md b/.opencode/INSTALL.md index 2dc2b23..94c3415 100644 --- a/.opencode/INSTALL.md +++ b/.opencode/INSTALL.md @@ -14,10 +14,14 @@ Add superpowers to the `plugin` array in your `opencode.json` (global or project } ``` -Restart OpenCode. That's it — the plugin auto-installs and registers all skills. +Restart OpenCode. The plugin installs through OpenCode's plugin manager and +registers all skills. Verify by asking: "Tell me about your superpowers" +OpenCode uses its own plugin install. If you also use Claude Code, Codex, or +another harness, install Superpowers separately for each one. + ## Migrating from the old symlink-based install If you previously installed superpowers using `git clone` and symlinks, remove the old setup: @@ -46,7 +50,10 @@ use skill tool to load superpowers/brainstorming ## Updating -Superpowers updates automatically when you restart OpenCode. +OpenCode installs Superpowers through a git-backed package spec. Some OpenCode +and Bun versions pin that resolved git dependency in a lockfile or cache, so a +restart may not pick up the newest Superpowers commit. If updates do not appear, +clear OpenCode's package cache or reinstall the plugin. To pin a specific version: @@ -64,6 +71,26 @@ To pin a specific version: 2. Verify the plugin line in your `opencode.json` 3. Make sure you're running a recent version of OpenCode +### Windows install issues + +Some Windows OpenCode builds have upstream installer issues with git-backed +plugin specs, including cache paths for `git+https` URLs and Bun not finding +`git.exe` even when it works in a normal terminal. If OpenCode cannot install +the plugin, try installing with system npm and pointing OpenCode at the local +package: + +```powershell +npm install superpowers@git+https://github.com/obra/superpowers.git --prefix "$HOME\.config\opencode" +``` + +Then use the installed package path in `opencode.json`: + +```json +{ + "plugin": ["~/.config/opencode/node_modules/superpowers"] +} +``` + ### Skills not found 1. Use `skill` tool to list what's discovered |
