@christiandoxa/prodex 0.223.0 → 0.224.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +35 -8
  2. package/package.json +7 -7
package/README.md CHANGED
@@ -144,7 +144,7 @@ If you install from source, make sure the `codex` binary in your `PATH` is alrea
144
144
 
145
145
  ## Optional tools
146
146
 
147
- `prodex` can run without RTK, SQZ, token-savior, claw-compactor, Presidio, or prodex-memory. `prodex-inspect` is a built-in read-only MCP server for profile/runtime diagnostics and is auto-registered in Prodex overlay sessions. `prodex-memory` is built in and opt-in through the `mem` prefix or managed Mem0 Super prompt.
147
+ `prodex` can run without RTK, SQZ, token-savior, claw-compactor, Ponytail, Presidio, or prodex-memory. `prodex-inspect` is a built-in read-only MCP server for profile/runtime diagnostics and is auto-registered in Prodex overlay sessions. `prodex-memory` is built in and opt-in through the `mem` prefix or managed Mem0 Super prompt.
148
148
 
149
149
  Install them only if you want to use commands such as:
150
150
 
@@ -156,6 +156,7 @@ prodex rtk
156
156
  prodex sqz
157
157
  prodex tokensavior
158
158
  prodex clawcompactor
159
+ prodex ponytail
159
160
  prodex mem
160
161
  prodex s doctor
161
162
  prodex presidio doctor
@@ -167,6 +168,30 @@ prodex super
167
168
 
168
169
  </details>
169
170
 
171
+ <details>
172
+ <summary>Install Ponytail</summary>
173
+
174
+ Ponytail is used by `prodex ponytail` and by Super mode when a Ponytail checkout is available under a managed optimizer root. Prodex installs the checkout into the temporary Codex overlay marketplace/cache for that session, enables `ponytail@ponytail`, and leaves the base Codex profile unchanged.
175
+
176
+ Recommended source checkout:
177
+
178
+ ```bash
179
+ git clone https://github.com/DietrichGebert/ponytail.git ~/.local/share/prodex-optimizers/ponytail
180
+ ```
181
+
182
+ Then launch:
183
+
184
+ ```bash
185
+ prodex ponytail
186
+ prodex caveman ponytail
187
+ prodex rtk caveman ponytail
188
+ prodex s
189
+ ```
190
+
191
+ Ponytail's Codex plugin uses Node.js lifecycle hooks. If `node` is not on the non-interactive shell `PATH`, Ponytail skills remain installed but the always-on hook activation may stay quiet.
192
+
193
+ </details>
194
+
170
195
  <details>
171
196
  <summary>Prodex inspect MCP</summary>
172
197
 
@@ -708,7 +733,7 @@ prodex s expose
708
733
  `prodex super` expands to:
709
734
 
710
735
  ```bash
711
- prodex caveman rtk sqz tokensavior clawcompactor --full-access
736
+ prodex caveman rtk sqz tokensavior clawcompactor ponytail --full-access
712
737
  ```
713
738
 
714
739
  <details>
@@ -717,7 +742,7 @@ prodex caveman rtk sqz tokensavior clawcompactor --full-access
717
742
  Before launch, Super asks whether to add Presidio redaction. Empty input or `n` keeps the expansion above. If you answer `y`, it is equivalent to:
718
743
 
719
744
  ```bash
720
- prodex caveman rtk sqz tokensavior clawcompactor presidio --full-access
745
+ prodex caveman rtk sqz tokensavior clawcompactor ponytail presidio --full-access
721
746
  ```
722
747
 
723
748
  Use `prodex super --presidio` to enable Presidio without prompting, or `prodex super --no-presidio` to skip the prompt and keep Presidio disabled. Presidio enables runtime request-body and WebSocket text redaction through local Presidio for the session when services are healthy; service failures follow `fail_mode`. The runtime uses `presidio.toml` endpoints when configured, falls back to `http://localhost:5002` and `http://localhost:5001`, and honors `fail_mode = "open"` or `"closed"`.
@@ -756,10 +781,11 @@ Super instructs Codex to use the available local optimizer stack where it fits t
756
781
  - token-savior handles symbol lookup, caller/context navigation, duplicate/dead-code checks, and API-impact searches before broad source reads when token-savior is available.
757
782
  - prodex-inspect provides read-only MCP diagnostics for Prodex status, profiles, and latest runtime log tail.
758
783
  - claw-compactor handles workspace-level summary or benchmark requests through `prodex-claw-compactor` / `prodex-claw-compactor-auto` when available; treat its output as overview context and reread exact source before edits.
