agent-fuel 0.1.0 → 0.2.0

package/README.md

@@ -4,20 +4,30 @@ A sleek, unified CLI dashboard to monitor your AI coding assistant quotas, credi
 
 ---
 
-## 🚀 Quick Start
+## 🚀 Installation & Running
 
-Get **Agent Fuel** installed, globally linked, and running on your system with a single one-liner command:
+Install **Agent Fuel** globally on your system in one step:
 
 ```bash
-npm install && npm run build && npm link && agent-fuel
+npm install -g agent-fuel
 ```
 
-Once globally linked, you can run the dashboard at any time from **any directory** on your machine by simply typing:
+Once installed, you can run the dashboard at any time from **any directory** on your machine by simply typing:
 
 ```bash
 agent-fuel
 ```
 
+### Development Setup
+If you want to run or contribute to `agent-fuel` locally:
+```bash
+git clone https://github.com/jperod/agent-fuel.git
+cd agent-fuel
+npm install
+npm run build
+npm link
+```
+
 ---
 
 ## 💡 The Motivation
@@ -39,7 +49,7 @@ Because each CLI exposes quota information differently (some via strict JSON, ot
 2. **Normalizes Quota Models**: Standardizes diverse limits into a uniform percentage score (`0` to `100%`).
 3. **Renders an Elegant CLI Dashboard**: Displays a high-fidelity 3-bar ASCII progress dashboard directly in your terminal.
 
-### Proposed Architecture
+### Project Architecture
 
 ```text
 agent-fuel/
@@ -47,10 +57,9 @@ agent-fuel/
   │   ├── index.ts          # CLI entry point
   │   ├── render.ts         # Beautiful 3-bar dashboard renderer
   │   └── adapters/
-  │       ├── claude.ts     # Adapter for Claude Code (ccusage/native)
-  │       ├── codex.ts      # Adapter for Codex (local session/status)
-  │       ├── agy.ts        # Adapter for AGY (Antigravity config parser)
-  │       └── ccusage.ts    # Shared JSON parser helper
+  │       ├── claude.ts     # Adapter for Claude Code (ccusage blocks)
+  │       ├── codex.ts      # Adapter for Codex (ccusage codex session)
+  │       └── agy.ts        # Adapter for AGY (Antigravity history & model config parser)
   ├── package.json
   └── README.md
 ```
@@ -77,9 +86,9 @@ Running `agent-fuel` will immediately output a clean, colored visual summary of
 ```text
 ⚡️ Agent Fuel - CLI Quota Monitor
 
-Codex        [░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░] unknown
-Claude Code  [██████████████████████████░░░░]  86% remaining (resets 01:00 PM)
-AGY          [░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░] unknown
+Codex        [██████████████████████████████]  99% remaining (resets 01:49 PM)
+Claude Code  [█████████████████████████░░░░░]  83% remaining (resets 01:00 PM)
+AGY          [██████████████████░░░░░░░░░░░░]  60% remaining (resets 01:57 PM) [Gemini 3.5 Flash (High)]
 ```
 
 

package/dist/adapters/agy.js

@@ -23,15 +23,10 @@ export class AgyQuotaAdapter {
             catch {
                 // Fallback to default model name if reading or parsing settings failed
             }
-            // 2. Read history.jsonl to detect active prompts today
+            // 2. Read history.jsonl to detect active prompts within the rolling 5-hour window
             let todayPromptsCount = 0;
             let latestPromptTimestamp = null;
-            // Construct local todayPrefix in YYYY-MM-DD format (timezone aware)
-            const now = new Date();
-            const year = now.getFullYear();
-            const month = String(now.getMonth() + 1).padStart(2, '0');
-            const day = String(now.getDate()).padStart(2, '0');
-            const todayPrefix = `${year}-${month}-${day}`;
+            const fiveHoursAgo = Date.now() - 5 * 60 * 60 * 1000;
             try {
                 const historyContent = await fs.readFile(historyPath, 'utf-8');
                 const historyLines = historyContent.trim().split('\n');
@@ -40,13 +35,8 @@ export class AgyQuotaAdapter {
                         continue;
                     const entry = JSON.parse(line);
                     if (entry && entry.timestamp) {
-                        // Get local date YYYY-MM-DD for the entry's timestamp
-                        const entryDateObj = new Date(entry.timestamp);
-                        const eYear = entryDateObj.getFullYear();
-                        const eMonth = String(entryDateObj.getMonth() + 1).padStart(2, '0');
-                        const eDay = String(entryDateObj.getDate()).padStart(2, '0');
-                        const entryDate = `${eYear}-${eMonth}-${eDay}`;
-                        if (entryDate === todayPrefix) {
+                        // Check if the prompt falls within the 5-hour rolling window
+                        if (entry.timestamp >= fiveHoursAgo) {
                             todayPromptsCount++;
                             if (!latestPromptTimestamp || entry.timestamp > latestPromptTimestamp) {
                                 latestPromptTimestamp = entry.timestamp;
@@ -62,9 +52,15 @@ export class AgyQuotaAdapter {
             // Support dynamic overrides using AGENT_FUEL_AGY_PERCENT environment variable
             let remainingPercent = 100;
             const isProModel = activeModel.toLowerCase().includes('pro');
-            const limit = isProModel ? 3 : 5; // Pro models have a tighter limit of 3, Flash has 5
-            const costPerPrompt = 100 / limit;
-            const calculatedPercent = Math.max(0, Math.round(100 - (todayPromptsCount * costPerPrompt)));
+            let calculatedPercent = 100;
+            if (isProModel) {
+                // Pro models: limit is 10 prompts, steps of 2 prompts (each step is 20%)
+                calculatedPercent = Math.max(0, 100 - (Math.floor(todayPromptsCount / 2) * 20));
+            }
+            else {
+                // Flash models: limit is 25 prompts, steps of 5 prompts (each step is 20%)
+                calculatedPercent = Math.max(0, 100 - (Math.floor(todayPromptsCount / 5) * 20));
+            }
             if (process.env.AGENT_FUEL_AGY_PERCENT) {
                 const envVal = Number(process.env.AGENT_FUEL_AGY_PERCENT);
                 remainingPercent = !isNaN(envVal) ? Math.max(0, Math.min(100, envVal)) : calculatedPercent;

package/dist/render.js

@@ -1,3 +1,6 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 export function renderDashboard(snapshots) {
     const reset = '\x1b[0m';
     const bold = '\x1b[1m';
@@ -7,6 +10,16 @@ export function renderDashboard(snapshots) {
     const yellow = '\x1b[33m';
     const red = '\x1b[31m';
     const gray = '\x1b[90m';
+    // Load version from package.json dynamically
+    let versionStr = '';
+    try {
+        const __dirname = path.dirname(fileURLToPath(import.meta.url));
+        const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, '../package.json'), 'utf8'));
+        versionStr = ` v${packageJson.version}`;
+    }
+    catch {
+        // Fallback if reading package.json fails
+    }
     console.log(`\n${bold}${cyan}⚡️ Agent Fuel - CLI Quota Monitor${reset}\n`);
     for (const snap of snapshots) {
         const displayName = getDisplayName(snap.tool);
@@ -45,7 +58,7 @@ export function renderDashboard(snapshots) {
         }
         console.log(`${bold}${displayName.padEnd(12)}${reset} [${barStr}] ${percentStr}${detailStr}`);
     }
-    console.log('');
+    console.log(`\n${dim}${gray}agent-fuel${versionStr}${reset}\n`);
 }
 function getDisplayName(tool) {
     switch (tool) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-fuel",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Sleek term-based dashboard for AI coding CLI quotas",
   "type": "module",
   "main": "dist/index.js",