From cfd01e5e15811a753d3b71a0f4c1c30a6054e1fa Mon Sep 17 00:00:00 2001
From: lukemaj <lukicryptolord@gmail.com>
Date: Wed, 30 Sep 2026 00:57:55 +0200
Subject: [PATCH] docs: find the plugin root per host and check promotion in
 README (#153)

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 .claude-plugin/plugin.json |  2 +-
 .codex-plugin/plugin.json  |  2 +-
 .grok-plugin/plugin.json   |  2 +-
 CHANGELOG.md               |  6 ++++++
 README.md                  | 39 +++++++++++++++++++++++++++++++++++---
 VERSION                    |  2 +-
 6 files changed, 46 insertions(+), 7 deletions(-)

diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index abd6523..e765076 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "model-router",
-  "version": "0.44.0",
+  "version": "0.44.1",
   "description": "Route authorized software work through one durable, capacity-aware subscription policy.",
   "author": {
     "name": "toolboxmd",
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index 7728dc7..028396e 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "model-router",
-  "version": "0.44.0",
+  "version": "0.44.1",
   "description": "Route authorized software work through one durable, capacity-aware subscription policy.",
   "author": {
     "name": "toolboxmd",
diff --git a/.grok-plugin/plugin.json b/.grok-plugin/plugin.json
index abd6523..e765076 100644
--- a/.grok-plugin/plugin.json
+++ b/.grok-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "model-router",
-  "version": "0.44.0",
+  "version": "0.44.1",
   "description": "Route authorized software work through one durable, capacity-aware subscription policy.",
   "author": {
     "name": "toolboxmd",
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4a4f1be..527fd83 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.44.1] - 2026-09-30
+
+### Changed
+
+- README: find the installed plugin root per host, list requirements, compare released and promoted versions (#153)
+
 ## [0.44.0] - 2026-09-29
 
 ### Added
diff --git a/README.md b/README.md
index 83f8178..7490bd7 100644
--- a/README.md
+++ b/README.md
@@ -16,8 +16,24 @@ guidance lives in Chromeria's Prism tool descriptions (`prism_submit`,
 `prism_status`, `prism_questions`, `prism_answer`), which call the newest
 installed release.
 
+You need Python 3.11 or newer, Git, and a reachable T3 server (the Chromeria
+fork) whose providers can run the routes, with a bearer token;
+[RUNNER.md](RUNNER.md#requirements) gives the server URL and token lookup
+order.
+
 Once Toolybara promotes a release into ToolboxMD Marketplace, install it through
-your host's native plugin path:
+your host's native plugin path. To compare the latest source release with the
+promoted Marketplace release:
+
+```sh
+gh release view -R toolboxmd/model-router --json tagName --jq .tagName
+gh api repos/toolboxmd/marketplace/contents/catalog.json \
+  -H 'Accept: application/vnd.github.raw' \
+  --jq '.plugins[] | select(.name=="model-router") | .release'
+```
+
+When the source release tag is newer than the Marketplace tag, that release
+is not promoted yet. Install commands:
 
 ```sh
 # Codex
@@ -36,7 +52,24 @@ grok plugin install model-router --trust
 
 Marketplace records the exact source tag, commit, and Project Record digest.
 Provider publication and fresh-host acceptance remain separate proof.
-Resolve `MODEL_ROUTER_ROOT` to the installed plugin's real root, then verify:
+Set `MODEL_ROUTER_ROOT` to the installed plugin's root, found per host with
+`jq`:
+
+```sh
+# Codex: the cache folder is named after the installed version
+MODEL_ROUTER_ROOT="$HOME/.codex/plugins/cache/toolboxmd/model-router/$(codex plugin list --json |
+  jq -r '.installed[] | select(.pluginId=="model-router@toolboxmd") | .version')"
+
+# Claude Code
+MODEL_ROUTER_ROOT="$(claude plugin list --json |
+  jq -r '.[] | select(.id=="model-router@toolboxmd") | .installPath')"
+
+# Grok Build
+MODEL_ROUTER_ROOT="$(grok plugin list --json |
+  jq -r '.[] | select(.name=="model-router") | .path')"
+```
+
+Then verify:
 
 ```sh
 "$MODEL_ROUTER_ROOT/bin/model-router" --version
@@ -44,7 +77,7 @@ Resolve `MODEL_ROUTER_ROOT` to the installed plugin's real root, then verify:
 ```
 
 Installing the package starts no service or model request and does not grant
-delivery authority. See [RUNNER.md](RUNNER.md) for requirements.
+delivery authority.
 
 ## Automatic releases
 
diff --git a/VERSION b/VERSION
index a8ab6c9..73f8a5a 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-0.44.0
+0.44.1