784
+ - Ponytail loads the local `DietrichGebert/ponytail` Codex plugin into the temporary overlay when the checkout exists under a managed optimizer root, adding smallest-correct-implementation pressure without changing the base Codex profile.
759
785
  - prodex-memory provides local Mem0-style memory through the `mem` prefix with SQLite, or through managed Mem0 OSS Docker when you opt in with the Super prompt or `--mem0`; neither path uses Mem0 Cloud auth or `MEM0_API_KEY`.
760
786
  - Presidio stays optional and only runs when you opt in with the Super prompt or `--presidio`.
761
787
 
762
- Managed optimizer checkouts are discovered from `PRODEX_OPTIMIZERS_HOME`, `$XDG_DATA_HOME/prodex-optimizers`, then `~/.local/share/prodex-optimizers`.
788
+ Managed optimizer checkouts are discovered from `PRODEX_OPTIMIZERS_HOME`, `$XDG_DATA_HOME/prodex-optimizers`, then `~/.local/share/prodex-optimizers`. Put Ponytail at `~/.local/share/prodex-optimizers/ponytail` with `git clone https://github.com/DietrichGebert/ponytail.git ~/.local/share/prodex-optimizers/ponytail`.
763
789
  The generated `SUPER_OPTIMIZERS.md` overlay includes an `Available Now` section so the model can see which MCP servers and wrappers were actually discovered for that session.
764
790
 
765
791
  </details>
@@ -828,7 +854,7 @@ prodex dashboard
828
854
 
829
855
  The live `prodex quota --all --detail` view accepts `s` to cycle sort modes and `f` to cycle the provider filter through `all`, `openai`, `gemini`, `anthropic`, `copilot`, `deepseek`, and `local`. Add `--provider openai`, `--provider gemini`, `--provider anthropic`, `--provider copilot`, `--provider deepseek`, or `--provider local` to start locked to a single provider.
830
856
 
831
- For OpenAI/Codex profiles, quota views also show earned rate-limit reset credits when the upstream usage API reports them. Use `prodex redeem <profile>` when you explicitly want to redeem one reset credit on a named profile, even if the 5h and weekly quota windows still have remaining quota. If either quota window resets within 1 hour, Prodex asks before consuming the credit; pass `--yes` to skip that prompt. Add `--auto-redeem` to a runtime launch when you want Prodex to consider a guarded automatic redeem after every OpenAI/Codex profile is weekly-exhausted.
857
+ For OpenAI/Codex profiles, quota views also show earned rate-limit reset credits when the upstream usage API reports them, including credit expiry when the backend includes it. Use `prodex redeem <profile>` when you explicitly want to redeem one reset credit on a named profile, even if the 5h and weekly quota windows still have remaining quota. If either quota window resets within 1 hour, Prodex asks before consuming the credit; pass `--yes` to skip that prompt. Add `--auto-redeem` to a runtime launch when you want Prodex to consider a guarded automatic redeem after every OpenAI/Codex profile is weekly-exhausted.
832
858
 
833
859
  `prodex dashboard` serves a local browser dashboard at `http://127.0.0.1:8765` by default. It shows profile/account settings, lets you switch or remove profile entries, and renders live usage from the same quota collectors used by `prodex quota`. Use `prodex dashboard --port 0` for an OS-selected free port, or pass `--base-url` for quota checks against a custom Codex-compatible backend. The dashboard has no password auth; keep it on localhost unless the network is trusted.
834
860
 
@@ -950,6 +976,7 @@ prodex rtk
950
976
  prodex sqz
951
977
  prodex tokensavior
952
978
  prodex clawcompactor
979
+ prodex ponytail
953
980
  prodex mem
954
981
  prodex caveman --dry-run
955
982
  prodex s doctor
@@ -961,7 +988,7 @@ prodex caveman 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9
961
988
 
962
989
  `prodex caveman` runs Codex with Caveman mode active in a temporary Prodex overlay `CODEX_HOME`, so the base profile home stays unchanged after the session ends.
963
990
 
964
- Add optimizer prefixes before Codex args when you want Prodex to enable a specific session tool in the Prodex overlay: `rtk`, `sqz`, `tokensavior`, `clawcompactor`, `mem`, or `presidio`. Top-level shortcuts such as `prodex rtk`, `prodex sqz`, and `prodex mem` map to `prodex caveman <prefix>`.
991
+ Add optimizer prefixes before Codex args when you want Prodex to enable a specific session tool in the Prodex overlay: `rtk`, `sqz`, `tokensavior`, `clawcompactor`, `ponytail`, `mem`, or `presidio`. Top-level shortcuts such as `prodex rtk`, `prodex sqz`, `prodex ponytail`, and `prodex mem` map to `prodex caveman <prefix>`.
965
992
 
