|
@@ -4,7 +4,7 @@
|
|
|
|
|
|
|
|
- [OpenCode.ai](https://opencode.ai) installed
|
|
- [OpenCode.ai](https://opencode.ai) installed
|
|
|
|
|
|
|
|
-## OpenCode V1 (`opencode`) Installation
|
|
|
|
|
|
|
+## Installation
|
|
|
|
|
|
|
|
Add superpowers to the `plugin` array in your `opencode.json` (global or project-level):
|
|
Add superpowers to the `plugin` array in your `opencode.json` (global or project-level):
|
|
|
|
|
|
|
@@ -14,80 +14,14 @@ Add superpowers to the `plugin` array in your `opencode.json` (global or project
|
|
|
}
|
|
}
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
-Restart OpenCode. The plugin installs through OpenCode's plugin manager and
|
|
|
|
|
-registers all skills.
|
|
|
|
|
|
|
+Restart OpenCode (`opencode2 service restart` on V2). The plugin installs
|
|
|
|
|
+through OpenCode's plugin manager and registers all skills.
|
|
|
|
|
|
|
|
Verify by asking: "Tell me about your superpowers"
|
|
Verify by asking: "Tell me about your superpowers"
|
|
|
|
|
|
|
|
OpenCode uses its own plugin install. If you also use Claude Code, Codex, or
|
|
OpenCode uses its own plugin install. If you also use Claude Code, Codex, or
|
|
|
another harness, install Superpowers separately for each one.
|
|
another harness, install Superpowers separately for each one.
|
|
|
|
|
|
|
|
-## OpenCode V2 (`opencode2`) Installation
|
|
|
|
|
-
|
|
|
|
|
-V2 does not support `git+https://` plugin installation. Use a local clone
|
|
|
|
|
-with a path reference instead.
|
|
|
|
|
-
|
|
|
|
|
-### Steps
|
|
|
|
|
-
|
|
|
|
|
-1. Clone the repository:
|
|
|
|
|
-
|
|
|
|
|
-```bash
|
|
|
|
|
-git clone https://github.com/obra/superpowers.git ~/superpowers
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-2. Add the plugin to your `opencode.json` (global or project-level).
|
|
|
|
|
- Use the `plugin` field (singular) with an absolute path:
|
|
|
|
|
-
|
|
|
|
|
-```jsonc
|
|
|
|
|
-{
|
|
|
|
|
- "$schema": "https://opencode.ai/config.json",
|
|
|
|
|
- "plugin": [
|
|
|
|
|
- "/home/your-username/superpowers/.opencode/plugins/superpowers.js"
|
|
|
|
|
- ]
|
|
|
|
|
-}
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-> **Note:** V2 does not expand `~` in local plugin paths. Use an absolute
|
|
|
|
|
-> path or a relative path (`./` or `../`) resolved from the config file
|
|
|
|
|
-> directory.
|
|
|
|
|
-
|
|
|
|
|
-3. Restart OpenCode:
|
|
|
|
|
-
|
|
|
|
|
-```bash
|
|
|
|
|
-opencode2 service restart
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-4. Verify by asking: "Tell me about your superpowers"
|
|
|
|
|
-
|
|
|
|
|
-### Updating
|
|
|
|
|
-
|
|
|
|
|
-```bash
|
|
|
|
|
-cd ~/superpowers && git pull
|
|
|
|
|
-opencode2 service restart
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-## Running V1 and V2 Side by Side
|
|
|
|
|
-
|
|
|
|
|
-V1 (`opencode`) and V2 (`opencode2`) share the same default config directory
|
|
|
|
|
-(`~/.config/opencode/`). Since V2 normalizes V1's `plugin` field into its own
|
|
|
|
|
-loading pipeline, putting a `git+https://` spec (which V2 cannot install) in
|
|
|
|
|
-the shared config causes V2 to silently fail loading it.
|
|
|
|
|
-
|
|
|
|
|
-To use different plugin sources for each version, point V2 at a separate
|
|
|
|
|
-config directory via the `OPENCODE_CONFIG_DIR` environment variable:
|
|
|
|
|
-
|
|
|
|
|
-```bash
|
|
|
|
|
-# In ~/.bashrc (or equivalent shell config)
|
|
|
|
|
-export OPENCODE_CONFIG_DIR="$HOME/.config/opencode2"
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
-Then maintain two config files:
|
|
|
|
|
-
|
|
|
|
|
-- `~/.config/opencode/opencode.json` — V1 config, using `git+https://` sources
|
|
|
|
|
-- `~/.config/opencode2/opencode.json` — V2 config, using local path sources
|
|
|
|
|
-
|
|
|
|
|
-Both versions can now run independently without interfering with each other.
|
|
|
|
|
-
|
|
|
|
|
## Migrating from the old symlink-based install
|
|
## Migrating from the old symlink-based install
|
|
|
|
|
|
|
|
If you previously installed superpowers using `git clone` and symlinks, remove the old setup:
|
|
If you previously installed superpowers using `git clone` and symlinks, remove the old setup:
|
|
@@ -116,8 +50,6 @@ use skill tool to load brainstorming
|
|
|
|
|
|
|
|
## Updating
|
|
## Updating
|
|
|
|
|
|
|
|
-### V1 (`opencode`)
|
|
|
|
|
-
|
|
|
|
|
OpenCode installs Superpowers through a git-backed package spec. Some 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
|
|
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,
|
|
restart may not pick up the newest Superpowers commit. If updates do not appear,
|
|
@@ -127,17 +59,10 @@ To pin a specific version:
|
|
|
|
|
|
|
|
```json
|
|
```json
|
|
|
{
|
|
{
|
|
|
- "plugin": ["superpowers@git+https://github.com/obra/superpowers.git#v5.0.3"]
|
|
|
|
|
|
|
+ "plugin": ["superpowers@git+https://github.com/obra/superpowers.git#v6.3.0"]
|
|
|
}
|
|
}
|
|
|
```
|
|
```
|
|
|
|
|
|
|
|
-### V2 (`opencode2`)
|
|
|
|
|
-
|
|
|
|
|
-```bash
|
|
|
|
|
-cd ~/superpowers && git pull
|
|
|
|
|
-opencode2 service restart
|
|
|
|
|
-```
|
|
|
|
|
-
|
|
|
|
|
## Troubleshooting
|
|
## Troubleshooting
|
|
|
|
|
|
|
|
### Plugin not loading
|
|
### Plugin not loading
|