@thisisayande/tokentracker 0.1.5

package/README.md

@@ -0,0 +1,99 @@
+# TokenTracker
+
+TokenTracker is a cross-platform desktop application that monitors AI provider quotas, rate limits, and spend statistics in real-time.
+
+| | |
+|:---:|:---:|
+| <img src="/public/logos/image.png" width="290"> | <img src="/public/logos/image%20copy.png" width="290"> |
+
+## Features
+
+- **Multi-Provider Support** — Monitor Anthropic, OpenAI, OpenRouter, Groq, Ollama, and more
+- **Real-Time Quota Tracking** — Live usage and rate limit data with configurable polling
+- **Cost Analytics** — Per-provider and aggregate spend breakdowns with model-level detail
+- **Secure Credential Storage** — API keys and browser cookie import
+- **Browser Profile Import** — Pull authentication cookies from Chrome, Firefox, and Edge profiles
+- **Dark / Light Themes** — macOS-inspired glassmorphic UI with smooth transitions
+- **System Tray** — Runs quietly in the background; click to show/hide
+- **Cross-Platform** — Linux, Windows, and macOS via Tauri 2
+
+## Tech Stack
+
+- **Frontend** — Next.js 16 (App Router), React 19, TypeScript, Tailwind CSS 4
+- **Backend** — Rust (Axum HTTP API server running as a bundled subprocess)
+- **Desktop Runtime** — Tauri 2 (system tray, window management, process lifecycle)
+
+## Architecture
+
+```
+Frontend (Tauri/Next.js)
+  → HTTP (localhost) → Rust Backend (Axum API, port 46727)
+  → useProviders hook manages all state
+  → mapProviderUsage / mapProviderCost transform raw JSON → typed objects
+```
+
+### Key Files
+
+| Path | Purpose |
+|------|---------|
+| `backend/src/main.rs` | Rust HTTP server entry point (Axum router) |
+| `backend/src/server/` | Request handlers for all API endpoints |
+| `src-tauri/src/lib.rs` | Tauri app lifecycle, tray icon, window management |
+| `src-tauri/src/backend.rs` | Backend process spawning, health check, lifecycle |
+| `src/lib/apiClient.ts` | Frontend HTTP client (fetches port dynamically from Tauri) |
+| `src/hooks/useProviders.ts` | Central hook owning all provider/cost/settings state |
+| `src/lib/dataMapping.ts` | Raw JSON → typed object transformers + provider descriptors |
+
+## Getting Started
+
+### Prerequisites
+
+- [Rust](https://rustup.rs/) (latest stable)
+- [Node.js](https://nodejs.org/) 20+
+
+### Development
+
+```bash
+# Install frontend dependencies
+npm install
+
+# Run the full Tauri app (frontend + bundled backend, hot-reload)
+npm run tauri:dev
+```
+
+The backend HTTP server starts automatically. The frontend connects via a port dynamically reported by Tauri (default `46727`).
+
+### Production Build
+
+```bash
+npm run tauri:build
+```
+
+Outputs native installers for your platform (AppImage, `.deb`, `.msi`, etc.).
+
+### Running Tests
+
+```bash
+# Terminal 1 — start the dev server
+npm run dev
+
+# Terminal 2 — run smoke tests
+npm run test:smoke
+```
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `TOKEN_TRACKER_BACKEND_PORT` | `46727` | Port for the bundled Rust backend HTTP server |
+
+## Local Caching
+
+Usage and cost data is cached locally for offline reading and fast startup:
+
+- **Linux** — `~/.config/CodexBar/cache.json`
+- **Windows** — `%USERPROFILE%\.config\CodexBar\cache.json`
+
+## License
+
+MIT

package/bin/tokentracker.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+import https from "https";
+import http from "http";
+import fs from "fs";
+import path from "path";
+import { spawn } from "child_process";
+import os from "os";
+
+const REPO = "ayan-de/Token-Tracker";
+const OWNER = "ayan-de";
+const APP_NAME = "TokenTracker";
+
+function getAssetUrl(version, filename) {
+  return `https://github.com/${OWNER}/${REPO}/releases/download/v${version}/${filename}`;
+}
+
+function getLatestVersion() {
+  return new Promise((resolve, reject) => {
+    const req = https.get(
+      `https://api.github.com/repos/${REPO}/releases/latest`,
+      { headers: { "User-Agent": "tokentracker-npm" } },
+      (res) => {
+        let data = "";
+        res.on("data", (chunk) => (data += chunk));
+        res.on("end", () => {
+          try {
+            const json = JSON.parse(data);
+            resolve(json.tag_name.replace("v", ""));
+          } catch {
+            reject(new Error("Failed to parse GitHub API response"));
+          }
+        });
+      }
+    );
+    req.on("error", reject);
+    req.setTimeout(10000, () => {
+      req.destroy();
+      reject(new Error("Timeout reaching GitHub API"));
+    });
+  });
+}
+
+function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest);
+    const protocol = url.startsWith("https") ? https : http;
+    const req = protocol.get(url, { headers: { "User-Agent": "tokentracker-npm" } }, (res) => {
+      if (res.statusCode === 302 || res.statusCode === 301) {
+        file.close();
+        downloadFile(res.headers.location, dest).then(resolve).catch(reject);
+        return;
+      }
+      if (res.statusCode !== 200) {
+        file.close();
+        reject(new Error(`HTTP ${res.statusCode}`));
+        return;
+      }
+      res.pipe(file);
+      file.on("finish", () => file.close(resolve));
+    });
+    req.on("error", (err) => {
+      file.close();
+      reject(err);
+    });
+    req.setTimeout(60000, () => {
+      req.destroy();
+      reject(new Error("Download timeout"));
+    });
+  });
+}
+
+async function ensureInstalled(version) {
+  const platform = os.platform();
+  if (platform !== "linux") {
+    console.error("TokenTracker npm install only supports Linux currently.");
+    console.error("Download from: https://github.com/ayan-de/Token-Tracker/releases");
+    process.exit(1);
+  }
+
+  const arch = os.arch() === "x64" ? "amd64" : os.arch();
+  const filename = `TokenTracker_${version}_${arch}.deb`;
+  const url = getAssetUrl(version, filename);
+  const tmpDir = path.join(os.tmpdir(), "tokentracker-install");
+  const debPath = path.join(tmpDir, filename);
+
+  if (!fs.existsSync(tmpDir)) fs.mkdirSync(tmpDir, { recursive: true });
+
+  if (!fs.existsSync(debPath)) {
+    console.log(`Downloading TokenTracker v${version}...`);
+    await downloadFile(url, debPath);
+  }
+
+  return debPath;
+}
+
+async function installAndRun() {
+  try {
+    const version = process.env.TOKEN_TRACKER_VERSION || await getLatestVersion();
+    const debPath = await ensureInstalled(version);
+
+    console.log(`Installing TokenTracker v${version}...`);
+    const dpkg = spawn("sudo", ["dpkg", "-i", debPath], { stdio: "inherit" });
+    dpkg.on("close", (code) => {
+      if (code === 0) {
+        console.log("TokenTracker installed successfully!");
+        console.log('Run "tokentracker" to start.');
+      } else {
+        console.error("Installation failed. Try running with sudo.");
+      }
+    });
+  } catch (err) {
+    console.error("Error:", err.message);
+    console.error("\nDownload manually: https://github.com/ayan-de/Token-Tracker/releases");
+    process.exit(1);
+  }
+}
+
+const args = process.argv.slice(2);
+
+if (args.includes("--install") || args.includes("-i")) {
+  installAndRun();
+} else {
+  // Direct execution path
+  const tokentrackerBin = "/usr/lib/TokenTracker/_up_/target/release/backend";
+  const tauriBin = "/usr/bin/tokentracker";
+
+  let binPath = null;
+  if (fs.existsSync(tauriBin)) binPath = tauriBin;
+  else if (fs.existsSync(tokentrackerBin)) binPath = tokentrackerBin;
+
+  if (!binPath) {
+    console.log("TokenTracker not found. Installing...");
+    installAndRun();
+    return;
+  }
+
+  // Spawn the actual app
+  const child = spawn(binPath, [], {
+    stdio: "inherit",
+    env: { ...process.env },
+  });
+  child.on("close", (code) => process.exit(code));
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@thisisayande/tokentracker",
+  "version": "0.1.5",
+  "private": false,
+  "type": "module",
+  "description": "AI Provider Quota Monitor - track usage, rate limits, and spend across 40+ LLM providers",
+  "bin": {
+    "tokentracker": "./bin/tokentracker.js"
+  },
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "tauri": "tauri",
+    "tauri:dev": "tauri dev",
+    "tauri:build": "next build && tauri build",
+    "test:smoke": "playwright test",
+    "test:smoke:ui": "playwright test --ui",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "files": [
+    "bin/",
+    "dist/"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.61.1",
+    "@tailwindcss/postcss": "^4.3.1",
+    "@tauri-apps/cli": "^2",
+    "@types/node": "^26.0.0",
+    "@types/react": "^19.2.17",
+    "autoprefixer": "^10.5.0",
+    "postcss": "^8.5.15",
+    "tailwindcss": "^4.3.1",
+    "typescript": "^6.0.3"
+  },
+  "dependencies": {
+    "@tauri-apps/api": "^2.11.1",
+    "lucide-react": "^1.21.0",
+    "next": "^16.2.9",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7"
+  }
+}