antigravity-usage 0.2.0 → 0.2.2

package/README.md

@@ -1,5 +1,5 @@
 <div align="center">
-    <img src="images/icon.png" alt="antigravity-usage logo" width="150" height="150">
+    <img src="https://raw.githubusercontent.com/skainguyen1412/antigravity-usage/main/images/icon.png" alt="antigravity-usage logo" width="150" height="150">
     <h1>antigravity-usage</h1>
 </div>
 
@@ -20,7 +20,7 @@ A fast, lightweight, and powerful CLI tool to track your Antigravity model quota
 </p>
 
 <div align="center">
-    <img src="images/banner.png" alt="Antigravity Usage Screenshot">
+    <img src="https://raw.githubusercontent.com/skainguyen1412/antigravity-usage/main/images/banner.png" alt="Antigravity Usage Screenshot">
 </div>
 
 
@@ -96,6 +96,16 @@ To keep the CLI snappy and avoid hitting API rate limits:
     antigravity-usage quota --refresh
     ```
 
+### 🤖 Auto Wakeup (macOS & Linux)
+Never waste quota again. Automatically wake up your AI models to maximize your daily limits.
+- **Native Cron Integration**: Schedule-based triggers (every N hours, daily, or custom cron)
+- **Smart Quota-Reset Detection**: Zero-waste mode that detects when quota resets
+- **Multi-Account Support**: Trigger all your accounts simultaneously
+- **Built-in Safety**: Cooldown protection, retry logic, detailed history tracking
+- **Platform Support**: Currently available on **macOS and Linux** (Windows support coming soon)
+
+See the [Wakeup Command](#antigravity-usage-wakeup-) section for full details.
+
 ### 📱 Responsive UI
 Tables automatically adapt to your terminal size, switching between "Compact" and "Spacious" views to show you the most relevant data without wrapping.
 
@@ -107,11 +117,19 @@ Tables automatically adapt to your terminal size, switching between "Compact" an
 Alias for `quota`. Fetches and displays usage data.
 
 ```bash
-antigravity-usage                  # Auto-detect (Local -> Cloud)
-antigravity-usage --all            # Fetch ALL accounts
-antigravity-usage --method local   # Force local IDE connection
+antigravity-usage                   # Auto-detect (Local -> Cloud)
+antigravity-usage --all             # Fetch ALL accounts
+antigravity-usage --method local    # Force local IDE connection
 antigravity-usage --method google   # Force google IDE connection
-antigravity-usage --json           # Output JSON for scripts
+antigravity-usage --json            # Output JSON for scripts
+antigravity-usage --version         # Show version number
+```
+
+### `antigravity-usage --version`
+Display the current version of the CLI tool.
+
+```bash
+antigravity-usage --version  # or -V
 ```
 
 ### `antigravity-usage accounts`
@@ -133,6 +151,8 @@ Quickly check if your auth tokens are valid or expired.
 ### `antigravity-usage wakeup` 🚀
 **Never waste quota again.** Automatically wake up your AI models at strategic times to maximize your daily limits.
 
+> **Platform Support:** Currently available on **macOS** and **Linux**. Windows support (via Task Scheduler) is coming soon.
+
 ```bash
 antigravity-usage wakeup config     # Interactive setup (takes 30 seconds)
 antigravity-usage wakeup install    # Install to native system cron
@@ -158,12 +178,14 @@ Runs locally on your machine with zero dependencies:
 - **Interval Mode**: Every N hours (e.g., every 6 hours)
 - **Daily Mode**: At specific times (e.g., 9 AM, 5 PM)
 - **Custom Mode**: Advanced cron expressions for power users
+- **Portable Design**: Auto-detects Node.js path for seamless operation across different machines
 
 ```bash
 antigravity-usage wakeup install
-# ✅ Installs to your system's native crontab
+# ✅ Installs to your system's native crontab (macOS/Linux)
 # ✅ Runs even when terminal/antigravity is closed
 # ✅ Persists across reboots
+# ✅ Works on any machine with Node.js installed
 ```
 
 **2. Smart Quota-Reset Detection** (Zero-Waste Mode)

package/dist/index.js

@@ -4,7 +4,14 @@
 import { Command } from "commander";
 
 // src/version.ts
