oh-my-pi-supreme-token-saver

Three toggleable OMP extensions that save tokens: terse replies, compact shell output, and minimal code decisions — with cache-safe CLI updates, in-session updates, and dry-run support.

Install

Option 1: npm exec (recommended)

npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver

Option 2: npm install global

npm install -g @fernado03/oh-my-pi-supreme-token-saver@latest
oh-my-pi-supreme-token-saver

Option 3: clone and run

git clone https://github.com/Fernado03/oh-my-pi-supreme-token-saver.git
cd oh-my-pi-supreme-token-saver
node install-omp-addons.js

The installer prints the package version it is running:

=== OMP Supreme Token Saver v<version> ===

Update to the latest package

One-off update:

npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver update

Or, after a global install:

npm install -g @fernado03/oh-my-pi-supreme-token-saver@latest
oh-my-pi-supreme-token-saver update

The update command fetches @latest, then runs that version of the installer non-interactively with user scope. Existing files are overwritten only when their contents changed; backups use the .bak suffix.

For in-session updates without re-running the installer:

/ai-addons update all

Dry run first to see what would change:

/ai-addons update all --dry-run

CLI Flags

# Fetch the latest package and update the user install
npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver update

# Preview a latest-package update
npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver update --dry-run

# Non-interactive install (user scope, no prompts)
npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver --scope user --yes

# Project-level install
npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver --scope project --yes

# Both user and project
npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver --scope both --yes

# Dry run — shows planned changes without writing
npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver --dry-run --scope user --yes

# Doctor — check installation health
npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver --doctor

# Uninstall — removes installed extensions (prompts for confirmation)
npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver --uninstall

# Uninstall without prompt
npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver --uninstall --yes

# Also remove the RTK binary during uninstall
npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver --uninstall --yes --remove-rtk

# Unregister Ponytail's extension path during uninstall (keeps the plugin package)
npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver --uninstall --yes --remove-ponytail

# Verbose output (debug details)
npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver --verbose

Scope options

| Flag | Meaning | |------|---------| | --scope user | User-level (all OMP sessions) — recommended | | --scope project | Project-level (this repo only) | | --scope both | Both user and project |

Dry run

npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver --dry-run

What it installs

| Extension | Command | What it does | |---|---|---| | Caveman | /caveman full | Shorter replies. Drops filler, keeps technical substance. Modes: lite, full, ultra, wenyan | | RTK | /rtk on | Compact shell output. Routes git status, git diff, test through RTK binary | | Ponytail | /ponytail full | Minimal code decisions. Prefers stdlib, avoids over-engineering | | Updater | /ai-addons check | In-session updates for Ponytail, RTK, and Caveman, with dry-run and backup support | | Combo | /combo medium | Toggle all 3 at once. Levels: off, medium, max. Off by default |

After install

Restart OMP. Fresh sessions start with all three modes off. Enable them together:

/combo medium

Or configure them individually:

/caveman full
/rtk on
/ponytail full

Check installed add-on versions with /ai-addons check. Use /combo max for the most aggressive combined modes.

Commands reference

Caveman — terse replies

/caveman lite         concise, drops pleasantries
/caveman full         terse caveman style
/caveman ultra        maximum terse, fragments only
/caveman wenyan       classical-Chinese-style where clear
/caveman off          normal mode
/caveman status       show current mode

Natural language can turn Caveman off:

"caveman off"
"stop caveman"
"normal mode"

RTK — compact shell output

/rtk on               enable RTK compact output
/rtk off              disable
/rtk status           show current state

When enabled, the agent prefers rtk for noisy commands:

rtk git status
rtk git diff
rtk read src/index.ts
rtk grep "pattern" src
rtk test bun test
rtk tsc
rtk lint

Ponytail — minimal code

/ponytail lite        light guidance
/ponytail full        full YAGNI enforcement
/ponytail ultra       aggressive simplification
/ponytail off         disable
/ponytail status      show current state

