@eiei114/pi-sub-bar 1.5.1

package/CHANGELOG.md

@@ -0,0 +1,201 @@
+# @marckrenn/pi-sub-bar
+
+## 1.5.1
+
+### Patch Changes
+
+- Updated dependencies [[`ad79e93`](https://github.com/eiei114/pi-sub/commit/ad79e935cd51239b0e74657aabe067885ad59b82), [`ad79e93`](https://github.com/eiei114/pi-sub/commit/ad79e935cd51239b0e74657aabe067885ad59b82)]:
+  - @eiei114/pi-sub-core@1.5.1
+  - @eiei114/pi-sub-shared@1.5.1
+
+## 1.5.0
+
+### Minor Changes
+
+- [#56](https://github.com/marckrenn/pi-sub/pull/56) [`864cc1b`](https://github.com/marckrenn/pi-sub/commit/864cc1bbc91897d934c0545a29f508862231963c) - Prioritize usage windows that match the active model before emitting `sub-core:update-current`, so compact status clients show the correct quota windows (including Codex Spark and Antigravity model-specific windows).
+
+  Also make settings list navigation compatible with both old and new `@mariozechner/pi-tui` keybinding APIs, preventing crashes in submenus on older Pi runtimes where `getEditorKeybindings()` is unavailable.
+
+  Thanks [@dnouri](https://github.com/dnouri) for [#54](https://github.com/marckrenn/pi-sub/pull/54).
+
+### Patch Changes
+
+- Updated dependencies [[`864cc1b`](https://github.com/marckrenn/pi-sub/commit/864cc1bbc91897d934c0545a29f508862231963c)]:
+  - @marckrenn/pi-sub-core@1.5.0
+  - @marckrenn/pi-sub-shared@1.5.0
+
+## 1.4.0
+
+### Minor Changes
+
+- [#51](https://github.com/marckrenn/pi-sub/pull/51) [`477ee48`](https://github.com/marckrenn/pi-sub/commit/477ee480ae1a3841808f1e46b0541e11adcf0651) Thanks [@marckrenn](https://github.com/marckrenn)! - Align `sub-bar`, `sub-core`, and `sub-shared` to `1.4.0` in lockstep.
+
+  No functional changes in this bump; this release normalizes package versions after the previous publish.
+
+### Patch Changes
+
+- Updated dependencies [[`477ee48`](https://github.com/marckrenn/pi-sub/commit/477ee480ae1a3841808f1e46b0541e11adcf0651)]:
+  - @marckrenn/pi-sub-core@1.4.0
+  - @marckrenn/pi-sub-shared@1.4.0
+
+## 1.3.1
+
+### Patch Changes
+
+- [#49](https://github.com/marckrenn/pi-sub/pull/49) [`833c19d`](https://github.com/marckrenn/pi-sub/commit/833c19db675f7c8ec7a9bb7fd04323607eb3aa1a) Thanks [@marckrenn](https://github.com/marckrenn)! - Set bundled default themes to use transparent widget background (`backgroundColor: none`) by default.
+
+  Thanks [@marckrenn](https://github.com/marckrenn) for aligning bundled defaults in this release line.
+
+- [#49](https://github.com/marckrenn/pi-sub/pull/49) [`3296415`](https://github.com/marckrenn/pi-sub/commit/3296415732cc1abb3a1687322b078931d5a142b6) Thanks [@marckrenn](https://github.com/marckrenn)! - Fix the status-line placement defaults and behavior:
+  - Keep `widgetPlacement` defaulting to `belowEditor` for merged settings state.
+  - In `widgetPlacement: "status"`, force left alignment and truncate-only overflow.
+  - Status-line placement: hide status-only alignment/overflow controls and apply compact formatting; disable right padding in footer mode where trailing spaces are not safely preservable. Left padding remains applied.
+
+  Thanks [@marckrenn](https://github.com/marckrenn) for the follow-up integration in this branch and [@pasky](https://github.com/pasky) for the original status-line work in PR [#44](https://github.com/marckrenn/pi-sub/pull/44).
+
+- [#49](https://github.com/marckrenn/pi-sub/pull/49) [`3296415`](https://github.com/marckrenn/pi-sub/commit/3296415732cc1abb3a1687322b078931d5a142b6) Thanks [@marckrenn](https://github.com/marckrenn)! - Add a new built-in **Default Footer** display theme preset, applying a status-line optimized footer layout directly from the theme picker.
+
+  Thanks [@marckrenn](https://github.com/marckrenn) for PR [#49](https://github.com/marckrenn/pi-sub/pull/49).
+
+- [#49](https://github.com/marckrenn/pi-sub/pull/49) [`5e2b792`](https://github.com/marckrenn/pi-sub/commit/5e2b792f469a934ecfdddef8f31079442e496c1f) Thanks [@marckrenn](https://github.com/marckrenn)! - Add support for a transparent widget background so users can disable background coloring when it reduces readability in their terminal theme.
+
+  This introduces an explicit `none` background choice in display settings and preserves that preference through settings updates, so the bar can render without forced background ANSI styling.
+
+  Thanks [@airtonix](https://github.com/airtonix) for implementing this in PR [#47](https://github.com/marckrenn/pi-sub/pull/47).
+
+- Updated dependencies []:
+  - @marckrenn/pi-sub-core@1.3.1
+  - @marckrenn/pi-sub-shared@1.3.1
+
+## 1.3.0
+
+### Minor Changes
+
+- [#42](https://github.com/marckrenn/pi-sub/pull/42) [`8bf29f3`](https://github.com/marckrenn/pi-sub/commit/8bf29f34c8f9418284cf30631a3325799c3e0f48) Thanks [@marckrenn](https://github.com/marckrenn)! - - Added an optional `showContextBar` setting (default: off), as introduced in [#10](https://github.com/marckrenn/pi-sub/pull/10) by [@pasky](https://github.com/pasky), to render the current context usage as an optional leftmost `Ctx` bar in sub-bar usage output.
+  - Support for Codex Spark usage (auto-selected for `gpt-5.3-codex-spark`), including model-specific window labeling behavior.
+  - OpenAI Status provider now surfaces the Codex-specific status endpoint instead of the generic status summary when available.
+  - [`80b49b1`](https://github.com/marckrenn/pi-sub/commit/80b49b16c20c942135764bcf6c4cd0516e868ce2) Fixed API key auth format handling for the z.ai provider.
+
+### Patch Changes
+
+- Updated dependencies [[`8bf29f3`](https://github.com/marckrenn/pi-sub/commit/8bf29f34c8f9418284cf30631a3325799c3e0f48)]:
+  - @marckrenn/pi-sub-core@1.3.0
+  - @marckrenn/pi-sub-shared@1.3.0
+
+## 1.2.0
+
+### Minor Changes
+
+- Added optional context-window support via `showContextBar` (default: off). When enabled, a `Ctx` bar can appear as the leftmost usage window.
+- Kept model-specific Codex Spark handling behavior.
+
+### Updated dependencies:
+
+- @marckrenn/pi-sub-core@1.2.0
+- @marckrenn/pi-sub-shared@1.2.0
+
+## 1.1.0
+
+### Minor Changes
+
+- [`e9c1c39`](https://github.com/marckrenn/pi-sub/commit/e9c1c394286b302e018c2c824d16978b2b4d3d44) Thanks [@plesiv](https://github.com/plesiv)! - Make keybindings configurable
+
+### Patch Changes
+
+- Updated dependencies [[`7ce2a92`](https://github.com/marckrenn/pi-sub/commit/7ce2a92b15e766fd85a4b7eb85d6fc5c5aa32dca)]:
+  - @marckrenn/pi-sub-core@1.1.0
+  - @marckrenn/pi-sub-shared@1.1.0
+
+## 1.0.6
+
+### Patch Changes
+
+- Remove `bundleDependencies`/`bundledDependencies` from `@marckrenn/pi-sub-bar` to fix `npm install -g @marckrenn/pi-sub-bar` failing with `protobufjs` postinstall (missing `scripts/postinstall.js`) on Node 24+/npm.
+
+  Also include a second extension path (`../pi-sub-core/index.ts`) so `sub-core` is discovered whether npm installs `@marckrenn/pi-sub-core` nested or hoisted, restoring `/sub-core:settings`.
+
+- Updated dependencies []:
+  - @marckrenn/pi-sub-core@1.0.6
+  - @marckrenn/pi-sub-shared@1.0.6
+
+## 1.0.5
+
+### Patch Changes
+
+- [#35](https://github.com/marckrenn/pi-sub/pull/35) [`59e2b45`](https://github.com/marckrenn/pi-sub/commit/59e2b456e0e5c41479dccedcef93f9175cc4aa55) Thanks [@marckrenn](https://github.com/marckrenn)! - Improve startup responsiveness by deferring refreshes and watchers, skipping headless UI work, and unref-ing long-lived timers so pi CLI commands exit cleanly.
+
+- Updated dependencies [[`59e2b45`](https://github.com/marckrenn/pi-sub/commit/59e2b456e0e5c41479dccedcef93f9175cc4aa55)]:
+  - @marckrenn/pi-sub-core@1.0.5
+  - @marckrenn/pi-sub-shared@1.0.5
+
+## 1.0.4
+
+### Patch Changes
+
+- [#28](https://github.com/marckrenn/pi-sub/pull/28) [`2e35657`](https://github.com/marckrenn/pi-sub/commit/2e3565776a98ec133537fe0bacbc099cd4afadbe) Thanks [@marckrenn](https://github.com/marckrenn)! - Default Anthropic “Show Extra Window” provider setting to off.
+
+- [#29](https://github.com/marckrenn/pi-sub/pull/29) [`7e6b7a0`](https://github.com/marckrenn/pi-sub/commit/7e6b7a08d69cf1cd456d2add406ec89c5c86f5df) Thanks [@marckrenn](https://github.com/marckrenn)! - Split display padding into left/right settings and migrate legacy paddingX values to both sides.
+
+- [#22](https://github.com/marckrenn/pi-sub/pull/22) [`3e5a026`](https://github.com/marckrenn/pi-sub/commit/3e5a026ea3dc113561ff32466a8aa03b91c6d876) Thanks [@marckrenn](https://github.com/marckrenn)! - Store sub-core and sub-bar settings in agent-level JSON files so updates no longer overwrite user configuration. Legacy extension `settings.json` files are migrated into the new files and removed after a successful migration.
+
+  Manual migration (if you want to do it yourself before updating):
+
+  ```
+  cp ~/.pi/agent/extensions/sub-core/settings.json ~/.pi/agent/pi-sub-core-settings.json
+  cp ~/.pi/agent/extensions/sub-bar/settings.json ~/.pi/agent/pi-sub-bar-settings.json
+  ```
+
+  Existing users should move legacy settings from the extension folders to:
+  - `~/.pi/agent/pi-sub-core-settings.json`
+  - `~/.pi/agent/pi-sub-bar-settings.json`
+
+- [#23](https://github.com/marckrenn/pi-sub/pull/23) [`9c324fc`](https://github.com/marckrenn/pi-sub/commit/9c324fc7daae2a874816f600ac1ea422f3799dd2) Thanks [@marckrenn](https://github.com/marckrenn)! - Auto-post theme share strings when saving, add a “Share theme” menu entry, allow share strings without a name when importing, and post raw share strings (without the `/sub-bar:import` prefix).
+
+- [#25](https://github.com/marckrenn/pi-sub/pull/25) [`ab97c8f`](https://github.com/marckrenn/pi-sub/commit/ab97c8f13c567c32581bb82fe5b0406b3f2464ca) Thanks [@marckrenn](https://github.com/marckrenn)! - Refine the theme menu ordering/labels and add rename support for saved themes in the Manage & Load flow.
+
+- [#27](https://github.com/marckrenn/pi-sub/pull/27) [`549c6fe`](https://github.com/marckrenn/pi-sub/commit/549c6fe3eb57374a54bfc69ad70c91862250a186) Thanks [@marckrenn](https://github.com/marckrenn)! - Move Themes to the root settings menu, rename Display Settings to Adv. Display Settings, and rename “Manage & Load themes” to “Load & Manage themes”.
+
+- [#26](https://github.com/marckrenn/pi-sub/pull/26) [`af28d98`](https://github.com/marckrenn/pi-sub/commit/af28d9820f80bc1d045783644afbcc4d7cd114f1) Thanks [@marckrenn](https://github.com/marckrenn)! - Prompt to upload theme share strings as secret GitHub gists and post the gist URL when accepted.
+
+- Updated dependencies [[`af0828a`](https://github.com/marckrenn/pi-sub/commit/af0828a8d2e529497a1acff95e388a0a3eabb90e), [`3e5a026`](https://github.com/marckrenn/pi-sub/commit/3e5a026ea3dc113561ff32466a8aa03b91c6d876), [`a6c0d33`](https://github.com/marckrenn/pi-sub/commit/a6c0d33c8d19d2876a4a8a1a0a69302a3c63f5e8), [`7da1e08`](https://github.com/marckrenn/pi-sub/commit/7da1e082e634f4e4dee2560b4d490527d1543ade), [`1f5e451`](https://github.com/marckrenn/pi-sub/commit/1f5e45173b9868b0d6645ae35a084142a0ac56a5), [`35eb185`](https://github.com/marckrenn/pi-sub/commit/35eb18590f369db4cda931b8e11099d0f3ddb4ec)]:
+  - @marckrenn/pi-sub-core@1.0.4
+  - @marckrenn/pi-sub-shared@1.0.4
+
+## 1.0.3
+
+### Patch Changes
+
+- [`6fa2736`](https://github.com/marckrenn/pi-sub/commit/6fa27363573f34c38a372a6d7b8b74e756716724) Thanks [@marckrenn](https://github.com/marckrenn)! - Update extension tool execute signature order for compatibility with latest Pi API.
+
+- Updated dependencies [[`6fa2736`](https://github.com/marckrenn/pi-sub/commit/6fa27363573f34c38a372a6d7b8b74e756716724)]:
+  - @marckrenn/pi-sub-core@1.0.3
+  - @marckrenn/pi-sub-shared@1.0.3
+
+## 1.0.2
+
+### Patch Changes
+
+- [#3](https://github.com/marckrenn/pi-sub/pull/3) [`4ceb5ad`](https://github.com/marckrenn/pi-sub/commit/4ceb5ad133166237652d197ba9296ad1589a813c) Thanks [@marckrenn](https://github.com/marckrenn)! - Bundle sub-core with sub-bar, refresh Antigravity quotas + settings, and update UI copy/controls.
+
+- Updated dependencies [[`4ceb5ad`](https://github.com/marckrenn/pi-sub/commit/4ceb5ad133166237652d197ba9296ad1589a813c)]:
+  - @marckrenn/pi-sub-core@1.0.2
+  - @marckrenn/pi-sub-shared@1.0.2
+
+## 1.0.1
+
+### Patch Changes
+
+- Align repo version with npm publish.
+- Updated dependencies:
+  - @marckrenn/pi-sub-shared@1.0.1
+
+## 1.0.0
+
+### Major Changes
+
+- [`9bedd80`](https://github.com/marckrenn/pi-sub/commit/9bedd80b0037b723e70f0376019fff59a617e7cb) Thanks [@marckrenn](https://github.com/marckrenn)! - Initial 1.0.0 release.
+
+### Patch Changes
+
+- Updated dependencies [[`9bedd80`](https://github.com/marckrenn/pi-sub/commit/9bedd80b0037b723e70f0376019fff59a617e7cb)]:
+  - @marckrenn/pi-sub-shared@1.0.0

package/README.md

@@ -0,0 +1,200 @@
+# sub-bar
+
+Usage widget extension for [pi-coding-agent](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent).
+
+Displays current provider usage in a widget below the editor. Fetching and caching are handled by `sub-core`.
+
+### Impressions
+
+https://github.com/user-attachments/assets/d61d82f6-afd0-45fc-82f3-69910543aa7a
+
+![sub-bar default](../../docs/screenshots/sub-bar-default.png)
+![sub-bar minimal](../../docs/screenshots/sub-bar-minimal.png)
+![sub-bar wtf](../../docs/screenshots/sub-bar-wtf.png)
+
+## Overview
+
+### Features
+
+- Displays realtime usage quotas for multiple AI providers
+- Auto-detects provider from current model (via sub-core)
+- Shows rate limit windows with visual progress bars
+- Status indicators from provider status pages
+- Theme save/share/import and `sub-bar:import` preview flow
+- Provider Shown selector to pin the displayed provider
+- **Extensive settings UI** via `sub-bar:settings`
+- Cycle through providers with `Ctrl+Alt+P`
+
+### Supported Providers
+
+| Provider | Usage Data | Status Page |
+|----------|-----------|-------------|
+| Anthropic (Claude) | 5h/Week windows, extra usage | ✅ |
+| GitHub Copilot | Monthly quota, requests | ✅ |
+| Google Gemini | Pro/Flash quotas | ✅ |
+| Antigravity | Model quotas | ✅ |
+| OpenAI Codex | Primary/secondary windows | ✅ |
+| AWS Kiro | Credits | - |
+| z.ai | Tokens/monthly limits | - |
+
+### Provider Feature Matrix
+
+| Provider | Usage Windows | Extra Info | Status Indicator | Tested | Notes |
+|----------|--------------|------------|------------------|--------|-------|
+| Anthropic (Claude) | 5h, Week, Extra | Extra usage label | ✅ | ✅ | Extra usage can show on/off state |
+| GitHub Copilot | Month | Model multiplier + requests left | ✅ | ✅ | Requests left uses model multiplier |
+| Google Gemini | Pro, Flash | - | ✅ | - | Quotas aggregated per model family |
+| Antigravity | Models | - | ✅ | ✅ | Sandbox Cloud Code Assist quotas |
+| OpenAI Codex | Primary, Secondary | - | ✅ | ✅ | Credits not yet supported (PRs welcome!) |
+| AWS Kiro | Credits | - | - | - | - |
+| z.ai | Tokens, Monthly | - | - | - | API quota limits |
+
+## Installation
+
+Install via the pi package manager (recommended). `sub-bar` bundles `sub-core`, so you only need to install sub-bar:
+
+```bash
+pi install npm:@eiei114/pi-sub-bar
+```
+
+Use `-l` to install into project settings instead of global:
+
+```bash
+pi install -l npm:@eiei114/pi-sub-bar
+```
+
+If you previously installed `sub-core` separately, remove it from `~/.pi/agent/extensions` or `~/.pi/agent/settings.json` to avoid duplicate core instances.
+
+Manual install (local development):
+
+```bash
+git clone https://github.com/eiei114/pi-sub.git
+cd pi-sub
+npm install
+
+ln -s /path/to/pi-sub/packages/sub-bar ~/.pi/agent/extensions/sub-bar
+```
+
+For local development, also ensure sub-core is available (either link it separately or link it into `packages/sub-bar/node_modules`).
+
+Alternative (no symlink): add sub-bar to `~/.pi/agent/settings.json`:
+
+```json
+{
+  "extensions": [
+    "/path/to/pi-sub/packages/sub-bar/index.ts"
+  ]
+}
+```
+
+## Usage
+
+The extension loads automatically. Use:
+
+- `sub-bar:settings` - Open display + provider UI settings (includes Provider Shown)
+- `sub-bar:import <share string>` - Preview a shared theme and choose to save/apply
+- `sub-core:settings` - Configure provider enablement/order + usage/status refresh settings
+- `Ctrl+Alt+P` - Cycle through available providers (configurable)
+- `Ctrl+Alt+R` - Toggle reset timer format (configurable)
+
+**Keybindings:**
+
+Shortcuts are configurable via `sub-bar:settings` → Keybindings. Enter any valid key combo (e.g. `ctrl+alt+p`, `ctrl+shift+s`) or `none` to disable a shortcut. Keybinding changes take effect after pi restart.
+
+**Caching:**
+- Handled by sub-core at `~/.pi/agent/cache/sub-core/cache.json`
+- Cache TTL matches your auto-refresh interval setting
+- Lock file prevents race conditions between multiple pi windows
+
+## Communication with sub-core
+
+`sub-bar` is a display client. It listens for `sub-core:update-current`/`sub-core:ready` events and renders the widget. On startup it requests the current state via `sub-core:request`.
+
+`sub-bar` manages display settings and UI-only provider options (window visibility, labels, status indicator). Provider enablement lives in sub-core, but the sub-bar settings UI can toggle Enabled (auto/on/off) and forwards changes to `sub-core:settings:patch`. Ordering and refresh behavior are configured in `sub-core:settings`, and sub-core broadcasts updates that sub-bar consumes. The cycle command forwards to `sub-core:action` so core updates provider selection and then broadcasts the new state.
+
+## Settings
+
+Display and provider UI settings are stored in `~/.pi/agent/pi-sub-bar-settings.json` (migrated from the legacy extension `settings.json` when present; the legacy file is removed after a successful migration). Core settings are managed by sub-core, and the sub-bar settings menu includes a shortcut that points you to `sub-core:settings` for additional options.
+
+**Settings migrations:** settings are merged with defaults on load, but renames/removals are not migrated automatically. When adding new settings or changing schema, update the defaults/merge logic and provide a migration (or instruct users to reset `pi-sub-bar-settings.json`).
+
+### Provider UI Settings
+
+Use `sub-bar:settings` → Provider Settings to control enabled state (auto/on/off), status indicators, and per-provider window visibility.
+
+### Core Settings
+
+Use `sub-core:settings` to configure provider enablement (auto/on/off), fetch status, usage refresh settings, status refresh settings, and provider order.
+
+### Display Settings
+
+Use Display Settings → Theme to save, load, import, and randomize display themes.
+
+Display Settings cover layout, bars, labels/text, reset timers, status indicators, dividers, and color tuning. Open `sub-bar:settings` → Display Settings to explore the full list in the UI.
+
+## Credentials
+
+Credentials are loaded by sub-core from:
+
+- `~/.pi/agent/auth.json` - pi's auth file
+- Provider-specific locations (e.g., `~/.codex/auth.json`, `~/.gemini/oauth_creds.json`)
+- macOS Keychain for Claude Code credentials
+- Environment variables (e.g., `Z_AI_API_KEY`)
+
+## Development
+
+### Packaging notes (pi install compatibility)
+
+Pi packages use a `pi` field in `package.json` plus the `pi-package` keyword for discoverability. This repo already declares `pi.extensions`, so you can install via:
+
+```bash
+pi install npm:@eiei114/pi-sub-core
+pi install npm:@eiei114/pi-sub-bar
+```
+
+Manual paths/symlinks still work for local development as documented above.
+
+### Architecture
+
+```
+sub-bar/
+├── index.ts              # Extension entry point (display client)
+├── src/
+│   ├── formatting.ts     # UI formatting
+│   ├── status.ts         # Status indicator helpers
+│   ├── utils.ts          # Display helpers
+│   ├── providers/        # Display metadata + visibility rules
+│   ├── settings/         # Settings UI helpers
+│   ├── settings-types.ts # Settings type definitions
+│   ├── settings.ts       # Settings persistence
+│   └── usage/types.ts    # Shared usage types
+├── package.json
+└── tsconfig.json
+```
+
+### Adding a New Provider
+
+Update both sub-core (fetch) and sub-bar (display). See `sub-core/README.md` for the full checklist.
+
+### Feature placement (UI vs core)
+
+- **sub-bar** owns presentation (formatting, layout, status indicators, UI settings).
+- **sub-core** owns data fetching, caching, provider selection, and shared settings/events.
+- Add shared types to **sub-shared** when both layers reference them.
+
+See the root README “Developer guide” for the full decision checklist and examples.
+
+### Commands
+
+```bash
+npm run check
+```
+
+## Credits
+
+- ~Hannes~ Helmut Januschka ([usage-bar.ts](https://github.com/hjanuschka/shitty-extensions?tab=readme-ov-file#usage-barts), [@hjanuschka](https://x.com/hjanuschka))
+- Peter Steinberger ([CodexBar](https://github.com/steipete/CodexBar), [@steipete](https://x.com/steipete))
+
+## License
+
+MIT