@christiandoxa/prodex 0.104.0 → 0.106.0

package/README.md

@@ -46,13 +46,17 @@ You need at least one logged-in Prodex profile.
 
 ## Installation
 
-### npm
+<details open>
+<summary>Install from npm</summary>
 
 ```bash
 npm install -g @christiandoxa/prodex
 ```
 
-### Source checkout
+</details>
+
+<details>
+<summary>Install from source checkout</summary>
 
 ```bash
 cargo install --path .
@@ -60,12 +64,17 @@ cargo install --path .
 
 If you install from source, make sure the `codex` binary in your `PATH` is already installed and up to date.
 
+</details>
+
 ## Optional tools
 
-`prodex` can run without Claude-Mem, RTK, SQZ, token-savior, claw-compactor, or llm-min docs.
+`prodex` can run without Claude-Mem, RTK, SQZ, token-savior, claw-compactor, or Presidio.
 
 Install them only if you want to use commands such as:
 
+<details>
+<summary>Optional tool commands</summary>
+
 ```bash
 prodex caveman mem
 prodex caveman mem rtk
@@ -73,13 +82,16 @@ prodex rtk
 prodex sqz
 prodex tokensavior
 prodex clawcompactor
-prodex llmmin
+prodex presidio doctor
+prodex presidio redact --text "My phone is 212-555-1234"
 prodex s
 prodex super
 prodex claude mem
 prodex claude caveman mem
 ```
 
+</details>
+
 <details>
 <summary>Install Claude-Mem</summary>
 
@@ -114,13 +126,13 @@ RTK is used by the `rtk` variants and by my daily `prodex s` / `prodex super` wo
 ### Homebrew
 
 ```bash
-brew install rtk
+brew install rtk-ai/tap/rtk
 ```
 
 ### Linux/macOS quick install
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
+curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/master/install.sh | sh
 ```
 
 If it installs to `~/.local/bin`, make sure that directory is in your `PATH`:
@@ -138,7 +150,7 @@ echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
 ### Cargo
 
 ```bash
-cargo install --git https://github.com/rtk-ai/rtk
+cargo install --git https://github.com/rtk-ai/rtk rtk
 ```
 
 ### Verify RTK
@@ -154,7 +166,7 @@ Remove it and reinstall from the Git URL:
 
 ```bash
 cargo uninstall rtk
-cargo install --git https://github.com/rtk-ai/rtk
+cargo install --git https://github.com/rtk-ai/rtk rtk
 ```
 
 ### Initialize RTK
@@ -175,9 +187,165 @@ Then restart your coding tool.
 
 </details>
 
