Przeglądaj źródła

docs(opencode): remove and merge identical v1/v2 install and update guidance

GoldJohnKing 2 tygodni temu
rodzic
commit
aeba3ee2fd
2 zmienionych plików z 6 dodań i 148 usunięć
  1. 4 79
      .opencode/INSTALL.md
  2. 2 69
      docs/README.opencode.md

+ 4 - 79
.opencode/INSTALL.md

@@ -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

+ 2 - 69
docs/README.opencode.md

@@ -4,11 +4,6 @@ Complete guide for using Superpowers with [OpenCode.ai](https://opencode.ai).
 
 
 ## Installation
 ## Installation
 
 
-Installation differs between OpenCode V1 (`opencode`) and V2 (`opencode2`).
-Install Superpowers separately for each version if you use both.
-
-### OpenCode V1 (`opencode`)
-
 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):
 
 
 ```json
 ```json
@@ -17,66 +12,11 @@ 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 V2 (`opencode2`)
-
-V2 does not support `git+https://` plugin installation. Use a local clone with
-a path reference instead.
-
-1. Clone the repository:
-
-```bash
-git clone https://github.com/obra/superpowers.git ~/superpowers
-```
-
-2. Add the plugin using 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 and verify:
-
-```bash
-opencode2 service restart
-```
-
-Ask: "Tell me about your superpowers"
-
-### 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 (V1)
 ### Migrating from the old symlink-based install (V1)
 
 
 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:
@@ -154,13 +94,6 @@ To pin a specific version, use a branch or tag:
 }
 }
 ```
 ```
 
 
-### V2 (`opencode2`)
-
-```bash
-cd ~/superpowers && git pull
-opencode2 service restart
-```
-
 ## How It Works
 ## How It Works
 
 
 The plugin does two things:
 The plugin does two things: