@christiandoxa/prodex 0.191.0 → 0.193.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 +12 -64
- package/package.json +7 -7
package/README.md
CHANGED
|
@@ -48,7 +48,6 @@ You need at least one logged-in Prodex profile.
|
|
|
48
48
|
|---|---|
|
|
49
49
|
| Codex CLI | `prodex`, `prodex run`, `prodex caveman`, `prodex super` |
|
|
50
50
|
| Claude Code | `prodex claude` |
|
|
51
|
-
| Claude-Mem | `mem` variants |
|
|
52
51
|
| RTK | `rtk` variants and `prodex s` / `prodex super` |
|
|
53
52
|
|
|
54
53
|
</details>
|
|
@@ -144,7 +143,7 @@ If you install from source, make sure the `codex` binary in your `PATH` is alrea
|
|
|
144
143
|
|
|
145
144
|
## Optional tools
|
|
146
145
|
|
|
147
|
-
`prodex` can run without
|
|
146
|
+
`prodex` can run without RTK, SQZ, token-savior, claw-compactor, or Presidio.
|
|
148
147
|
|
|
149
148
|
Install them only if you want to use commands such as:
|
|
150
149
|
|
|
@@ -152,8 +151,6 @@ Install them only if you want to use commands such as:
|
|
|
152
151
|
<summary>Optional tool commands</summary>
|
|
153
152
|
|
|
154
153
|
```bash
|
|
155
|
-
prodex caveman mem
|
|
156
|
-
prodex caveman mem rtk
|
|
157
154
|
prodex rtk
|
|
158
155
|
prodex sqz
|
|
159
156
|
prodex tokensavior
|
|
@@ -163,38 +160,10 @@ prodex presidio redact --text "My phone is 212-555-1234"
|
|
|
163
160
|
prodex gateway --provider gemini
|
|
164
161
|
prodex s
|
|
165
162
|
prodex super
|
|
166
|
-
prodex claude mem
|
|
167
|
-
prodex claude caveman mem
|
|
168
163
|
```
|
|
169
164
|
|
|
170
165
|
</details>
|
|
171
166
|
|
|
172
|
-
<details>
|
|
173
|
-
<summary>Install Claude-Mem</summary>
|
|
174
|
-
|
|
175
|
-
Claude-Mem is used by the `mem` variants.
|
|
176
|
-
|
|
177
|
-
Recommended install:
|
|
178
|
-
|
|
179
|
-
```bash
|
|
180
|
-
npx claude-mem install
|
|
181
|
-
```
|
|
182
|
-
|
|
183
|
-
Then follow the interactive prompts.
|
|
184
|
-
|
|
185
|
-
You can also install it from inside Claude Code:
|
|
186
|
-
|
|
187
|
-
```text
|
|
188
|
-
/plugin marketplace add thedotmack/claude-mem
|
|
189
|
-
/plugin install claude-mem
|
|
190
|
-
```
|
|
191
|
-
|
|
192
|
-
After installation, restart Claude Code or your coding CLI.
|
|
193
|
-
|
|
194
|
-
> Do not use `npm install -g claude-mem` as the main install method. That installs the SDK/library only; it does not register the plugin hooks or start the worker service.
|
|
195
|
-
|
|
196
|
-
</details>
|
|
197
|
-
|
|
198
167
|
<details>
|
|
199
168
|
<summary>Install RTK</summary>
|
|
200
169
|
|
|
@@ -538,7 +507,6 @@ This is the mode I tune and use myself every day.
|
|
|
538
507
|
It combines:
|
|
539
508
|
|
|
540
509
|
- Caveman mode
|
|
541
|
-
- Claude-Mem transcript watching
|
|
542
510
|
- RTK shell-command guidance
|
|
543
511
|
- full-access launch mode
|
|
544
512
|
- Smart Context Autopilot in the runtime proxy
|
|
@@ -553,13 +521,13 @@ prodex s expose
|
|
|
553
521
|
`prodex super` expands to:
|
|
554
522
|
|
|
555
523
|
```bash
|
|
556
|
-
prodex caveman
|
|
524
|
+
prodex caveman rtk sqz tokensavior clawcompactor --full-access
|
|
557
525
|
```
|
|
558
526
|
|
|
559
527
|
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:
|
|
560
528
|
|
|
561
529
|
```bash
|
|
562
|
-
prodex caveman
|
|
530
|
+
prodex caveman rtk sqz tokensavior clawcompactor presidio --full-access
|
|
563
531
|
```
|
|
564
532
|
|
|
565
533
|
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. 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"`.
|
|
@@ -568,12 +536,15 @@ Full access maps to Codex's sandbox-bypass launch flag. Use it only when you int
|
|
|
568
536
|
|
|
569
537
|
Use `prodex s expose` when you need to reach the live Super terminal from a browser. Prodex starts a local PTY bridge protected by a high-entropy access token, launches `cloudflared tunnel --protocol http2 --url ...` when `cloudflared` is available, and prints both the loopback and Cloudflare quick-tunnel URLs. The browser tab can close without stopping the session; reopening the same token URL reconnects to the existing PTY and replays recent scrollback. Add `--no-tunnel` for local-only access, `--max-clients N` to cap simultaneous browsers, or `--command 'prodex s --no-presidio'` to choose the initial terminal command.
|
|
570
538
|
|
|
571
|
-
Super's built-in optimization stack is deliberately local and deterministic. It preloads
|
|
539
|
+
Super's built-in optimization stack is deliberately local and deterministic. It preloads Caveman, exposes an overlay `rtk` wrapper plus RTK auto-wrappers for common noisy commands when RTK is installed, 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 those commands/checkouts are discoverable, invokes a trusted one-shot `prodex-claw-compactor-sessionstart` SessionStart benchmark probe when Claw-Compactor is available, falls back to a temporary shadow `MEMORY.md` when the workspace has no Markdown memory files, then uses Smart Context Autopilot through a dedicated runtime proxy for lower-token request shaping. The probe delegates to `prodex-claw-compactor-auto "$(pwd)"` and uses a marker under `CODEX_HOME` so Codex conversation restarts do not replay it. Presidio redaction is added to that proxy only when you opt in at the prompt. Prodex passes token-savior cache and stats paths under `PRODEX_HOME` (default `~/.prodex`) so compatible token-savior versions keep generated state out of worktrees.
|
|
572
540
|
|
|
573
|
-
|
|
541
|
+
Super instructs Codex to use the whole local optimizer stack where it fits the task, not just RTK:
|
|
574
542
|
|
|
575
543
|
- RTK works upstream/input-side. Use visible `rtk <cmd>` for noisy terminal commands before their output enters the model context, such as `git diff`, `cargo test`, `npm test`, build logs, and package-manager output. Prodex also auto-wraps common noisy commands as a fallback when RTK is installed, but that fallback does not make the TUI show an `rtk` prefix.
|
|
576
|
-
- SQZ works downstream/context-side through the auto-registered `prodex-sqz` MCP server. Use it for repeated workspace reads, large text blobs, and long-session context
|
|
544
|
+
- SQZ works downstream/context-side through the auto-registered `prodex-sqz` MCP server. Use it for repeated workspace reads, large text blobs, long command outputs that need reuse, and long-session context compression instead of emitting the same full content again.
|
|
545
|
+
- token-savior handles symbol lookup, caller/context navigation, duplicate/dead-code checks, and API-impact searches before broad source reads.
|
|
546
|
+
- claw-compactor handles workspace-level summary or benchmark requests through `prodex-claw-compactor` / `prodex-claw-compactor-auto`; treat its output as overview context and reread exact source before edits.
|
|
547
|
+
- Presidio stays optional and only runs when you opt in with the Super prompt or `--presidio`.
|
|
577
548
|
|
|
578
549
|
Managed optimizer checkouts are discovered from `PRODEX_OPTIMIZERS_HOME`, `$XDG_DATA_HOME/prodex-optimizers`, then `~/.local/share/prodex-optimizers`.
|
|
579
550
|
|
|
@@ -698,7 +669,7 @@ unless Prodex explicitly owns that command.
|
|
|
698
669
|
|---|---|---|
|
|
699
670
|
| Normal Codex | `prodex` or `prodex run` | Managed Codex launch with profile selection and quota routing. |
|
|
700
671
|
| Caveman | `prodex caveman` | Runs Codex with a temporary overlay `CODEX_HOME`. |
|
|
701
|
-
| Super | `prodex s` or `prodex super` | Daily mode with Caveman,
|
|
672
|
+
| Super | `prodex s` or `prodex super` | Daily mode with Caveman, RTK guidance, full access, and deterministic/local token optimizations. |
|
|
702
673
|
| Claude Code | `prodex claude` | Runs Claude Code through Prodex-managed state. |
|
|
703
674
|
|
|
704
675
|
<details>
|
|
@@ -718,8 +689,6 @@ prodex exec "review this repo"
|
|
|
718
689
|
|
|
719
690
|
```bash
|
|
720
691
|
prodex caveman
|
|
721
|
-
prodex caveman mem
|
|
722
|
-
prodex caveman mem rtk
|
|
723
692
|
prodex rtk
|
|
724
693
|
prodex sqz
|
|
725
694
|
prodex tokensavior
|
|
@@ -732,9 +701,7 @@ prodex caveman 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9
|
|
|
732
701
|
|
|
733
702
|
`prodex caveman` runs Codex with a temporary overlay `CODEX_HOME`, so the base profile home stays unchanged after the session ends.
|
|
734
703
|
|
|
735
|
-
|
|
736
|
-
|
|
737
|
-
Add optimizer prefixes before Codex args when you want Prodex to inject a specific launch overlay for that session: `mem`, `rtk`, `sqz`, `tokensavior`, `clawcompactor`, or `presidio`. Top-level shortcuts such as `prodex rtk` and `prodex sqz` map to `prodex caveman <prefix>`.
|
|
704
|
+
Add optimizer prefixes before Codex args when you want Prodex to inject a specific launch overlay for that session: `rtk`, `sqz`, `tokensavior`, `clawcompactor`, or `presidio`. Top-level shortcuts such as `prodex rtk` and `prodex sqz` map to `prodex caveman <prefix>`.
|
|
738
705
|
|
|
739
706
|
RTK is still an external binary. Install it separately if `rtk gain` is unavailable.
|
|
740
707
|
|
|
@@ -759,21 +726,7 @@ prodex super 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9
|
|
|
759
726
|
|
|
760
727
|
`prodex s` is the short alias for `prodex super`.
|
|
761
728
|
|
|
762
|
-
This is my daily mode. It is the path I keep tuning for normal work: Caveman enabled,
|
|
763
|
-
|
|
764
|
-
Super mode uses Prodex's slim Claude-Mem Codex schema by default to avoid storing full assistant/tool output in recall context.
|
|
765
|
-
|
|
766
|
-
Use `--mem-super-slim` to store prompt summaries/references instead of full prompt bodies:
|
|
767
|
-
|
|
768
|
-
```bash
|
|
769
|
-
prodex super --mem-super-slim
|
|
770
|
-
```
|
|
771
|
-
|
|
772
|
-
Use `--mem-full` when you need the full transcript schema:
|
|
773
|
-
|
|
774
|
-
```bash
|
|
775
|
-
prodex super --mem-full
|
|
776
|
-
```
|
|
729
|
+
This is my daily mode. It is the path I keep tuning for normal work: Caveman enabled, RTK guidance enabled, full access available, and context handling handled by the runtime proxy.
|
|
777
730
|
|
|
778
731
|
Super also enables Smart Context Autopilot in the runtime proxy.
|
|
779
732
|
|
|
@@ -865,11 +818,8 @@ Managed optimizer checkouts are discovered from `PRODEX_OPTIMIZERS_HOME`, `$XDG_
|
|
|
865
818
|
|
|
866
819
|
```bash
|
|
867
820
|
prodex claude -- -p "summarize this repo"
|
|
868
|
-
prodex claude mem -- -p "recall past work on this repo"
|
|
869
821
|
prodex claude caveman
|
|
870
|
-
prodex claude caveman mem
|
|
871
822
|
prodex claude caveman -- -p "summarize this repo briefly"
|
|
872
|
-
prodex claude caveman mem -- -p "summarize this repo briefly"
|
|
873
823
|
prodex claude --profile second caveman -- -p "review the latest diff briefly"
|
|
874
824
|
prodex claude --profile second -- -p --output-format json "show the latest diff"
|
|
875
825
|
```
|
|
@@ -878,8 +828,6 @@ prodex claude --profile second -- -p --output-format json "show the latest diff"
|
|
|
878
828
|
|
|
879
829
|
`prodex claude caveman` enables Caveman for that session while keeping state under the Prodex-managed `CLAUDE_CONFIG_DIR`, not the global `~/.claude`.
|
|
880
830
|
|
|
881
|
-
`prodex claude caveman mem` combines Caveman and Claude-Mem.
|
|
882
|
-
|
|
883
831
|
`prodex claude` is only supported with the default OpenAI/Codex provider.
|
|
884
832
|
|
|
885
833
|
</details>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@christiandoxa/prodex",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.193.0",
|
|
4
4
|
"description": "Safe multi-account auto-rotate for Codex CLI with isolated CODEX_HOME profiles",
|
|
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.193.0",
|
|
20
|
+
"@christiandoxa/prodex-linux-arm64": "0.193.0",
|
|
21
|
+
"@christiandoxa/prodex-darwin-x64": "0.193.0",
|
|
22
|
+
"@christiandoxa/prodex-darwin-arm64": "0.193.0",
|
|
23
|
+
"@christiandoxa/prodex-win32-x64": "0.193.0",
|
|
24
|
+
"@christiandoxa/prodex-win32-arm64": "0.193.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",
|