+<details>
+<summary>Install SQZ</summary>
+
+SQZ is used by `prodex sqz` and by Super mode when the `sqz-mcp` binary is available on `PATH` or under a managed optimizer checkout.
+
+Recommended Linux/macOS install:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/ojuschugh1/sqz/main/install.sh | sh
+```
+
+Windows PowerShell:
+
+```powershell
+irm https://raw.githubusercontent.com/ojuschugh1/sqz/main/install.ps1 | iex
+```
+
+Alternative npm install:
+
+```bash
+npm install -g sqz-cli
+```
+
+Optional source install:
+
+```bash
+cargo install sqz-cli
+```
+
+Initialize hooks if you also want SQZ outside Prodex:
+
+```bash
+sqz init --global
+# or only for the current project
+sqz init
+```
+
+Verify:
+
+```bash
+sqz --version
+sqz gain
+which sqz-mcp
+```
+
+Prodex auto-registers `prodex-sqz` for Super/Caveman overlay sessions when `sqz-mcp` is discoverable.
+
+</details>
+
+<details>
+<summary>Install token-savior</summary>
+
+token-savior is used by `prodex tokensavior` and by Super mode when the `token-savior` binary is available on `PATH` or under a managed optimizer checkout.
+
+Recommended isolated install:
+
+```bash
+git clone https://github.com/Mibayy/token-savior ~/.local/share/token-savior
+python3 -m venv ~/.local/token-savior-venv
+~/.local/token-savior-venv/bin/pip install -e "$HOME/.local/share/token-savior[mcp]"
+ln -sf ~/.local/token-savior-venv/bin/token-savior ~/.local/bin/token-savior
+```
+
+Make sure `~/.local/bin` is on `PATH`:
+
+```bash
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
+```
+
+If you use Zsh:
+
+```bash
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
+```
+
+Verify:
+
+```bash
+token-savior --help
+which token-savior
+```
+
+Prodex handles MCP registration for its own overlay session when it can find the binary, so you do not need to manually edit `.mcp.json` just for `prodex super`.
+
+</details>
+
+<details>
+<summary>Install claw-compactor</summary>
+
+claw-compactor is used by `prodex clawcompactor` and by Super mode as a deterministic/local context compaction aid.
+
+Recommended source install:
+
+```bash
+git clone https://github.com/aeromomo/claw-compactor.git ~/.local/share/claw-compactor
+python3 -m venv ~/.local/claw-compactor-venv
+~/.local/claw-compactor-venv/bin/pip install -e "$HOME/.local/share/claw-compactor[accurate]"
+```
+
+If you only need exact token counting for the scripts:
+
+```bash
+~/.local/claw-compactor-venv/bin/pip install tiktoken
+```
+
+Expose the checkout to Prodex's managed optimizer discovery:
+
+```bash
+mkdir -p ~/.local/share/prodex-optimizers
+ln -sfn ~/.local/share/claw-compactor ~/.local/share/prodex-optimizers/claw-compactor
+```
+
+Quick non-destructive benchmark:
+
+```bash
+python3 ~/.local/share/claw-compactor/scripts/mem_compress.py /path/to/workspace benchmark
+```
+
+</details>
+
+<details>
+<summary>Install Presidio</summary>
+
+Presidio is used by `prodex presidio` and by the optional Super-mode privacy prompt. It runs as local Analyzer and Anonymizer HTTP services.
+
+Fast Docker install using Microsoft's published images:
+
+```bash
+docker pull mcr.microsoft.com/presidio-analyzer
+docker pull mcr.microsoft.com/presidio-anonymizer
+
+docker run -d --name presidio-analyzer -p 5002:3000 mcr.microsoft.com/presidio-analyzer:latest
+docker run -d --name presidio-anonymizer -p 5001:3000 mcr.microsoft.com/presidio-anonymizer:latest
+```
+
+Source checkout with Compose:
+
+```bash
+git clone https://github.com/microsoft/presidio.git ~/.local/share/presidio
+cd ~/.local/share/presidio
+docker compose -f docker-compose-text.yml up -d --build
+```
+
+Verify with Prodex:
+
+```bash
+prodex presidio doctor
+prodex presidio redact --text "My name is John Smith and my phone is 212-555-1234."
+prodex presidio enable
+```
+
+`prodex super` / `prodex s` asks `Use Presidio for data safety? [y/N]` before starting an interactive session. The default is `n`. Answering `y` marks the session as Presidio-enabled and is equivalent to adding the `presidio` prefix to the Super stack.
+
+</details>
+
 ## Quick start
 
-### Import your current Codex login
+<details open>
+<summary>Import your current Codex login</summary>
 
 If your current Codex home is already logged in:
 
@@ -185,7 +353,10 @@ If your current Codex home is already logged in:
 prodex profile import-current main
 ```
 
-### Or create profiles from scratch
+</details>
+
+<details>
+<summary>Create profiles from scratch</summary>
 
 ```bash
 prodex login
@@ -193,7 +364,10 @@ prodex profile add second
 prodex login --profile second
 ```
 
-### Check profiles and quota
+</details>
+
+<details>
+<summary>Check profiles and quota</summary>
 
 ```bash
 prodex profile list
@@ -201,7 +375,10 @@ prodex quota --all
 prodex session list
 ```
 
-### Start Codex through Prodex
+</details>
+
+<details>
+<summary>Start Codex through Prodex</summary>
 
 ```bash
 prodex
@@ -213,6 +390,8 @@ Or run a one-off prompt:
 prodex exec "review this repo"
 ```
 
+</details>
+
 <details>
 <summary>Import a Copilot CLI account</summary>
 
@@ -227,6 +406,9 @@ When you import a Copilot profile, Prodex does not move the Copilot token into P
 
 ## Daily command: `prodex s`
 
+<details open>
+<summary>Super mode overview</summary>
+
 For daily work, I use:
 
 ```bash
@@ -248,7 +430,7 @@ It combines:
 - RTK shell-command guidance
 - full-access launch mode
 - Smart Context Autopilot in the runtime proxy
-- deterministic/local accommodation for `sqz`, `token-savior`, `claw-compactor`, and `llm-min.txt`-style low-token workflows
+- deterministic/local accommodation for `sqz`, `token-savior`, and `claw-compactor` low-token workflows
 
 ```bash
 prodex s
