visualizar-rate-limit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# visualizar-r-l
+
+(banner_visualizar.png)
+
+Una CLI liviana para ver los rate limits de Codex sin salir de la terminal. Si eres de los que revisan su uso con `tmux`, `weechat` o cualquier terminal de la vieja escuela, este mini panel te da dos barras limpias y un `watch` para mantener el pulso del consumo.
+
+## Qué se ve
+
+(example.png)
+
+1. **Dos ventanas**: carga de 5h y semanal con porcentajes coloreados (verde/amarillo/rojo según urgencia).
+2. **Reset automático**: el parser extrae etiquetas como `Reset:` y muestra cuándo se renueva cada cuota.
+3. **Modo `watch`**: refresca el panel cada `45s` y usa la sesión de Chrome que ya tienes abierta para evitar bloqueos anti-bot.
+
+De momento solo funciona con `chatgpt.com/codex/settings/usage`. Próximamente integraré otras plataformas (Anthropic, Gemini, etc.) manteniendo el mismo enfoque simple y terminal-first.
+
+## Instalación
+
+### Desde npm
+
+```bash
+npm install -g visualizar-rate-limit
+```
+
+### Desde git
+
+```bash
+git clone git@github.com:NicBJ/visualizar-rate-limit.git
+cd visualizar-rate-limit
+./scripts/install.sh
+```
+
+## Flujo básico
+
+1. `visualizar-r-l login`: abre Chrome en background con DevTools remoto y deja la página de usage cargada.
+2. `visualizar-r-l`: muestra las barras una vez.
+3. `visualizar-r-l watch`: monitorea cada 45 segundos.
+
+Rodea `watch` con `VRL_REFRESH_SECONDS=15` si necesitas un refresco más agresivo.
+
+## Comandos útiles
+
+```
+visualizar-r-l login
+visualizar-r-l status
+visualizar-r-l stop
+visualizar-r-l watch
+visualizar-r-l raw
+visualizar-r-l debug
+visualizar-r-l doctor
+```
+
+`status` y `stop` controlan la sesión en background; `doctor` verifica dependencias; `debug` imprime trazas en caso de parsing extraño.
+
+## Personalización
+
+- `CHROME_BIN`: forzar un binario distinto.
+- `VRL_PROFILE_DIR`: guarda sesiones en otra carpeta.
+- `VRL_DEBUG_PORT`: cambia el puerto DevTools si 9223 está en uso.
+- `VRL_REFRESH_SECONDS`: intervalo del modo `watch`.
+
+## Próximos pasos
+
+1. Añadir soporte para Anthropic y Gemini (manteniendo extractor basado en sesión real).
+2. Agregar tests que validen el parser con HTML de ejemplo.
+3. Publicar releases en npm y crear un `CHANGELOG.md`.

package/bin/visualizar-r-l