966
993
  RTK is still an external binary. Install it separately if `rtk gain` is unavailable.
967
994
 
@@ -1073,11 +1100,11 @@ Note that the default Microsoft Presidio Docker images typically only support En
1073
1100
 
1074
1101
  It keeps exact pass-through for continuation-sensitive requests. When safe, it uses adaptive token budgeting, artifact-backed large tool outputs, duplicate suppression, blob/noise detection, stable cache-friendly context framing, and critical-signal self-checks to reduce token load without dropping failure details.
1075
1102
 
1076
- The Super optimization stack is meant to stay deterministic and local by default. It auto-registers `sqz-mcp` and `token-savior` MCP servers when those binaries are already on `PATH` or in a managed `prodex-optimizers` checkout, exposes `sqz` and `claw-compactor` wrappers when discoverable, routes compatible optimizer cache/state under `PRODEX_HOME` instead of the workspace, and uses a dedicated runtime proxy for local compaction, stable references, and lower-token context shaping rather than hidden remote summarization.
1103
+ The Super optimization stack is meant to stay deterministic and local by default. It auto-registers `sqz-mcp` and `token-savior` MCP servers when those binaries are already on `PATH` or in a managed `prodex-optimizers` checkout, loads Ponytail from a managed checkout when available, exposes `sqz` and `claw-compactor` wrappers when discoverable, routes compatible optimizer cache/state under `PRODEX_HOME` instead of the workspace, and uses a dedicated runtime proxy for local compaction, stable references, and lower-token context shaping rather than hidden remote summarization.
1077
1104
 
1078
1105
  RTK handles upstream/input command output before it enters the context window, using visible `rtk <cmd>` commands and overlay auto-wrappers when available. Auto-wrappers are only a backstop; write `rtk <cmd>` explicitly when you want the TUI/transcript to show RTK usage. SQZ handles downstream/context reuse after content is already in the session, using `prodex-sqz` when the MCP server is available.
1079
1106
 
1080
- Managed optimizer checkouts are discovered from `PRODEX_OPTIMIZERS_HOME`, `$XDG_DATA_HOME/prodex-optimizers`, then `~/.local/share/prodex-optimizers`.
1107
+ Managed optimizer checkouts are discovered from `PRODEX_OPTIMIZERS_HOME`, `$XDG_DATA_HOME/prodex-optimizers`, then `~/.local/share/prodex-optimizers`; Ponytail is expected at `ponytail/` inside one of those roots.
1081
1108
 
1082
1109
  </details>
1083
1110
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@christiandoxa/prodex",
3
- "version": "0.223.0",
3
+ "version": "0.224.0",
4
4
  "description": "Multi-provider Codex wrapper with OpenAI quota-aware routing and Claude Code support",
5
5
  "license": "Apache-2.0",
6
6
  "bin": {
@@ -16,12 +16,12 @@
16
16
  "@openai/codex": "latest"
17
17
  },
18
18
  "optionalDependencies": {
19
- "@christiandoxa/prodex-linux-x64": "0.223.0",
20
- "@christiandoxa/prodex-linux-arm64": "0.223.0",
21
- "@christiandoxa/prodex-darwin-x64": "0.223.0",
22
- "@christiandoxa/prodex-darwin-arm64": "0.223.0",
23
- "@christiandoxa/prodex-win32-x64": "0.223.0",
24
- "@christiandoxa/prodex-win32-arm64": "0.223.0",
19
+ "@christiandoxa/prodex-linux-x64": "0.224.0",
20
+ "@christiandoxa/prodex-linux-arm64": "0.224.0",
21
+ "@christiandoxa/prodex-darwin-x64": "0.224.0",
22
+ "@christiandoxa/prodex-darwin-arm64": "0.224.0",
23
+ "@christiandoxa/prodex-win32-x64": "0.224.0",
24
+ "@christiandoxa/prodex-win32-arm64": "0.224.0",
25
25
  "@openai/codex-linux-x64": "npm:@openai/codex@linux-x64",
26
26
  "@openai/codex-linux-arm64": "npm:@openai/codex@linux-arm64",
27
27
  "@openai/codex-darwin-x64": "npm:@openai/codex@darwin-x64",