@@ -258,12 +440,24 @@ prodex s exec "review this repo"
 `prodex super` expands to:
 
 ```bash
-prodex caveman mem rtk sqz tokensavior clawcompactor llmmin --full-access
+prodex caveman mem rtk sqz tokensavior clawcompactor --full-access
+```
+
+Before an interactive Super session starts, Prodex asks whether to enable Presidio:
+
+```text
+Use Presidio for data safety? [y/N]
+```
+
+The default is `n`. Answering `y` is equivalent to adding the `presidio` prefix:
+
+```bash
+prodex caveman mem rtk sqz tokensavior clawcompactor presidio --full-access
 ```
 
 Full access maps to Codex's sandbox-bypass launch flag. Use it only when you intentionally want Codex to run without the normal approval and sandbox protections.
 
-Super's built-in optimization stack is deliberately local and deterministic. It preloads the existing Caveman, Claude-Mem, and RTK pieces, auto-registers `sqz-mcp` and `token-savior` MCP servers when those binaries are already on `PATH` or in a managed `prodex-optimizers` checkout, then uses Smart Context Autopilot plus low-token workflow accommodations for targets such as `claw-compactor` and `llm-min.txt`.
+Super's built-in optimization stack is deliberately local and deterministic. It preloads the existing Caveman, Claude-Mem, and RTK pieces, auto-registers `sqz-mcp` and `token-savior` MCP servers when those binaries are already on `PATH` or in a managed `prodex-optimizers` checkout, then uses Smart Context Autopilot plus low-token workflow accommodations for targets such as `claw-compactor`.
 
 RTK and SQZ split the token work across different sides of the flow:
 
@@ -272,6 +466,8 @@ RTK and SQZ split the token work across different sides of the flow:
 
 Managed optimizer checkouts are discovered from `PRODEX_OPTIMIZERS_HOME`, `$XDG_DATA_HOME/prodex-optimizers`, then `~/.local/share/prodex-optimizers`.
 
+</details>
+
 ## Commands
 
 <details open>
@@ -405,7 +601,6 @@ prodex rtk
 prodex sqz
 prodex tokensavior
 prodex clawcompactor
-prodex llmmin
 prodex caveman --dry-run
 prodex caveman --profile main
 prodex caveman exec "review this repo in caveman mode"
@@ -416,7 +611,7 @@ prodex caveman 019c9e3d-45a0-7ad0-a6ee-b194ac2d44f9
 
 If you use the `mem` variant, Prodex points an existing Claude-Mem Codex setup to the active Prodex session path instead of the default `~/.codex/sessions`.
 
-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 `llmmin`. Top-level shortcuts such as `prodex rtk` and `prodex sqz` map to `prodex caveman <prefix>`.
+Add optimizer prefixes before Codex args when you want Prodex to inject a specific launch overlay for that session: `mem`, `rtk`, `sqz`, `tokensavior`, or `clawcompactor`. Top-level shortcuts such as `prodex rtk` and `prodex sqz` map to `prodex caveman <prefix>`.
 
 RTK is still an external binary. Install it separately if `rtk gain` is unavailable.
 
@@ -456,7 +651,7 @@ Super also enables Smart Context Autopilot in the runtime proxy.
 
 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.
 
-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, and accommodates `claw-compactor` and `llm-min.txt`-style workflows with local compaction, stable references, and lower-token context shaping rather than hidden remote summarization.
+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, and accommodates `claw-compactor` workflows with local compaction, stable references, and lower-token context shaping rather than hidden remote summarization.
 
 RTK handles upstream/input command output before it enters the context window. SQZ handles downstream/context reuse after content is already in the session, using `prodex-sqz` when the MCP server is available.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@christiandoxa/prodex",
-  "version": "0.104.0",
+  "version": "0.106.0",
   "description": "Safe multi-account auto-rotate for Codex CLI with isolated CODEX_HOME profiles",
   "license": "Apache-2.0",
   "bin": {
@@ -16,12 +16,12 @@
     "@openai/codex": "latest"
   },
   "optionalDependencies": {
-    "@christiandoxa/prodex-linux-x64": "0.104.0",
-    "@christiandoxa/prodex-linux-arm64": "0.104.0",
-    "@christiandoxa/prodex-darwin-x64": "0.104.0",
-    "@christiandoxa/prodex-darwin-arm64": "0.104.0",
-    "@christiandoxa/prodex-win32-x64": "0.104.0",
-    "@christiandoxa/prodex-win32-arm64": "0.104.0"
+    "@christiandoxa/prodex-linux-x64": "0.106.0",
+    "@christiandoxa/prodex-linux-arm64": "0.106.0",
+    "@christiandoxa/prodex-darwin-x64": "0.106.0",
+    "@christiandoxa/prodex-darwin-arm64": "0.106.0",
+    "@christiandoxa/prodex-win32-x64": "0.106.0",
+    "@christiandoxa/prodex-win32-arm64": "0.106.0"
   },
   "engines": {
     "node": ">=18"