-var version = "0.1.0";
+import { readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+var packageJsonPath = join(__dirname, "../package.json");
+var packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+var version = packageJson.version;
 
 // src/core/logger.ts
 var debugMode = false;
@@ -52,12 +59,12 @@ var DEFAULT_CONFIG = {
 };
 
 // src/accounts/storage.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, rmSync } from "fs";
-import { join as join2 } from "path";
+import { existsSync, mkdirSync, readFileSync as readFileSync2, writeFileSync, readdirSync, rmSync } from "fs";
+import { join as join3 } from "path";
 
 // src/core/env.ts
 import { homedir, platform } from "os";
-import { join } from "path";
+import { join as join2 } from "path";
 function getPlatform() {
   const p = platform();
   if (p === "win32") return "windows";
@@ -69,26 +76,26 @@ function getConfigDir() {
   const home = homedir();
   switch (p) {
     case "windows":
-      return join(process.env.APPDATA || join(home, "AppData", "Roaming"), "antigravity-usage");
+      return join2(process.env.APPDATA || join2(home, "AppData", "Roaming"), "antigravity-usage");
     case "macos":
-      return join(home, "Library", "Application Support", "antigravity-usage");
+      return join2(home, "Library", "Application Support", "antigravity-usage");
     case "linux":
     default:
-      return join(process.env.XDG_CONFIG_HOME || join(home, ".config"), "antigravity-usage");
+      return join2(process.env.XDG_CONFIG_HOME || join2(home, ".config"), "antigravity-usage");
   }
 }
 function getTokensPath() {
-  return join(getConfigDir(), "tokens.json");
+  return join2(getConfigDir(), "tokens.json");
 }
 function getAccountsDir() {
-  return join(getConfigDir(), "accounts");
+  return join2(getConfigDir(), "accounts");
 }
 function getAccountDir(email) {
   const safeName = email.replace(/[^a-zA-Z0-9@._-]/g, "_");
-  return join(getAccountsDir(), safeName);
+  return join2(getAccountsDir(), safeName);
 }
 function getGlobalConfigPath() {
-  return join(getConfigDir(), "config.json");
+  return join2(getConfigDir(), "config.json");
 }
 
 // src/accounts/storage.ts
@@ -109,7 +116,7 @@ function ensureAccountDir(email) {
 }
 function accountExists(email) {
   const dir = getAccountDir(email);
-  return existsSync(dir) && existsSync(join2(dir, "tokens.json"));
+  return existsSync(dir) && existsSync(join3(dir, "tokens.json"));
 }
 function listAccountEmails() {
   const accountsDir = getAccountsDir();
@@ -121,7 +128,7 @@ function listAccountEmails() {
     const emails = [];
     for (const entry of entries) {
       if (entry.isDirectory()) {
-        const tokensPath = join2(accountsDir, entry.name, "tokens.json");
+        const tokensPath = join3(accountsDir, entry.name, "tokens.json");
         if (existsSync(tokensPath)) {
           emails.push(entry.name);
         }
@@ -135,18 +142,18 @@ function listAccountEmails() {
 }
 function saveAccountTokens(email, tokens) {
   ensureAccountDir(email);
-  const path = join2(getAccountDir(email), "tokens.json");
+  const path = join3(getAccountDir(email), "tokens.json");
   debug("accounts-storage", `Saving tokens for ${email}`);
   writeFileSync(path, JSON.stringify(tokens, null, 2), { mode: 384 });
 }
 function loadAccountTokens(email) {
-  const path = join2(getAccountDir(email), "tokens.json");
+  const path = join3(getAccountDir(email), "tokens.json");
   if (!existsSync(path)) {
     debug("accounts-storage", `No tokens file for ${email}`);
     return null;
   }
   try {
-    const content = readFileSync(path, "utf-8");
+    const content = readFileSync2(path, "utf-8");
     return JSON.parse(content);
   } catch (err) {
     debug("accounts-storage", `Failed to parse tokens for ${email}`, err);
@@ -155,17 +162,17 @@ function loadAccountTokens(email) {
 }
 function saveAccountMetadata(email, metadata) {
   ensureAccountDir(email);
-  const path = join2(getAccountDir(email), "metadata.json");
+  const path = join3(getAccountDir(email), "metadata.json");
   debug("accounts-storage", `Saving metadata for ${email}`);
   writeFileSync(path, JSON.stringify(metadata, null, 2), { mode: 384 });
 }
 function loadAccountMetadata(email) {
-  const path = join2(getAccountDir(email), "metadata.json");
+  const path = join3(getAccountDir(email), "metadata.json");
   if (!existsSync(path)) {
     return null;
   }
   try {
-    const content = readFileSync(path, "utf-8");
+    const content = readFileSync2(path, "utf-8");
     return JSON.parse(content);
   } catch (err) {
     debug("accounts-storage", `Failed to parse metadata for ${email}`, err);
@@ -181,17 +188,17 @@ function updateLastUsed(email) {
 }
 function saveAccountCache(email, cache) {
   ensureAccountDir(email);
-  const path = join2(getAccountDir(email), "cache.json");
+  const path = join3(getAccountDir(email), "cache.json");
   debug("accounts-storage", `Saving cache for ${email}`);
   writeFileSync(path, JSON.stringify(cache, null, 2));
 }
 function loadAccountCache(email) {
-  const path = join2(getAccountDir(email), "cache.json");
+  const path = join3(getAccountDir(email), "cache.json");
   if (!existsSync(path)) {
     return null;
   }
   try {
-    const content = readFileSync(path, "utf-8");
+    const content = readFileSync2(path, "utf-8");
     return JSON.parse(content);
   } catch (err) {
     debug("accounts-storage", `Failed to parse cache for ${email}`, err);
@@ -215,8 +222,8 @@ function deleteAccount(email) {
 }
 
 // src/accounts/config.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "fs";
-import { dirname } from "path";
+import { existsSync as existsSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "fs";
+import { dirname as dirname2 } from "path";
 function loadConfig() {
   const path = getGlobalConfigPath();
   if (!existsSync2(path)) {
@@ -224,7 +231,7 @@ function loadConfig() {
     return { ...DEFAULT_CONFIG };
   }
   try {
-    const content = readFileSync2(path, "utf-8");
+    const content = readFileSync3(path, "utf-8");
     const config = JSON.parse(content);
     return {
       ...DEFAULT_CONFIG,
@@ -241,7 +248,7 @@ function loadConfig() {
 }
 function saveConfig(config) {
   const path = getGlobalConfigPath();
-  const dir = dirname(path);
+  const dir = dirname2(path);
   if (!existsSync2(dir)) {
     mkdirSync2(dir, { recursive: true });
   }
@@ -858,13 +865,13 @@ async function refreshAccessToken(refreshToken) {
 }
 
 // src/google/storage.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3, unlinkSync } from "fs";
-import { dirname as dirname2 } from "path";
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3, unlinkSync } from "fs";
+import { dirname as dirname3 } from "path";
 function saveTokens(tokens) {
   const email = tokens.email;
   if (!email) {
     const path = getTokensPath();
-    const dir = dirname2(path);
+    const dir = dirname3(path);
     debug("storage", `Saving tokens to legacy path ${path}`);
     if (!existsSync3(dir)) {
       mkdirSync3(dir, { recursive: true });
@@ -894,7 +901,7 @@ function loadTokens() {
     return null;
   }
   try {
-    const content = readFileSync3(legacyPath, "utf-8");
+    const content = readFileSync4(legacyPath, "utf-8");
     const tokens = JSON.parse(content);
     debug("storage", "Tokens loaded successfully from legacy path");
     return tokens;
@@ -3152,14 +3159,14 @@ function getDefaultConfig() {
 }
 
 // src/wakeup/storage.ts
-import { join as join3 } from "path";
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync4, existsSync as existsSync4, mkdirSync as mkdirSync4 } from "fs";
+import { join as join4 } from "path";
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync4, existsSync as existsSync4, mkdirSync as mkdirSync4 } from "fs";
 var WAKEUP_DIR_NAME = "wakeup";
 var CONFIG_FILE_NAME = "config.json";
 var HISTORY_FILE_NAME = "history.json";
 var MAX_HISTORY_ENTRIES = 100;
 function getWakeupDir() {
-  return join3(getConfigDir(), WAKEUP_DIR_NAME);
+  return join4(getConfigDir(), WAKEUP_DIR_NAME);
 }
 function ensureWakeupDir() {
   const dir = getWakeupDir();
@@ -3169,10 +3176,10 @@ function ensureWakeupDir() {
   }
 }
 function readJsonFile(filename, defaultValue) {
-  const filepath = join3(getWakeupDir(), filename);
+  const filepath = join4(getWakeupDir(), filename);
   try {
     if (existsSync4(filepath)) {
-      const content = readFileSync4(filepath, "utf-8");
+      const content = readFileSync5(filepath, "utf-8");
       return JSON.parse(content);
     }
   } catch (err) {
@@ -3182,7 +3189,7 @@ function readJsonFile(filename, defaultValue) {
 }
 function writeJsonFile(filename, data) {
   ensureWakeupDir();
-  const filepath = join3(getWakeupDir(), filename);
+  const filepath = join4(getWakeupDir(), filename);
   try {
     writeFileSync4(filepath, JSON.stringify(data, null, 2), "utf-8");
     debug("wakeup-storage", `Wrote ${filename}`);
@@ -3419,26 +3426,46 @@ import { execSync, exec as exec3 } from "child_process";
 import { promisify as promisify3 } from "util";
 var execAsync3 = promisify3(exec3);
 var CRON_COMMENT_MARKER = "antigravity-usage-wakeup";
-function getBinaryPath() {
+function getBinDirectories() {
+  const dirs = /* @__PURE__ */ new Set();
+  try {
+    const nodePath = process.execPath;
+    const nodeDir = nodePath.substring(0, nodePath.lastIndexOf("/"));
+    if (nodeDir) {
+      dirs.add(nodeDir);
+      debug("cron-installer", `Found node bin dir: ${nodeDir}`);
+    }
+  } catch {
+    debug("cron-installer", "Could not determine node bin directory");
+  }
   try {
-    const path = execSync("which antigravity-usage", {
+    const npmBin = execSync("npm bin -g", {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     }).trim();
-    if (path) {
-      debug("cron-installer", `Found binary at: ${path}`);
-      return path;
+    if (npmBin) {
+      dirs.add(npmBin);
+      debug("cron-installer", `Found npm bin dir: ${npmBin}`);
     }
   } catch {
-    debug("cron-installer", "Could not find antigravity-usage via which");
+    debug("cron-installer", "Could not determine npm bin directory");
   }
-  if (process.argv[1]) {
-    const nodePath = process.execPath;
-    const scriptPath = process.argv[1];
-    debug("cron-installer", `Using node + script: ${nodePath} ${scriptPath}`);
-    return `${nodePath} ${scriptPath}`;
+  if (process.env.PATH) {
+    const userPaths = process.env.PATH.split(":").filter((p) => {
+      return p.includes("node") || p.includes("npm") || p.includes("nvm") || p.includes(".local") || p === "/usr/local/bin" || p === "/opt/homebrew/bin";
+    });
+    userPaths.forEach((p) => {
+      if (p) {
+        dirs.add(p);
+        debug("cron-installer", `Added user PATH: ${p}`);
+      }
+    });
   }
-  throw new Error("Could not determine binary path for cron job");
+  dirs.add("/usr/local/bin");
+  dirs.add("/usr/bin");
+  dirs.add("/bin");
+  dirs.add("/opt/homebrew/bin");
+  return Array.from(dirs);
 }
 async function loadCrontab() {
   try {
@@ -3484,14 +3511,19 @@ async function installCronJob(cronExpression) {
     };
   }
   try {
-    const binaryPath = getBinaryPath();
+    const binDirs = getBinDirectories();
+    const pathValue = binDirs.join(":");
     const lines = await loadCrontab();
     const filteredLines = removeWakeupEntries(lines);
-    const command = `${binaryPath} wakeup trigger --scheduled`;
-    const cronLine = `${cronExpression} ${command} # ${CRON_COMMENT_MARKER}`;
+    const hasPath = filteredLines.some((line) => line.startsWith("PATH="));
+    if (!hasPath) {
+      filteredLines.unshift(`PATH=${pathValue}`);
+    }
+    const cronLine = `${cronExpression} antigravity-usage wakeup trigger --scheduled # ${CRON_COMMENT_MARKER}`;
     filteredLines.push(cronLine);
     await saveCrontab(filteredLines);
     debug("cron-installer", `Installed cron job: ${cronLine}`);
+    debug("cron-installer", `Using PATH: ${pathValue}`);
     return {
       success: true,
       cronExpression
@@ -3499,11 +3531,10 @@ async function installCronJob(cronExpression) {
   } catch (err) {
     const errorMessage = err instanceof Error ? err.message : String(err);
     debug("cron-installer", `Failed to install cron job: ${errorMessage}`);
-    const binaryPath = tryGetBinaryPath();
     return {
       success: false,
       error: errorMessage,
-      manualInstructions: getManualInstructions(cronExpression, binaryPath)
+      manualInstructions: getManualInstructions(cronExpression)
     };
   }
 }
@@ -3548,21 +3579,17 @@ async function getCronStatus() {
     return { installed: false };
   }
 }
-function tryGetBinaryPath() {
-  try {
-    return getBinaryPath();
-  } catch {
-    return "antigravity-usage";
-  }
-}
-function getManualInstructions(cronExpression, binaryPath) {
+function getManualInstructions(cronExpression) {
+  const binDirs = getBinDirectories();
+  const pathValue = binDirs.join(":");
   return `
 Failed to automatically install cron job. Please add manually:
 
 1. Open terminal and run: crontab -e
 
-2. Add this line at the end:
-   ${cronExpression} ${binaryPath} wakeup trigger --scheduled # ${CRON_COMMENT_MARKER}
+2. Add these lines:
+   PATH=${pathValue}
+   ${cronExpression} antigravity-usage wakeup trigger --scheduled # ${CRON_COMMENT_MARKER}
 
 3. Save and exit the editor