zusage 1.0.1

package/README.md

@@ -0,0 +1,67 @@
+# Zusage
+
+A minimal CLI tool to monitor your Z.ai token usage when using a Claude Code coding plan.
+
+## Overview
+
+This tool connects to the Z.ai API to fetch and display your current token consumption, showing your usage progress within the 5-hour rolling window and the time until your next quota reset.
+
+## Features
+
+- Visual progress bar showing token usage percentage
+- Current tokens used, remaining, and total limit
+- Time remaining until next reset
+- Next reset date and time (Paris timezone)
+
+## Installation
+
+### Via npx (recommended)
+
+No installation needed - just run:
+
+```bash
+npx -y zusage@latest
+```
+
+### Or install globally
+
+```bash
+npm install -g zusage
+```
+
+## Usage
+
+Set your `ANTHROPIC_AUTH_TOKEN` environment variable (found in your browser's localStorage when logged into Z.ai):
+
+```bash
+export ANTHROPIC_AUTH_TOKEN="your_token_here"
+
+# Via npx
+npx -y zusage@latest
+
+# Or if installed globally
+zusage
+```
+
+## Example Output
+
+```
+==================================================
+  📊 Z.AI - UTILISATION DES TOKENS
+==================================================
+
+  Progression: [███████████████████████░░░░] 72%
+
+  📈 Utilisé:     145 000 tokens
+  📉 Restant:     55 000 tokens
+  🎯 Limite:      200 000 tokens
+
+  ⏱️  Reset dans:  2h 15min
+  📅 Prochain reset: lundi 11 janvier 2026 à 14:30
+
+==================================================
+```
+
+## 5-Hour Rolling Window
+
+Z.ai uses a 5-hour rolling window for token limits. This means your quota resets based on your usage over the past 5 hours, not at a fixed time. This tool shows when your next window reset will occur based on the API data.

package/bin/index.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+/**
+ * Programme simple pour afficher l'utilisation des tokens Z.ai
+ */
+
+const BASE_URL = 'https://api.z.ai';
+const AUTH_TOKEN = process.env.ANTHROPIC_AUTH_TOKEN;
+
+if (!AUTH_TOKEN) {
+  console.error('❌ Erreur: La variable d\'environnement ANTHROPIC_AUTH_TOKEN n\'est pas définie');
+  process.exit(1);
+}
+
+/**
+ * Récupère les limites de tokens depuis l'API Z.ai
+ */
+async function getTokenLimit() {
+  const response = await fetch(`${BASE_URL}/api/monitor/usage/quota/limit`, {
+    method: 'GET',
+    headers: {
+      'accept': 'application/json, text/plain, */*',
+      'origin': 'https://z.ai',
+      'authorization': `Bearer ${AUTH_TOKEN}`,
+    },
+  });
+
+  if (!response.ok) {
+    throw new Error(`HTTP error! status: ${response.status}`);
+  }
+
+  const data = await response.json();
+
+  if (!data.success) {
+    throw new Error(`API Error: ${data.msg}`);
+  }
+
+  // Trouver et retourner uniquement la partie TOKENS_LIMIT
+  const tokensLimit = data.data.limits.find(limit => limit.type === 'TOKENS_LIMIT');
+
+  if (!tokensLimit) {
+    throw new Error('TOKENS_LIMIT non trouvé dans la réponse');
+  }
+
+  return tokensLimit;
+}
+
+/**
+ * Formate un nombre avec séparateur de milliers
+ */
+function formatNumber(num) {
+  return new Intl.NumberFormat('fr-FR').format(num);
+}
+
+/**
+ * Formette un timestamp en date lisible
+ */
+function formatDate(timestamp) {
+  return new Date(timestamp).toLocaleString('fr-FR', {
+    timeZone: 'Europe/Paris',
+    dateStyle: 'full',
+    timeStyle: 'short',
+  });
+}
+
+/**
+ * Calcule le temps restant jusqu'au reset
+ */
+function getTimeRemaining(nextResetTime) {
+  const now = Date.now();
+  const remaining = nextResetTime - now;
+
+  const days = Math.floor(remaining / (1000 * 60 * 60 * 24));
+  const hours = Math.floor((remaining % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60));
+  const minutes = Math.floor((remaining % (1000 * 60 * 60)) / (1000 * 60));
+
+  if (days > 0) {
+    return `${days}j ${hours}h ${minutes}min`;
+  } else if (hours > 0) {
+    return `${hours}h ${minutes}min`;
+  } else {
+    return `${minutes}min`;
+  }
+}
+
+/**
+ * Affiche les infos de manière stylisée
+ */
+function displayTokenInfo(info) {
+  console.log('\n' + '='.repeat(50));
+  console.log('  📊 Z.AI - UTILISATION DES TOKENS');
+  console.log('='.repeat(50));
+
+  // Barre de progression visuelle
+  const barLength = 30;
+  const filled = Math.round((info.percentage / 100) * barLength);
+  const empty = barLength - filled;
+  const bar = '█'.repeat(filled) + '░'.repeat(empty);
+
+  console.log(`\n  Progression: [${bar}] ${info.percentage}%`);
+  console.log(`\n  📈 Utilisé:     ${formatNumber(info.currentValue)} tokens`);
+  console.log(`  📉 Restant:     ${formatNumber(info.remaining)} tokens`);
+  console.log(`  🎯 Limite:      ${formatNumber(info.usage)} tokens`);
+
+  const timeRemaining = getTimeRemaining(info.nextResetTime);
+  console.log(`\n  ⏱️  Reset dans:  ${timeRemaining}`);
+  console.log(`  📅 Prochain reset: ${formatDate(info.nextResetTime)}`);
+
+  console.log('\n' + '='.repeat(50) + '\n');
+}
+
+// Point d'entrée
+async function main() {
+  try {
+    const tokenInfo = await getTokenLimit();
+    displayTokenInfo(tokenInfo);
+  } catch (error) {
+    console.error('❌ Erreur:', error.message);
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "zusage",
+  "version": "1.0.1",
+  "description": "CLI tool to monitor Z.ai token usage for Claude Code coding plans",
+  "type": "module",
+  "bin": {
+    "zusage": "./bin/index.js"
+  },
+  "files": [
+    "bin/"
+  ],
+  "scripts": {
+    "test": "node bin/index.js"
+  },
+  "keywords": [
+    "zai",
+    "claude",
+    "token",
+    "usage",
+    "monitor",
+    "cli"
+  ],
+  "author": "lab34",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lab34/zusage.git"
+  },
+  "bugs": {
+    "url": "https://github.com/lab34/zusage/issues"
+  },
+  "homepage": "https://github.com/lab34/zusage#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}