@robhowley/pi-openrouter 0.6.0 → 0.7.0

package/README.md

@@ -21,7 +21,7 @@ export OPENROUTER_MANAGEMENT_KEY=sk-or-...
 
 ## Usage
 
-Type `/openrouter-usage` in Pi to open the usage overlay.
+Type `/openrouter usage` in Pi to open the usage overlay.
 
 The overlay shows:
 - **Month spend** vs cap with percentage
@@ -37,7 +37,7 @@ The extension refreshes data in the background every 30 seconds (with exponentia
 
 ## Account health
 
-Type `/openrouter-account` in Pi to open the account health overlay.
+Type `/openrouter account` in Pi to open the account health overlay.
 
 The overlay shows:
 
@@ -56,25 +56,17 @@ Select a key from the list to inspect its limit, usage, reset cadence, and BYOK
 
 ## Session tracking
 
-`pi-openrouter` automatically tags OpenRouter requests with `session_id` field set to the Pi session's ID.
+`pi-openrouter` automatically tags OpenRouter requests with a `session_id` derived from the Pi session ID.
 
-View the Pi session ID with
+View the OpenRouter session tag with:
 
 ```bash
-/session  # [uuid]
-```
-
-The session can be tracked in OpenRouter's logs under the following ID:
-
-```bash
-/openrouter-session
+/openrouter session
 
 # OpenRouter session_id
 pi:[uuid]
 ```
 
-This enables session-level tracking in the OpenRouter Logs → Sessions page.
-
 ## License
 
 MIT

package/extensions/openrouter/__tests__/format.test.ts

@@ -43,8 +43,10 @@ describe('aggregateUsage', () => {
       totalCredits: 100,
     };
     // Use a date that's within the last 7 days of when the test runs.
-    // We use a date from the past month that's been long enough to survive timezone offsets.
-    const date = '2026-05-01';
+    // Get today's date in UTC and subtract a few days to ensure it's in the week window.
+    const now = new Date();
+    const testDate = new Date(now.getTime() - 3 * 24 * 60 * 60 * 1000); // 3 days ago
+    const date = `${testDate.getUTCFullYear()}-${String(testDate.getUTCMonth() + 1).padStart(2, '0')}-${String(testDate.getUTCDate()).padStart(2, '0')}`;
     const analytics: ActivityItem[] = [
       {
         date: date,
@@ -77,9 +79,9 @@ describe('aggregateUsage', () => {
     const result = aggregateUsage(credits, analytics);
 
     expect(result.month).toBe(38.42);
-    // Data from May 1 should be in the week (but may not be in "today" depending on timezone)
+    // Data from the test date should be in the week (7 days ago window)
     expect(result.week).toBeGreaterThan(0);
-    // Today's data might not be from May 1 due to timezone, so just check month
+    // Today's data might not be from the test date due to timezone, so just check month
   });
 
   it('should calculate burn rate correctly', () => {

package/extensions/openrouter/account-overlay.ts

@@ -173,15 +173,21 @@ export class AccountOverlayComponent {
     return Math.max(MIN_WIDTH, this.keyInfo && this.keyInfo.length > 0 ? 55 : 50);
   }
 
+  /** Get the header row for the account overlay */
+  private getAccountHeaderRow(): string {
+    return row(
+      this.theme.fg('accent', this.theme.bold(' ◈ OpenRouter Account  ·  /openrouter account')),
+      this.width,
+    );
+  }
+
   private buildLines(): string[] {
     const th = this.theme;
     const lines: string[] = [];
 
     if (this.error) {
       lines.push(boxTop(this.width));
-      lines.push(
-        row(th.fg('accent', th.bold(' ◈ OpenRouter Account  ·  /openrouter-account')), this.width),
-      );
+      lines.push(this.getAccountHeaderRow());
       lines.push(emptyRow(this.width));
       lines.push(row(th.fg('error', this.error), this.width));
       lines.push(boxBottom(this.width));
@@ -190,9 +196,7 @@ export class AccountOverlayComponent {
     }
 
     lines.push(boxTop(this.width));
-    lines.push(
-      row(th.fg('accent', th.bold(' ◈ OpenRouter Account  ·  /openrouter-account')), this.width),
-    );
+    lines.push(this.getAccountHeaderRow());
     lines.push(emptyRow(this.width));
 
     // Total spend line (sum of all key spends)

package/extensions/openrouter/index.ts

@@ -180,6 +180,46 @@ export default function (pi: ExtensionAPI) {
       await showAccountOverlay(ctx);
     },
   });
+
+  // Single entry point with subcommands: /openrouter [usage|account|session]
+  pi.registerCommand('openrouter', {
+    description: 'OpenRouter commands: usage, account, session',
+    getArgumentCompletions: (prefix: string) => {
+      const subcommands = ['usage', 'account', 'session'];
+      const items = subcommands
+        .filter((s) => s.startsWith(prefix))
+        .map((s) => ({ value: s, label: s }));
+      return items.length > 0 ? items : null;
+    },
+    handler: async (args, ctx) => {
+      const subcommand = args.trim().split(/\s+/)[0] || '';
+
+      switch (subcommand) {
+        case 'usage': {
+          startBackgroundRefresh();
+          await showUsageOverlay(ctx, undefined);
+          break;
+        }
+        case 'account': {
+          await showAccountOverlay(ctx);
+          break;
+        }
+        case 'session': {
+          ctx.ui.notify(`OpenRouter session_id\n${getCurrentSessionId(ctx)}`, 'info');
+          break;
+        }
+        default: {
+          const available = ['usage', 'account', 'session'];
+          const message =
+            available.length > 0
+              ? `Available subcommands: ${available.join(', ')}${available.length > 1 ? '' : ''}`
+              : 'No subcommands available';
+          ctx.ui.notify(`OpenRouter subcommands\n${message}`, 'error');
+          break;
+        }
+      }
+    },
+  });
 }
 
 async function showAccountOverlay(ctx: ExtensionContext) {

package/extensions/openrouter/overlay.ts

@@ -118,6 +118,14 @@ export class UsageOverlayComponent {
     return Math.max(MIN_WIDTH, innerWidth + 4) + 6; // +4 for borders, +6 for visual padding (3 on each side)
   }
 
+  /** Get the header row for the usage overlay */
+  private getUsageHeaderRow(): string {
+    return row(
+      this.theme.fg('accent', this.theme.bold(' ◈ OpenRouter Usage  ·  /openrouter usage')),
+      this.width,
+    );
+  }
+
   private buildLines(
     summary: UsageSummary | null,
     error: string | null,
@@ -128,9 +136,7 @@ export class UsageOverlayComponent {
 
     if (error) {
       lines.push(boxTop(this.width));
-      lines.push(
-        row(th.fg('accent', th.bold(' ◈ OpenRouter Usage  ·  /openrouter-usage')), this.width),
-      );
+      lines.push(this.getUsageHeaderRow());
       lines.push(emptyRow(this.width));
       lines.push(row(th.fg('error', error), this.width));
       if (cachedMinutesAgo !== null) {
@@ -145,9 +151,7 @@ export class UsageOverlayComponent {
 
     if (!summary) {
       lines.push(boxTop(this.width));
-      lines.push(
-        row(th.fg('accent', th.bold(' ◈ OpenRouter Usage  ·  /openrouter-usage')), this.width),
-      );
+      lines.push(this.getUsageHeaderRow());
       lines.push(emptyRow(this.width));
       lines.push(row(th.fg('dim', 'No usage data available.'), this.width));
       lines.push(boxBottom(this.width));
@@ -157,9 +161,7 @@ export class UsageOverlayComponent {
 
     // Summary view (subcommand views TODO)
     lines.push(boxTop(this.width));
-    lines.push(
-      row(th.fg('accent', th.bold(' ◈ OpenRouter Usage  ·  /openrouter-usage')), this.width),
-    );
+    lines.push(this.getUsageHeaderRow());
     lines.push(emptyRow(this.width));
 
     // Month row: amount stays with label, cap percentage right-aligned

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robhowley/pi-openrouter",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "description": "Live OpenRouter TUI overlays for spend, credits, key limits, burn rate, model usage, and session tagging.",
   "license": "MIT",
@@ -27,7 +27,7 @@
     "url": "https://github.com/robhowley/pi-userland.git",
     "directory": "packages/pi-openrouter"
   },
-  "homepage": "https://github.com/robhowley/pi-userland/tree/main/packages/pi-openrouter",
+  "homepage": "https://pi-userland.dev",
   "scripts": {
     "lint": "eslint extensions/",
     "format:check": "prettier --check extensions/",