@@ -0,0 +1,266 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+APP_NAME="visualizar-r-l"
+URL="https://chatgpt.com/codex/settings/usage"
+SCRIPT_PATH="$(readlink -f "${BASH_SOURCE[0]}")"
+SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_PATH")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+DEFAULT_STATE_ROOT="${XDG_STATE_HOME:-$HOME/.local/state}/${APP_NAME}"
+STATE_ROOT="${VRL_STATE_ROOT:-$DEFAULT_STATE_ROOT}"
+REFRESH_SECONDS="${VRL_REFRESH_SECONDS:-45}"
+DEBUG_PORT="${VRL_DEBUG_PORT:-9223}"
+
+ensure_state_root() {
+  if mkdir -p "$STATE_ROOT" 2>/dev/null; then
+    return 0
+  fi
+
+  STATE_ROOT="$SCRIPT_DIR/.state"
+  mkdir -p "$STATE_ROOT"
+}
+
+ensure_state_root
+PROFILE_DIR="${VRL_PROFILE_DIR:-$STATE_ROOT/chrome-profile}"
+PID_FILE="$STATE_ROOT/chrome.pid"
+LOG_FILE="$STATE_ROOT/chrome.log"
+mkdir -p "$PROFILE_DIR"
+
+die() {
+  printf 'Error: %s\n' "$*" >&2
+  exit 1
+}
+
+find_browser() {
+  local candidate
+  for candidate in \
+    "${CHROME_BIN:-}" \
+    google-chrome \
+    google-chrome-stable \
+    chromium-browser \
+    chromium
+  do
+    if [[ -n "$candidate" ]] && command -v "$candidate" >/dev/null 2>&1; then
+      command -v "$candidate"
+      return 0
+    fi
+  done
+
+  return 1
+}
+
+usage() {
+  cat <<'EOF'
+Uso:
+  visualizar-r-l               Muestra las dos barras una vez
+  visualizar-r-l watch         Refresca continuamente
+  visualizar-r-l login         Abre Chrome en background con perfil persistente
+  visualizar-r-l status        Muestra si la sesión en background está activa
+  visualizar-r-l stop          Cierra la sesión en background
+  visualizar-r-l doctor        Verifica dependencias y estado local
+  visualizar-r-l raw           Imprime el texto extraído de la página para depuración
+  visualizar-r-l debug         Igual que raw, pero con trazas de ejecución
+  visualizar-r-l help          Muestra esta ayuda
+
+Variables opcionales:
+  CHROME_BIN           Ruta al binario de Chrome/Chromium
+  VRL_PROFILE_DIR      Directorio de perfil persistente
+  VRL_REFRESH_SECONDS  Segundos entre refresh en modo watch
+  VRL_DEBUG_PORT       Puerto de DevTools para la sesión visible
+EOF
+}
+
+print_kv() {
+  printf '%-14s %s\n' "$1" "$2"
+}
+
+is_login_running() {
+  if [[ ! -f "$PID_FILE" ]]; then
+    return 1
+  fi
+
+  local pid
+  pid="$(cat "$PID_FILE" 2>/dev/null || true)"
+  [[ -n "$pid" ]] || return 1
+  kill -0 "$pid" 2>/dev/null
+}
+
+run_helper() {
+  local mode="$1"
+  local debug_flag="${2:-}"
+  local browser
+  browser="$(find_browser)" || die "No encontré Chrome/Chromium. Define CHROME_BIN."
+
+  CHROME_BIN="$browser" \
+  VRL_PROFILE_DIR="$PROFILE_DIR" \
+  VRL_URL="$URL" \
+  VRL_DEBUG_PORT="$DEBUG_PORT" \
+  node "$PROJECT_ROOT/src/fetch-usage.mjs" "$mode" "$debug_flag"
+}
+
+launch_login() {
+  local browser
+  browser="$(find_browser)" || die "No encontré Chrome/Chromium. Define CHROME_BIN."
+
+  if is_login_running; then
+    printf 'La sesión ya está activa en background. PID: %s\n' "$(cat "$PID_FILE")"
+    printf 'DevTools remoto: http://127.0.0.1:%s\n' "$DEBUG_PORT"
+    printf 'Si necesitas reiniciarla, usa `visualizar-r-l stop`.\n'
+    return 0
+  fi
+
+  printf 'Abriendo %s en background con perfil persistente en %s\n' "$browser" "$PROFILE_DIR"
+  printf 'DevTools remoto: http://127.0.0.1:%s\n' "$DEBUG_PORT"
+  printf 'Log: %s\n' "$LOG_FILE"
+
+  : > "$LOG_FILE"
+  setsid "$browser" \
+    --user-data-dir="$PROFILE_DIR" \
+    --remote-debugging-port="$DEBUG_PORT" \
+    --remote-allow-origins='*' \
+    --new-window \
+    "$URL" \
+    >>"$LOG_FILE" 2>&1 < /dev/null &
+
+  local pid=$!
+  echo "$pid" > "$PID_FILE"
+  sleep 1
+
+  if kill -0 "$pid" 2>/dev/null; then
+    printf 'Chrome iniciado en background. PID: %s\n' "$pid"
+    printf 'Ahora puedes ejecutar `visualizar-r-l` o `visualizar-r-l watch`.\n'
+    return 0
+  fi
+
+  rm -f "$PID_FILE"
+  die "No pude iniciar Chrome en background. Revisa $LOG_FILE"
+}
+
+show_status() {
+  if is_login_running; then
+    printf 'Sesión activa. PID: %s\n' "$(cat "$PID_FILE")"
+    printf 'DevTools remoto: http://127.0.0.1:%s\n' "$DEBUG_PORT"
+    printf 'Perfil: %s\n' "$PROFILE_DIR"
+    printf 'Log: %s\n' "$LOG_FILE"
+    return 0
+  fi
+
+  printf 'No hay una sesión activa en background.\n'
+  printf 'Ejecuta `visualizar-r-l login`.\n'
+}
+
+stop_login() {
+  if ! is_login_running; then
+    rm -f "$PID_FILE"
+    printf 'No hay una sesión activa en background.\n'
+    return 0
+  fi
+
+  local pid
+  pid="$(cat "$PID_FILE")"
+
+  if kill "$pid" 2>/dev/null; then
+    rm -f "$PID_FILE"
+    printf 'Sesión detenida. PID anterior: %s\n' "$pid"
+    return 0
+  fi
+
+  die "No pude detener el proceso $pid"
+}
+
+doctor() {
+  local browser node_bin npm_bin
+  browser="$(find_browser || true)"
+  node_bin="$(command -v node || true)"
+  npm_bin="$(command -v npm || true)"
+
+  print_kv "Proyecto" "$PROJECT_ROOT"
+  print_kv "State dir" "$STATE_ROOT"
+  print_kv "Profile dir" "$PROFILE_DIR"
+  print_kv "Browser" "${browser:-missing}"
+  print_kv "Node" "${node_bin:-missing}"
+  print_kv "npm" "${npm_bin:-missing}"
+  print_kv "DevTools" "127.0.0.1:$DEBUG_PORT"
+
+  if [[ -f "$PROJECT_ROOT/package.json" ]]; then
+    print_kv "package.json" "ok"
+  else
+    print_kv "package.json" "missing"
+  fi
+
+  if [[ -d "$PROJECT_ROOT/node_modules/puppeteer-core" ]]; then
+    print_kv "puppeteer" "ok"
+  else
+    print_kv "puppeteer" "missing"
+  fi
+
+  if is_login_running; then
+    print_kv "Session" "active (PID $(cat "$PID_FILE"))"
+  else
+    print_kv "Session" "inactive"
+  fi
+}
+
+dump_dom() {
+  run_helper raw
+}
+
+raw_text() {
+  run_helper raw
+}
+
+run_once() {
+  run_helper render
+}
+
+watch_mode() {
+  while true; do
+    clear
+    if ! run_once; then
+      exit_code=$?
+      printf '\nReintentando en %ss...\n' "$REFRESH_SECONDS" >&2
+      sleep "$REFRESH_SECONDS"
+      continue
+    fi
+    sleep "$REFRESH_SECONDS"
+  done
+}
+
+main() {
+  case "${1:-}" in
+    "" )
+      run_once
+      ;;
+    watch )
+      watch_mode
+      ;;
+    login )
+      launch_login
+      ;;
+    status )
+      show_status
+      ;;
+    stop )
+      stop_login
+      ;;
+    doctor )
+      doctor
+      ;;
+    raw )
+      raw_text
+      ;;
+    debug )
+      run_helper raw --debug
+      ;;
+    help|-h|--help )
+      usage
+      ;;
+    * )
+      usage >&2
+      exit 1
+      ;;
+  esac
+}
+
+main "$@"

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "visualizar-rate-limit",
+  "version": "0.1.0",
+  "description": "TUI para ver el rate limit de Codex desde chatgpt.com/codex/settings/usage",
+  "type": "module",
+  "bin": {
+    "visualizar-r-l": "./bin/visualizar-r-l"
+  },
+  "files": [
+    "bin",
+    "src",
+    "scripts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "chmod +x ./bin/visualizar-r-l ./src/fetch-usage.mjs ./scripts/install.sh",
+    "doctor": "node ./src/fetch-usage.mjs raw --debug",
+    "pack:dry": "npm pack --dry-run"
+  },
+  "keywords": [
+    "codex",
+    "chatgpt",
+    "tui",
+    "rate-limit",
+    "cli",
+    "puppeteer"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "puppeteer-core": "^24.40.0"
+  }
+}

