@marckrenn/pi-sub-bar 1.0.2 → 1.0.4

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # @marckrenn/pi-sub-bar
 
+## 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

package/README.md

@@ -51,7 +51,7 @@ https://github.com/user-attachments/assets/d61d82f6-afd0-45fc-82f3-69910543aa7a
 
 ## Installation
 
-Install via the pi package manager (recommended). `sub-bar` bundles `sub-core`, so you only need to install `sub-bar`:
+Install via the pi package manager (recommended). `sub-bar` bundles `sub-core`, so you only need to install sub-bar:
 
 ```bash
 pi install npm:@marckrenn/pi-sub-bar
@@ -63,6 +63,8 @@ Use `-l` to install into project settings instead of global:
 pi install -l npm:@marckrenn/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
@@ -73,9 +75,9 @@ npm install
 ln -s /path/to/pi-sub/packages/sub-bar ~/.pi/agent/extensions/sub-bar
 ```
 
-If you want to develop `sub-core` separately, also symlink `packages/sub-core` into `~/.pi/agent/extensions`.
+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`:
+Alternative (no symlink): add sub-bar to `~/.pi/agent/settings.json`:
 
 ```json
 {
@@ -96,7 +98,7 @@ The extension loads automatically. Use:
 - `Ctrl+Alt+R` - Toggle reset timer format (relative vs datetime)
 
 **Caching:**
-- Handled by sub-core at `cache.json` next to the sub-core extension entry
+- 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
 
@@ -108,9 +110,9 @@ The extension loads automatically. Use:
 
 ## Settings
 
-Display and provider UI settings are persisted next to the extension entry (`settings.json` in the same folder as `index.ts`). 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.
+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 `settings.json`).
+**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
 
