@victor-software-house/pi-multicodex 2.0.4 → 2.0.6
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 +28 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -117,8 +117,33 @@ Local push protection via `lefthook` runs the same checks as CI before every pus
|
|
|
117
117
|
|
|
118
118
|
See [ROADMAP.md](ROADMAP.md) for planned work including configurable rotation settings, a shared controller architecture, and immediate footer persistence.
|
|
119
119
|
|
|
120
|
-
##
|
|
120
|
+
## Prior art and how this project differs
|
|
121
121
|
|
|
122
|
-
This
|
|
122
|
+
This extension builds on ideas from two earlier pi extensions. Both deserve credit for establishing the patterns that made this project possible.
|
|
123
123
|
|
|
124
|
-
|
|
124
|
+
### [kim0/pi-multicodex](https://github.com/kim0/pi-multicodex)
|
|
125
|
+
|
|
126
|
+
The original MultiCodex extension by [kim0](https://github.com/kim0). It introduced the core concept: manage multiple Codex OAuth accounts and rotate between them on quota failures. The original shipped as a single `index.ts` file (~990 lines) with three top-level commands (`/multicodex-login`, `/multicodex-use`, `/multicodex-status`), a stream wrapper for transparent retries, and account selection logic that prefers untouched accounts and earliest weekly resets.
|
|
127
|
+
|
|
128
|
+
This fork diverged significantly:
|
|
129
|
+
|
|
130
|
+
- **Modular architecture.** Split into 16 focused modules (~2,400 lines of runtime code, ~1,200 lines of tests) instead of one monolithic file.
|
|
131
|
+
- **Command family.** One `/multicodex` command with subcommands and dynamic autocomplete, replacing three separate top-level commands.
|
|
132
|
+
- **Account removal.** In-session account deletion from the picker via `Backspace` with confirmation — the original had no way to remove accounts without editing the JSON file.
|
|
133
|
+
- **Non-interactive mode.** All inspection and recovery subcommands (`show`, `verify`, `path`, `reset`, `help`) work without a UI panel.
|
|
134
|
+
- **Auth import.** Automatically imports pi's stored `openai-codex` credentials when they change, so existing pi logins work without re-entering them.
|
|
135
|
+
- **Token refresh.** Proactively refreshes OAuth tokens before expiry instead of failing on stale credentials.
|
|
136
|
+
- **Automated releases.** semantic-release with npm trusted publishing, commitlint, lefthook pre-push checks, and CI validation on every push.
|
|
137
|
+
|
|
138
|
+
### [calesennett/pi-codex-usage](https://github.com/calesennett/pi-codex-usage)
|
|
139
|
+
|
|
140
|
+
A footer-only extension by [calesennett](https://github.com/calesennett) that shows Codex usage windows in the pi status bar. It introduced the idea of a live footer displaying 5-hour and 7-day usage percentages with reset countdowns, and offered two commands to toggle display mode and reset window.
|
|
141
|
+
|
|
142
|
+
This project incorporated and extended that footer concept:
|
|
143
|
+
|
|
144
|
+
- **Integrated footer.** The usage footer is part of the rotation extension rather than a separate install, so it always reflects the active rotated account.
|
|
145
|
+
- **More settings.** Five configurable fields (usage mode, reset window, show account, show reset countdown, footer order) compared to two toggles.
|
|
146
|
+
- **Settings panel.** Interactive `SettingsList` modal with live preview instead of separate toggle commands.
|
|
147
|
+
- **Colored segments.** Footer renders usage percentages, separators, and account labels in distinct colors matched to the terminal theme.
|
|
148
|
+
- **Severity-based colors.** Usage percentages shift through four color tiers (green, amber, warning, error) as quota depletes — green above 50% remaining, amber at 50%, warning at 25%, red at 10% or below. The thresholds flip automatically when the display mode is set to "used" instead of "left."
|
|
149
|
+
- **Model-aware display.** Footer clears when switching to non-Codex models and debounces rapid model changes.
|