package/scripts/install.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TARGET_DIR="${HOME}/.local/bin"
+TARGET="${TARGET_DIR}/visualizar-r-l"
+SOURCE="${ROOT_DIR}/bin/visualizar-r-l"
+
+mkdir -p "$TARGET_DIR"
+
+cd "$ROOT_DIR"
+npm install
+chmod +x "$SOURCE" "$ROOT_DIR/src/fetch-usage.mjs"
+ln -sf "$SOURCE" "$TARGET"
+
+printf 'Instalado: %s\n' "$TARGET"
+printf 'Prueba: visualizar-r-l doctor\n'

package/src/fetch-usage.mjs

@@ -0,0 +1,226 @@
+#!/usr/bin/env node
+
+import process from 'node:process';
+import puppeteer from 'puppeteer-core';
+
+const mode = process.argv[2] || 'render';
+const debug = process.argv.includes('--debug') || process.env.VRL_DEBUG === '1';
+const url = process.env.VRL_URL || 'https://chatgpt.com/codex/settings/usage';
+const browserPath = process.env.CHROME_BIN;
+const userDataDir = process.env.VRL_PROFILE_DIR;
+const debugPort = process.env.VRL_DEBUG_PORT || '9223';
+
+if (!browserPath) {
+  console.error('No encontré Chrome/Chromium. Define CHROME_BIN o usa el wrapper bash.');
+  process.exit(1);
+}
+
+if (!userDataDir) {
+  console.error('VRL_PROFILE_DIR no está definido.');
+  process.exit(1);
+}
+
+function logDebug(message) {
+  if (debug) console.error(`[debug] ${message}`);
+}
+
+function stripHtml(input) {
+  return input
+    .replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, ' ')
+    .replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, ' ')
+    .replace(/<svg\b[^>]*>[\s\S]*?<\/svg>/gi, ' ')
+    .replace(/<[^>]+>/g, ' ')
+    .replace(/&nbsp;/g, ' ')
+    .replace(/&amp;/g, '&')
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .replace(/&#39;/g, "'")
+    .replace(/&quot;/g, '"')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+function clamp(value, min, max) {
+  return Math.max(min, Math.min(max, value));
+}
+
+function extractPercent(segment) {
+  const percentMatch = segment.match(/(\d{1,3})\s*%/);
+  if (percentMatch) return clamp(Number(percentMatch[1]), 0, 100);
+
+  const ratioMatch = segment.match(/(\d+(?:\.\d+)?)\s*\/\s*(\d+(?:\.\d+)?)/);
+  if (ratioMatch) {
+    const used = Number(ratioMatch[1]);
+    const total = Number(ratioMatch[2]);
+    if (total > 0) return clamp(Math.round((used / total) * 100), 0, 100);
+  }
+
+  return null;
+}
+
+function extractReset(segment) {
+  const resetMatch = segment.match(/(?:reset(?:s|ting)?|renews?|refresh(?:es|ing)?)\s+(?:in|on|at)?\s*([^|]+?)(?=(?:\d{1,3}\s*%|\d+\s*\/\s*\d+|$))/i);
+  return resetMatch ? resetMatch[1].trim() : null;
+}
+
+function findWindow(text, label, patterns) {
+  for (const pattern of patterns) {
+    const match = text.match(pattern);
+    if (!match) continue;
+
+    const segment = match[0];
+    const percent = extractPercent(segment);
+    if (percent === null) continue;
+
+    return {
+      label,
+      percent,
+      reset: extractReset(segment),
+      source: segment.trim(),
+    };
+  }
+
+  return null;
+}
+
+function fallbackWindows(text) {
+  const percents = [...text.matchAll(/(\d{1,3})\s*%/g)]
+    .map((m) => clamp(Number(m[1]), 0, 100))
+    .slice(0, 2);
+
+  if (percents.length < 2) return [];
+
+  return [
+    { label: 'Ventana 1', percent: percents[0], reset: null, source: 'fallback' },
+    { label: 'Ventana 2', percent: percents[1], reset: null, source: 'fallback' },
+  ];
+}
+
+function colorize(percent, value) {
+  if (!process.stdout.isTTY) return value;
+  if (percent >= 90) return `\x1b[31m${value}\x1b[0m`;
+  if (percent >= 70) return `\x1b[33m${value}\x1b[0m`;
+  return `\x1b[32m${value}\x1b[0m`;
+}
+
+function renderBar(percent, width = 38) {
+  const filled = Math.round((percent / 100) * width);
+  const empty = Math.max(0, width - filled);
+  const bar = `${'█'.repeat(filled)}${'░'.repeat(empty)}`;
+  return colorize(percent, bar);
+}
+
+function render(text) {
+  const windows = [
+    findWindow(text, 'Ventana 5h', [
+      /(?:5\s*h|5-hour|5 hour|five hour)[\s\S]{0,180}/i,
+      /(?:hourly|hours?)[\s\S]{0,180}/i,
+    ]),
+    findWindow(text, 'Ventana semanal', [
+      /(?:weekly|week(?:ly)?|7\s*days?)[\s\S]{0,180}/i,
+    ]),
+  ].filter(Boolean);
+
+  const finalWindows = windows.length >= 2 ? windows : fallbackWindows(text);
+
+  if (finalWindows.length < 2) {
+    console.error('No pude detectar las dos ventanas de rate limit en el HTML actual.');
+    console.error('Prueba `visualizar-r-l raw` y compárteme el texto para ajustar el parser.');
+    process.exit(3);
+  }
+
+  const now = new Date().toLocaleString('es-CL', {
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hour12: false,
+  });
+
+  const header = `${'='.repeat(16)} Codex Rate Limit ${'='.repeat(16)}`;
+  console.log(header);
+  console.log(`Actualizado: ${now}`);
+  console.log('');
+
+  for (const item of finalWindows.slice(0, 2)) {
+    const bar = renderBar(item.percent);
+    const pct = colorize(item.percent, `${String(item.percent).padStart(3, ' ')}%`);
+    console.log(`${item.label.padEnd(16)} ${pct} ${bar}`);
+    if (item.reset) console.log(`Reset: ${item.reset}`);
+    console.log('');
+  }
+}
+
+let browser;
+let hardTimeout;
+
+try {
+  hardTimeout = setTimeout(() => {
+    console.error('Timeout duro alcanzado mientras intentaba extraer la página.');
+    process.exit(124);
+  }, 45000);
+
+  logDebug(`Conectando a Chrome visible en 127.0.0.1:${debugPort}`);
+  browser = await puppeteer.connect({
+    browserURL: `http://127.0.0.1:${debugPort}`,
+    defaultViewport: null,
+  });
+  logDebug('Conexión establecida');
+
+  const existingPages = await browser.pages();
+  let page = existingPages.find((candidate) => candidate.url().startsWith('https://chatgpt.com/'));
+  if (!page) {
+    page = await browser.newPage();
+  }
+
+  page.on('console', (msg) => logDebug(`console:${msg.type()}: ${msg.text()}`));
+  page.on('pageerror', (err) => logDebug(`pageerror: ${err.message}`));
+  page.on('requestfailed', (req) => logDebug(`requestfailed: ${req.url()} :: ${req.failure()?.errorText || 'unknown'}`));
+  page.on('framenavigated', (frame) => {
+    if (frame === page.mainFrame()) logDebug(`navegacion: ${frame.url()}`);
+  });
+  logDebug(`Abriendo ${url}`);
+  await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 60000 });
+  logDebug('DOM content loaded');
+  await page.waitForFunction(() => document.body && document.body.innerText.length > 50, { timeout: 30000 }).catch(() => {});
+  logDebug('Paso waitForFunction');
+  await page.waitForNetworkIdle({ idleTime: 1200, timeout: 15000 }).catch(() => {});
+  logDebug('Paso waitForNetworkIdle');
+  await new Promise((resolve) => setTimeout(resolve, 1500));
+  logDebug('Pausa final completada');
+
+  const payload = await page.evaluate(() => ({
+    href: location.href,
+    title: document.title,
+    text: document.body?.innerText || '',
+    html: document.documentElement?.outerHTML || '',
+  }));
+
+  const text = stripHtml(payload.text || payload.html);
+  logDebug(`Título detectado: ${payload.title}`);
+  logDebug(`URL detectada: ${payload.href}`);
+  logDebug(`Largo texto: ${text.length}`);
+
+  if (!text || !/codex|usage|limit|rate|chatgpt/i.test(text)) {
+    console.error('No pude extraer contenido útil desde la página. Ejecuta `visualizar-r-l login` primero.');
+    console.error(`URL actual: ${payload.href}`);
+    console.error(`Título: ${payload.title}`);
+    process.exit(2);
+  }
+
+  if (mode === 'raw') {
+    console.log(text);
+  } else {
+    render(text);
+  }
+} catch (error) {
+  console.error(error?.stack || String(error));
+  process.exit(1);
+} finally {
+  if (hardTimeout) clearTimeout(hardTimeout);
+  if (browser) {
+    await browser.disconnect();
+  }
+}