@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.
- package/README.md +35 -8
- 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.
|
|
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.
|
|
20
|
-
"@christiandoxa/prodex-linux-arm64": "0.
|
|
21
|
-
"@christiandoxa/prodex-darwin-x64": "0.
|
|
22
|
-
"@christiandoxa/prodex-darwin-arm64": "0.
|
|
23
|
-
"@christiandoxa/prodex-win32-x64": "0.
|
|
24
|
-
"@christiandoxa/prodex-win32-arm64": "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",
|