@@ -142,6 +144,7 @@ Credentials are loaded by sub-core from:
 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:@marckrenn/pi-sub-core
 pi install npm:@marckrenn/pi-sub-bar
 ```
 

package/index.ts

@@ -7,7 +7,7 @@
 import type { ExtensionAPI, ExtensionContext, Theme, ThemeColor } from "@mariozechner/pi-coding-agent";
 import { Container, Input, SelectList, Spacer, Text, truncateToWidth, wrapTextWithAnsi, visibleWidth } from "@mariozechner/pi-tui";
 import * as fs from "node:fs";
-import { homedir } from "node:os";
+import { homedir, tmpdir } from "node:os";
 import { join } from "node:path";
 import type { ProviderName, ProviderUsageEntry, SubCoreAllState, SubCoreState, UsageSnapshot } from "./src/types.js";
 import type { Settings, BaseTextColor } from "./src/settings-types.js";
@@ -128,6 +128,59 @@ export default function createExtension(pi: ExtensionAPI) {
 	let settingsSnapshot = "";
 	let settingsMtimeMs = 0;
 	let settingsWatchStarted = false;
+	let subCoreBootstrapAttempted = false;
+
+	async function probeSubCore(timeoutMs = 200): Promise<boolean> {
+		return new Promise((resolve) => {
+			let resolved = false;
+			const timer = setTimeout(() => {
+				if (!resolved) {
+					resolved = true;
+					resolve(false);
+				}
+			}, timeoutMs);
+
+			const request: SubCoreRequest = {
+				type: "current",
+				reply: () => {
+					if (resolved) return;
+					resolved = true;
+					clearTimeout(timer);
+					resolve(true);
+				},
+			};
+			pi.events.emit("sub-core:request", request);
+		});
+	}
+
+	async function ensureSubCoreLoaded(): Promise<void> {
+		if (subCoreBootstrapAttempted) return;
+		subCoreBootstrapAttempted = true;
+		const hasCore = await probeSubCore();
+		if (hasCore) return;
+		try {
+			const bundledUrl = new URL("./node_modules/@marckrenn/pi-sub-core/index.ts", import.meta.url);
+			const module = await import(bundledUrl.toString());
+			const createCore = module.default as undefined | ((api: ExtensionAPI) => void | Promise<void>);
+			if (typeof createCore === "function") {
+				void createCore(pi);
+				return;
+			}
+		} catch {
+			// Fall back to package resolution
+		}
+		try {
+			const module = await import("@marckrenn/pi-sub-core");
+			const createCore = module.default as undefined | ((api: ExtensionAPI) => void | Promise<void>);
+			if (typeof createCore === "function") {
+				void createCore(pi);
+			}
+		} catch (error) {
+			console.warn("Failed to auto-load sub-core:", error);
+		}
+	}
+
+	void ensureSubCoreLoaded();
 
 	async function promptImportAction(ctx: ExtensionContext): Promise<"save-apply" | "save" | "cancel"> {
 		return new Promise((resolve) => {
@@ -171,7 +224,7 @@ export default function createExtension(pi: ExtensionAPI) {
 					resolve(undefined);
 				};
 				const container = new Container();
-				container.addChild(new Text(theme.fg("muted", "Share string"), 1, 0));
+				container.addChild(new Text(theme.fg("muted", "Paste Theme Share string"), 1, 0));
 				container.addChild(new Spacer(1));
 				container.addChild(input);
 				return {
@@ -183,6 +236,141 @@ export default function createExtension(pi: ExtensionAPI) {
 		});
 	}
 
+	async function promptImportName(ctx: ExtensionContext): Promise<string | undefined> {
+		while (true) {
+			const name = await ctx.ui.input("Theme name", "Theme");
+			if (name === undefined) return undefined;
+			const trimmed = name.trim();
+			if (trimmed) return trimmed;
+			ctx.ui.notify("Enter a theme name", "warning");
+		}
+	}
+
+	const THEME_GIST_FILE_BASE = "pi-sub-bar Theme";
+	const THEME_GIST_STATUS_KEY = "sub-bar:share";
+
+	function buildThemeGistFileName(name: string): string {
+		const trimmed = name.trim();
+		if (!trimmed) return THEME_GIST_FILE_BASE;
+		const safeName = trimmed.replace(/[\\/:*?"<>|]+/g, "-").trim();
+		return safeName ? `${THEME_GIST_FILE_BASE} ${safeName}` : THEME_GIST_FILE_BASE;
+	}
+
+	async function createThemeGist(ctx: ExtensionContext, name: string, shareString: string): Promise<string | null> {
+		const notify = (message: string, level: "info" | "warning" | "error") => {
+			if (ctx.hasUI) {
+				ctx.ui.notify(message, level);
+				return;
+			}
+			if (level === "error") {
+				console.error(message);
+			} else if (level === "warning") {
+				console.warn(message);
+			} else {
+				console.log(message);
+			}
+		};
+
+		try {
+			const authResult = await pi.exec("gh", ["auth", "status"]);
+			if (authResult.code !== 0) {
+				notify("GitHub CLI is not logged in. Run 'gh auth login' first.", "error");
+				return null;
+			}
+		} catch {
+			notify("GitHub CLI (gh) is not installed. Install it from https://cli.github.com/", "error");
+			return null;
+		}
+
+		const tempDir = fs.mkdtempSync(join(tmpdir(), "pi-sub-bar-"));
+		const fileName = buildThemeGistFileName(name);
+		const filePath = join(tempDir, fileName);
+		fs.writeFileSync(filePath, shareString, "utf-8");
+
+		if (ctx.hasUI) {
+			ctx.ui.setStatus(THEME_GIST_STATUS_KEY, "Creating gist...");
+		}
+
+		try {
+			const result = await pi.exec("gh", ["gist", "create", "--public=false", filePath]);
+			if (result.code !== 0) {
+				const errorMsg = result.stderr?.trim() || "Unknown error";
+				notify(`Failed to create gist: ${errorMsg}`, "error");
+				return null;
+			}
+			const gistUrl = result.stdout?.trim();
+			if (!gistUrl) {
+				notify("Failed to create gist: empty response", "error");
+				return null;
+			}
+			return gistUrl;
+		} catch (error) {
+			notify(`Failed to create gist: ${error instanceof Error ? error.message : "Unknown error"}`, "error");
+			return null;
+		} finally {
+			if (ctx.hasUI) {
+				ctx.ui.setStatus(THEME_GIST_STATUS_KEY, undefined);
+			}
+			try {
+				fs.rmSync(tempDir, { recursive: true, force: true });
+			} catch {
+				// Ignore cleanup errors
+			}
+		}
+	}
+
+	async function shareThemeString(
+		ctx: ExtensionContext,
+		name: string,
+		shareString: string,
+		mode: "prompt" | "gist" | "string" = "prompt",
+	): Promise<void> {
+		const trimmedName = name.trim();
+		const notify = (message: string, level: "info" | "warning" | "error") => {
+			if (ctx.hasUI) {
+				ctx.ui.notify(message, level);
+				return;
+			}
+			if (level === "error") {
+				console.error(message);
+			} else if (level === "warning") {
+				console.warn(message);
+			} else {
+				console.log(message);
+			}
+		};
+		let resolvedMode = mode;
+		if (resolvedMode === "prompt") {
+			if (!ctx.hasUI) {
+				resolvedMode = "string";
+			} else {
+				const wantsGist = await ctx.ui.confirm("Share Theme", "Upload to a secret GitHub gist?");
+				resolvedMode = wantsGist ? "gist" : "string";
+			}
+		}
+
+		if (resolvedMode === "gist") {
+			const gistUrl = await createThemeGist(ctx, trimmedName, shareString);
+			if (gistUrl) {
+				pi.sendMessage({
+					customType: "sub-bar",
+					content: `Theme gist:\n${gistUrl}`,
+					display: true,
+				});
+				notify("Theme gist posted to chat", "info");
+				return;
+			}
+			notify("Posting share string instead.", "warning");
+		}
+
+		pi.sendMessage({
+			customType: "sub-bar",
+			content: `Theme share string:\n${shareString}`,
+			display: true,
+		});
+		notify("Theme share string posted to chat", "info");
+	}
+
 	function readSettingsFile(): string | undefined {
 		try {
 			return fs.readFileSync(SETTINGS_PATH, "utf-8");
@@ -273,8 +461,9 @@ export default function createExtension(pi: ExtensionAPI) {
 			(_tui: unknown, theme: Theme) => ({
 				render(width: number) {
 					const safeWidth = Math.max(1, width);
-					const paddingX = settings.display.paddingX ?? 0;
-					const contentWidth = Math.max(1, safeWidth - paddingX * 2);
+					const paddingLeft = settings.display.paddingLeft ?? 0;
+					const paddingRight = settings.display.paddingRight ?? 0;
+					const contentWidth = Math.max(1, safeWidth - paddingLeft - paddingRight);
 					const showTopDivider = settings.display.showTopDivider ?? false;
 					const showBottomDivider = settings.display.showBottomDivider ?? true;
 					const dividerChar = settings.display.dividerCharacter ?? "•";
@@ -315,9 +504,10 @@ export default function createExtension(pi: ExtensionAPI) {
 						lines = [trimmed];
 					}
 
-					if (paddingX > 0) {
-						const pad = " ".repeat(paddingX);
-						lines = lines.map((line) => pad + line + pad);
+					if (paddingLeft > 0 || paddingRight > 0) {
+						const leftPad = " ".repeat(paddingLeft);
+						const rightPad = " ".repeat(paddingRight);
+						lines = lines.map((line) => `${leftPad}${line}${rightPad}`);
 					}
 
 					if (showTopDivider) {
@@ -593,20 +783,14 @@ export default function createExtension(pi: ExtensionAPI) {
 				onDisplayThemeApplied: (name, options) => {
 					const content = options?.source === "manual"
 						? `sub-bar Theme ${name} loaded`
-						: `sub-bar Theme ${name} loaded / applied / saved. Restore settings in /sub-bar:settings -> Display Settings -> Theme -> Manage themes`;
+						: `sub-bar Theme ${name} loaded / applied / saved. Restore settings in /sub-bar:settings -> Themes -> Load & Manage themes`;
 					pi.sendMessage({
 						customType: "sub-bar",
 						content,
 						display: true,
 					});
 				},
-				onDisplayThemeShared: (_name, shareString) => {
-					pi.sendMessage({
-						customType: "sub-bar",
-						content: `Theme share string:\n/sub-bar:import ${shareString}`,
-						display: true,
-					});
-				},
+				onDisplayThemeShared: (name, shareString, mode) => shareThemeString(ctx, name, shareString, mode ?? "prompt"),
 			});
 			settings = newSettings;
 			void ensurePinnedEntries(settings.pinnedProvider ?? null);
@@ -642,35 +826,47 @@ export default function createExtension(pi: ExtensionAPI) {
 			}
 
 			const action = await promptImportAction(ctx);
-			const notifyImported = () => {
+			let resolvedName = decoded.name;
+			if ((action === "save-apply" || action === "save") && !decoded.hasName) {
+				const providedName = await promptImportName(ctx);
+				if (!providedName) {
+					settings.display = { ...backup };
+					if (lastContext) {
+						renderUsageWidget(lastContext, currentUsage);
+					}
+					return;
+				}
+				resolvedName = providedName;
+			}
+			const notifyImported = (name: string) => {
 				const message = decoded.isNewerVersion
-					? `Imported ${decoded.name} (newer version, some fields may be ignored)`
-					: `Imported ${decoded.name}`;
+					? `Imported ${name} (newer version, some fields may be ignored)`
+					: `Imported ${name}`;
 				ctx.ui.notify(message, decoded.isNewerVersion ? "warning" : "info");
 			};
 
 			if (action === "save-apply") {
 				settings.displayUserTheme = { ...backup };
-				settings = upsertDisplayTheme(settings, decoded.name, decoded.display, "imported");
+				settings = upsertDisplayTheme(settings, resolvedName, decoded.display, "imported");
 				settings.display = { ...decoded.display };
 				saveSettings(settings);
 				if (lastContext) {
 					renderUsageWidget(lastContext, currentUsage);
 				}
-				notifyImported();
+				notifyImported(resolvedName);
 				pi.sendMessage({
 					customType: "sub-bar",
-					content: `sub-bar Theme ${decoded.name} loaded`,
+					content: `sub-bar Theme ${resolvedName} loaded`,
 					display: true,
 				});
 				return;
 			}
 
 			if (action === "save") {
-				settings = upsertDisplayTheme(settings, decoded.name, decoded.display, "imported");
+				settings = upsertDisplayTheme(settings, resolvedName, decoded.display, "imported");
 				settings.display = { ...backup };
 				saveSettings(settings);
-				notifyImported();
+				notifyImported(resolvedName);
 				if (lastContext) {
 					renderUsageWidget(lastContext, currentUsage);
 				}

package/node_modules/@marckrenn/pi-sub-core/CHANGELOG.md

@@ -0,0 +1,68 @@
+# @marckrenn/pi-sub-core
+
+## 1.0.4
+
+### Patch Changes
+
+- [#30](https://github.com/marckrenn/pi-sub/pull/30) [`af0828a`](https://github.com/marckrenn/pi-sub/commit/af0828a8d2e529497a1acff95e388a0a3eabb90e) Thanks [@marckrenn](https://github.com/marckrenn)! - Store the shared cache and lock files in the agent directory so all sub-core instances share a single cache.
+
+- [#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`
+
+- [`a6c0d33`](https://github.com/marckrenn/pi-sub/commit/a6c0d33c8d19d2876a4a8a1a0a69302a3c63f5e8) Thanks [@marckrenn](https://github.com/marckrenn)! - Move the shared cache/lock files under `~/.pi/agent/cache/sub-core` so all clients share a single cache directory.
+
+- [`7da1e08`](https://github.com/marckrenn/pi-sub/commit/7da1e082e634f4e4dee2560b4d490527d1543ade) Thanks [@marckrenn](https://github.com/marckrenn)! - Add a minimum refresh interval setting to cap refresh frequency even when refresh is triggered every turn.
+
+- [`1f5e451`](https://github.com/marckrenn/pi-sub/commit/1f5e45173b9868b0d6645ae35a084142a0ac56a5) Thanks [@marckrenn](https://github.com/marckrenn)! - Gate tool registration behind `tools.usageTool` and `tools.allUsageTool` (default off) in sub-core settings.
+
+- [`35eb185`](https://github.com/marckrenn/pi-sub/commit/35eb18590f369db4cda931b8e11099d0f3ddb4ec) Thanks [@marckrenn](https://github.com/marckrenn)! - Add usage tool aliases `get_current_usage` and `get_all_usage`.
+
+- Updated dependencies [[`7da1e08`](https://github.com/marckrenn/pi-sub/commit/7da1e082e634f4e4dee2560b4d490527d1543ade)]:
+  - @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-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-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/node_modules/@marckrenn/pi-sub-core/README.md

@@ -0,0 +1,178 @@
+# sub-core
+
+Shared usage data core for pi extensions. Sub-core owns fetching, caching, provider selection, and emits usage updates via `pi.events` for the wider `sub-*` ecosystem (UI and non-UI clients).
+
+## Overview
+
+- Fetches usage + status data from providers
+- Deduplicates requests via shared cache/lock
+- Emits updates for display-focused extensions (e.g. `sub-bar`) and non-UI tooling extensions
+- Supports Antigravity usage via auth.json (`google-antigravity`)
+
+## Installation
+
+Install via the pi package manager (recommended):
+
+```bash
+pi install npm:@marckrenn/pi-sub-core
+```
+
+Use `-l` to install into project settings instead of global:
+
+```bash
+pi install -l npm:@marckrenn/pi-sub-core
+```
+
+For a UI, also install a display extension like `sub-bar` from the same repo (see the root README for the full setup).
+
+Manual install (local development):
+
+```bash
+git clone https://github.com/marckrenn/pi-sub.git
+ln -s /path/to/pi-sub/packages/sub-core ~/.pi/agent/extensions/sub-core
+```
+
+Alternative (no symlink): add it to `~/.pi/agent/settings.json`:
+
+```json
+{
+  "extensions": ["/path/to/pi-sub/packages/sub-core/index.ts"]
+}
+```
+
+## Tool Access
+
+Tool registration is gated by `tools` in `~/.pi/agent/pi-sub-core-settings.json`.
+By default, both tools are **off**. To enable them, set:
+
+```json
+{
+  "tools": {
+    "usageTool": true,
+    "allUsageTool": true
+  }
+}
+```
+
+Then run `/reload` (tool registration only happens on load). You can also toggle these in `/sub-core:settings` → Tool Settings.
+
+When enabled, `sub-core` registers tools to expose usage snapshots to Pi:
+
+- `sub_get_usage` / `get_current_usage` – refreshes usage (forced by default) and returns `{ provider, usage }`.
+- `sub_get_all_usage` / `get_all_usage` – refreshes and returns all enabled provider entries (auto-enabled providers require credentials).
+
+## Settings
+
+Use `sub-core:settings` to configure shared provider settings plus **Usage Refresh Settings** and **Status Refresh Settings**. Provider enablement supports `auto` (default), `on`, and `off` — `auto` enables a provider only when credentials are detected.
+
+Usage refresh controls cache/usage updates, while status refresh controls incident polling (you can keep status on a slower interval). The Minimum Refresh Interval caps how often refresh triggers can fetch new data even if you refresh every turn.
+
+Antigravity usage requires an OAuth token in `~/.pi/agent/auth.json` under the `google-antigravity` key.
+
+Anthropic extra usage formatting is controlled in Provider Settings (currency symbol + decimal separator).
+
+Settings are stored in `~/.pi/agent/pi-sub-core-settings.json` (migrated from the legacy extension `settings.json` when present; the legacy file is removed after a successful migration).
+
+**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-core-settings.json`).
+
+## Cache
+
+Sub-core stores a shared cache and lock file:
+
+- `~/.pi/agent/cache/sub-core/cache.json`
+- `~/.pi/agent/cache/sub-core/cache.lock`
+
+Legacy cache files next to the extension entry or in the agent root are migrated to the cache directory and removed on first run.
+
+## Security notes
+
+- Keep `~/.pi/agent/auth.json` readable only by your user (e.g. `chmod 600 ~/.pi/agent/auth.json`).
+- Avoid logging token-bearing headers or auth config when troubleshooting provider calls.
+
+## Provider comparison
+
+| Provider | Usage Data | Status Page | Notes |
+|----------|-----------|-------------|-------|
+| Anthropic (Claude) | 5h/Week windows, extra usage | ✅ | Extra usage on/off state |
+| GitHub Copilot | Monthly quota, requests | ✅ | Request multiplier support |
+| Google Gemini | Pro/Flash quotas | ✅ | Aggregated by model family |
+| Antigravity | Model quotas | ✅ | Sandbox Cloud Code Assist quotas (tested) |
+| OpenAI Codex | Primary/secondary windows | ✅ | Credits not yet supported (PRs welcome!) |
+| AWS Kiro | Credits | - | Credits not yet supported (PRs welcome!) |
+| z.ai | Tokens/monthly limits | - | API quota limits |
+
+## 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:@marckrenn/pi-sub-core
+```
+
+Manual paths/symlinks still work for local development as documented above.
+
+### Tested providers
+
+Tested so far: Anthropic (Claude), OpenAI Codex, GitHub Copilot. Other providers are implemented but not yet verified in production.
+
+### Adding a Provider
+
+You need to update both **sub-core** (fetch layer) and **sub-bar** (display layer).
+
+### Feature placement (core vs UI)
+
+- **sub-core**: fetching, caching, provider detection/selection, status polling, tools/events, and shared settings.
+- **sub-bar**: formatting, widget layout, UI-only toggles, and display-specific behavior.
+- **sub-shared**: shared types/constants for anything referenced by both layers.
+
+See the root README “Developer guide” for the decision checklist and examples.
+
+#### sub-core (fetch + status)
+1. Add provider name to `src/types.ts` (`PROVIDERS`, `ProviderName`).
+2. Implement fetcher in `src/providers/impl/<provider>.ts`.
+3. Register provider in `src/providers/registry.ts`.
+4. Add detection + status config in `src/providers/metadata.ts`.
+5. Add provider settings defaults in `src/settings-types.ts`.
+
+#### sub-bar (display + UI)
+1. Add provider name to `src/types.ts`.
+2. Add display rules + labels in `src/providers/metadata.ts`.
+3. Add window visibility in `src/providers/windows.ts`.
+4. Add extras in `src/providers/extras.ts` (if needed).
+5. Add settings UI + defaults in `src/providers/settings.ts` and `src/settings-types.ts`.
+
+### Events (public contract)
+
+Sub-core uses `pi.events` as an in-process pub/sub bus. Any `sub-*` extension can subscribe to updates (UI or headless). Sub-core is the source of truth for provider selection and refresh behavior; clients observe state and optionally request changes.
+
+#### Broadcasts
+- `sub-core:ready` → `{ state, settings }` (first load)
+- `sub-core:update-current` → `{ state }` (cache hit or fresh fetch)
+- `sub-core:update-all` → `{ state }` (cached entries + current provider)
+- `sub-core:settings:updated` → `{ settings }`
+
+`update-current` state is `{ provider, usage }`.
+`update-all` state is `{ provider, entries }`, where entries are cached provider snapshots.
+
+#### Requests (pull current state)
+- `sub-core:request` → `{ reply, includeSettings? }`
+- `sub-core:request` → `{ type: "entries", reply, force? }` (bulk usage entries)
+
+The `reply` callback receives `{ state }` or `{ entries }` immediately if available.
+
+#### Actions (mutate core state)
+- `sub-core:settings:patch` → `{ patch }` (updates refresh interval/provider settings and persists)
+- `sub-core:action` → `{ type: "refresh" | "cycleProvider", force? }`
+
+After an action, sub-core emits `sub-core:update-current` with the new state.
+
+## Credits
+
+- Hannes Januschka ([barts](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))
+
+## Status
+
+Active. Used by `sub-bar` for display.