@mcowger/opencode-plexus 1.2.5 → 1.3.0

package/README.md

@@ -8,6 +8,7 @@ Exposes models from a self-hosted [Plexus](https://github.com/mcowger/plexus) AI
 |---|---|---|
 | `plexus-pi` | [pi](https://github.com/earendil-works/pi) | `@mcowger/pi-plexus` |
 | `plexus-opencode` | [OpenCode](https://opencode.ai) | `@mcowger/opencode-plexus` |
+| `plexus-oh-my-pi` | [Oh My Pi](https://github.com/can1357/oh-my-pi) | `@mcowger/oh-my-pi-plexus` |
 
 ## Prerequisites
 
@@ -84,6 +85,41 @@ Then reference the built artifact in `opencode.json`:
 
 ---
 
+### Oh My Pi
+
+Oh My Pi is a fork of pi and is **not** wire-compatible with `plexus-pi` in every respect (different runtime packages, extension manifest field, and built-in model registry — see [AGENTS.md](AGENTS.md)), so it has its own adapter package.
+
+#### Option 1 — npm (recommended)
+
+```sh
+cd ~/.omp/agent/extensions
+npm install @mcowger/oh-my-pi-plexus
+```
+
+#### Option 2 — git clone into the extensions directory
+
+```sh
+git clone https://github.com/mcowger/plexus-agent-plugins ~/.omp/agent/extensions/plexus-agent-plugins
+```
+
+#### Option 3 — git clone anywhere + settings.json
+
+```sh
+git clone https://github.com/mcowger/plexus-agent-plugins ~/code/plexus-agent-plugins
+```
+
+Then register the path in `~/.omp/agent/settings.json`:
+
+```json
+{
+  "extensions": [
+    "~/code/plexus-agent-plugins/packages/plexus-oh-my-pi"
+  ]
+}
+```
+
+---
+
 ## First-time setup
 
 ### pi
@@ -105,7 +141,7 @@ To force a model refresh:
 /plexus refresh
 ```
 
-Set the model Pi should use by default. With no model ID, Pi opens a selector; you can also pass the exact Plexus model ID directly:
+Select a Plexus model explicitly for the current session. With no model ID, Pi opens a selector; you can also pass the exact Plexus model ID directly. This explicit choice is not applied automatically when starting a new session:
 
 ```
 /plexus set-default-model
@@ -114,6 +150,16 @@ Set the model Pi should use by default. With no model ID, Pi opens a selector; y
 
 Use `/login plexus` for setup and `/logout plexus` to remove stored credentials.
 
+### Oh My Pi
+
+Run inside Oh My Pi using the native login flow:
+
+```
+/login plexus
+```
+
+Same prompts and `/plexus refresh` / `/plexus set-default-model` commands as pi (see above) — `plexus-oh-my-pi` mirrors the pi adapter's behavior, adjusted for Oh My Pi's own runtime packages and built-in model registry.
+
 ### OpenCode
 
 Run inside OpenCode:
@@ -163,7 +209,7 @@ export PLEXUS_API_KEY=your-api-key
 
 ```
 ~/.pi/agent/extensions/plexus/
-  config.json                  # base URL and optional default model (set via /plexus set-default-model)
+  config.json                  # base URL and model preference metadata
   plexus-models-cache.json     # last-fetched model list (startup cache)
   plexus-models-response.json  # raw API response (diagnostics)
   plexus.log                   # extension activity log
@@ -171,6 +217,18 @@ export PLEXUS_API_KEY=your-api-key
 
 The API key is stored through pi's own auth storage. `PLEXUS_API_URL` or `PLEXUS_BASE_URL` can be used as an environment override.
 
+### Oh My Pi
+
+```
+~/.omp/agent/extensions/plexus/
+  config.json                  # base URL and model preference metadata
+  plexus-models-cache.json     # last-fetched model list (startup cache)
+  plexus-models-response.json  # raw API response (diagnostics)
+  plexus.log                   # extension activity log
+```
+
+Same layout as pi, rooted under `~/.omp/agent` instead of `~/.pi/agent` since Oh My Pi resolves its own agent directory.
+
 ### OpenCode
 
 ```
@@ -202,6 +260,14 @@ packages/
       cache.ts          # model cache I/O
       log.ts            # append-only log
     package.json        # declares pi.extensions entry point
+  plexus-oh-my-pi/      # Oh My Pi host adapter (fork of pi; own runtime packages + catalog)
+    src/
+      extension.ts      # entry point: commands, session refresh, auth flow
+      mapper.ts         # PlexusModelDescriptor → Oh My Pi ProviderModelConfig
+      config.ts         # base URL / default model config I/O
+      cache.ts          # model cache I/O
+      log.ts            # append-only log
+    package.json        # declares omp.extensions entry point
   plexus-opencode/      # OpenCode plugin adapter
     src/
       plugin.ts         # Plugin export: config hook, provider hook, auth handler
@@ -237,7 +303,7 @@ Models with a falsy `id` are skipped. Missing metadata falls back to safe defaul
 
 ## Adapter behavior
 
-- **pi** refreshes on session start and through `/plexus refresh`. It accepts either root URLs or URLs ending in `/v1` and normalizes them before calling Plexus.
+- **pi** refreshes on session start and through `/plexus refresh`, without changing the model selected for the session. It accepts either root URLs or URLs ending in `/v1` and normalizes them before calling Plexus.
 - **OpenCode** seeds the provider from the on-disk cache (or a placeholder model) once, during config loading — OpenCode's `provider.models` hook never fires for custom providers, so there is no live discovery at startup. Run `/plexus-refresh` to force a live fetch and rewrite the cache; because OpenCode has no way to hot-reload a custom provider's model list mid-session, a restart is required afterward to see the refreshed models in the picker.
 - OpenCode models retain their upstream model ID, SDK dialect, release date, and reasoning metadata so OpenCode can generate its native GPT, Claude, Gemini, and OpenAI-compatible variants and apply its current request transforms. DeepSeek models also preserve `reasoning_content` across tool-call turns.
 - OpenCode uses a 250K-token context window when Plexus supplies no context metadata; its output fallback remains 20% of that window.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mcowger/opencode-plexus",
-	"version": "1.2.5",
+	"version": "1.3.0",
 	"description": "OpenCode plugin: Plexus provider with dynamic model discovery",
 	"type": "module",
 	"module": "./dist/index.js",