Updater — check and update add-ons

/ai-addons check                          check all add-on versions
/ai-addons status                         same as check
/ai-addons update ponytail                update ponytail
/ai-addons update rtk                     update rtk binary
/ai-addons update caveman                 update caveman rule
/ai-addons update all                     update all three
/ai-addons update all --dry-run           dry run, no changes

Combo — toggle all 3 at once

/combo off            all three off (default)
/combo medium         caveman=lite, rtk=on, ponytail=lite
/combo max            caveman=ultra, rtk=on, ponytail=ultra
/combo status         show current level and underlying modes
/combo help           show available levels

/combo persists each extension's state, reloads so the new modes apply immediately, and does not emit visible /caveman, /rtk, or /ponytail command messages.

File locations

| What | Path | |---|---| | Caveman extension | ~/.omp/agent/extensions/caveman-session/ | | RTK extension | ~/.omp/agent/extensions/rtk-session/index.js | | Ponytail | ~/.omp/plugins/node_modules/@dietrichgebert/ponytail/ | | Updater | ~/.omp/agent/extensions/ai-addons-updater/index.js | | Combo toggle | ~/.omp/agent/extensions/combo-toggle/index.js |

Backup behavior

When the installer replaces an existing extension source file, it first writes <file>.bak. The in-session updater also creates:

• RTK binary → rtk.exe.bak or rtk.bak (restored if the new binary fails validation)
• Caveman rule.md → rule.md.bak (restored if the written hash is invalid)

Manual install (without the script)

Caveman

Copy extensions/caveman-session/ to ~/.omp/agent/extensions/caveman-session/

RTK

1. Copy extensions/rtk-session/index.js to ~/.omp/agent/extensions/rtk-session/index.js
2. Download RTK binary from github.com/rtk-ai/rtk/releases
3. Place at ~/.bun/bin/rtk.exe (Windows) or ~/.bun/bin/rtk (Unix)

Ponytail

cd ~/.omp/plugins
omp plugin install github:DietrichGebert/ponytail

Updater

Copy extensions/ai-addons-updater/ to ~/.omp/agent/extensions/ai-addons-updater/

Combo toggle

Copy extensions/combo-toggle/ to ~/.omp/agent/extensions/combo-toggle/

Prerequisites

• OMP (Oh My Pi) installed
• Bun installed (for RTK binary path)
• Node.js 18+

Troubleshooting

Installer shows no version or update still prompts

An older one-off command selected a cached release. Cancel the prompt and force a registry freshness check:

npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver update

Check the latest published version with:

npm view @fernado03/oh-my-pi-supreme-token-saver version

/ponytail command not found (skill loads but command missing)

Ponytail's extension module may not be discovered by OMP on some setups. The install script handles this automatically by adding the extension path to config.yml, but if you installed manually:

Add this to ~/.omp/agent/config.yml:

extensions:
  - ~/.omp/plugins/node_modules/@dietrichgebert/ponytail/pi-extension/index.js

Then restart OMP. Verify with:

/ponytail status

/combo command not found

The installer auto-registers Combo in config.yml. If it still doesn't load:

extensions:
  - ~/.omp/agent/extensions/combo-toggle/index.js

Then restart OMP. Verify with:

/combo status

Combo status indicator not showing

Run these to diagnose:

/caveman status
/rtk status
/ponytail status
/combo status

Or run the installer doctor:

npm exec --yes --prefer-online --package=@fernado03/oh-my-pi-supreme-token-saver@latest -- oh-my-pi-supreme-token-saver --doctor

RTK not executable on Linux/macOS

The installer now sets chmod +x automatically. If manually installed:

chmod +x ~/.bun/bin/rtk

Checksum warnings or failures

The installer verifies RTK against checksums.txt when checksum metadata is available, and aborts on a mismatch. If the file or asset entry is unavailable, the installer warns and continues. /ai-addons update rtk is stricter and aborts when checksum metadata is missing.

MIT