Claude Quota Guardian

Open source · Gratis · MIT

No pierdas tu trabajo ni tus tokens con Claude.

Que la tecnología trabaje para tu negocio, no al revés.

Cuando trabajas horas con Claude y la sesión se llena o se agota la cuota, el trabajo muere a mitad de camino. Guardian lo evita: guarda dónde ibas justo antes del corte y lo retoma solo, sin re-explicar nada.

CONTEXTO / CUOTA DE LA SESIÓN98.6% → checkpoint
0%límite
Detecta → Guarda checkpoint → Retoma

Usas Claude Code

Instálalo y deja de perder sesiones largas.

  • Checkpoint automático al 98.6% del límite — con aviso predictivo antes del muro.
  • Retomas gastando casi cero tokens: el checkpoint es denso y la sesión sigue sola.
  • Señal real de tu cuota Pro/Max (5h/7d), no una estimación.
  • Gratis, MIT, multi-OS (Windows/macOS/Linux).
$ guardian 
git clone https://github.com/LeonardoIAConsult/claude-quota-guardian.git
cd claude-quota-guardian
npm install
node bin/install.js
# Guardian corre solo: vigila y frena al 98.6%.
# El checkpoint y la retoma son automáticos.
# Reporte de actividad cuando quieras:
node scripts/report.js
# Desinstalación limpia — solo quita lo suyo:
node bin/uninstall.js
node bin/uninstall.js --purge  # + borra los checkpoints
Ver en GitHub → Próximamente en el directorio de plugins de Claude (comunidad)
★ ¿Te sirve? Dale una estrella

Tienes un negocio y quieres IA

Guardian es la prueba de que sé implantar IA que aguanta el trabajo real.

No tienes que entender cómo funciona por dentro. Lo que importa: si tú o tu equipo van a apoyarse en IA para trabajar, alguien tiene que hacerlo bien — que sume horas, no que las queme. Eso es lo que hago.

Te ayudo a meter la IA (y Claude) en tu flujo o el de tu equipo, con estrategia y sin humo.

Agenda tu diagnóstico →

Cómo funciona, en 3 pasos

  1. 01

    Detecta el límite

    Vigila en segundo plano cuánto contexto y cuota consume tu sesión. Al llegar al 98.6%, actúa.

  2. 02

    Guarda dónde vas

    Fuerza un checkpoint: qué construías, qué funcionó, qué no, y el próximo paso exacto.

  3. 03

    Retomas gastando casi nada

    Al reabrir, Claude lee el checkpoint y sigue solo. Cero re-explicación, mínimos tokens.

) Arquitectura [01 / 05]

Qué hace por dentro

Cada paso es un hook real de Claude Code — nada de magia, y puedes leer el código.

1

Mide, tras cada acción

En cada PostToolUse, check-usage lee el contexto de la conversación y la cuota real rate_limits (5h/7d) de tu cuenta.

2

Frena al 98.6%

Al cruzar el umbral escribe pending.json, notifica al sistema y bloquea con PreToolUse: no más tokens sobre una sesión condenada.

3

Guarda un checkpoint denso

/continuity-checkpoint escribe checkpoint-<ts>.md: qué construías, qué funcionó (con evidencia), qué no y el próximo paso exacto. Luego cierra el turno.

4

Vigila el reset

Un watcher en segundo plano (cadencia adaptativa 15→3→1 min) detecta cuándo tu cuota se reinicia y te avisa: «listo para continuar».

5

Retoma solo

Al reabrir el proyecto, SessionStart (resume-context) inyecta el checkpoint completo. El agente anuncia el próximo paso y sigue — cero re-explicación.

·

Señal real, no estimada

Usa el rate_limits account-wide que Claude Code expone — el mismo número que ve tu cuenta, no un cálculo local aproximado.

Sin relanzamiento automático: tú decides cuándo reabrir. Guardian solo se encarga del guardado y la retoma.

Todo local, en ~/.claude/session-continuity/<proyecto>/ — tu asistente los lee al reabrir:

›checkpoint-<ts>.md ›pending.json ›state.json
) Confianza [02 / 05]

El checkpoint dice cómo lo sabe

Guardian no guarda un resumen borroso. Clasifica cada tarea con la evidencia detrás — para que la próxima sesión confíe en lo verificado y no re-intente lo que ya falló.

Una línea de un checkpoint reallib/report.js · L1
reporte HTML — evidencia: lib/report.js:1 · verificación: 4 tests ✓  HECHO
HECHO

Con evidencia de implementación y verificación (test, comando o salida). No basta el plan: necesita prueba de trabajo real.

PARCIAL

Empezado, con lo que falta explícito. La próxima sesión sabe exactamente dónde seguir.

NO HECHO

TODO, test en rojo o artefacto ausente. Pendiente — no marcado como hecho por optimismo.

EN PAUSA

Tu decisión de parar + la condición para reabrir. Guardian no lo reabre solo.

) Specs [03 / 05]

Datos duros

Todo verificable en el repo. Sin promesas que el código no cumpla.

Umbral
98.6% de contexto y cuota, con aviso predictivo por ritmo de tokens/min.
Señal
rate_limits 5h/7d account-wide — el mismo número de tu cuenta, no una estimación.
Plataformas
Windows (Task Scheduler) · macOS (launchd) · Linux (systemd/cron).
Instalación
1 comando · desinstalación limpia: no toca tus hooks.
Base
Node.js · licencia MIT · 191 tests (Node 18/20, CI).
Extensible
Arquitectura de adaptadores; hoy OpenAI Codex CLI (notify-only).
Extra
Aviso de downgrade Opus→Sonnet · override «continuar bajo mi riesgo» · Telegram opcional · reporte HTML de actividad.
Privacidad
Corre local, tu código nunca sale · sin cuenta · sin telemetría.
) Casos [04 / 05]

Cuándo te salva

Sesión larga que se corta

Llevas horas construyendo y el contexto se llena a mitad de una tarea. Guardian guarda el estado exacto; retomas sin re-explicar nada.

Cuota agotándose a ciegas

El límite 5h/7d se acaba sin avisar. Guardian te frena antes de quemar tokens en una sesión que va a morir igual.

Varios proyectos a la vez

Cada proyecto tiene su checkpoint aislado (por hash de ruta). No se cruzan ni se pisan entre sí.

) Detalles [05 / 05]

Preguntas y privacidad

¿Cambia mi modelo o relanza solo?

No. Solo guarda y avisa; tú decides cuándo reabrir. El aviso de downgrade (Opus→Sonnet) es exactamente eso, un aviso — no cambia el modelo por su cuenta.

¿Funciona sin plan de pago?

Sí: monitorea el contexto de la conversación aunque no tengas plan. Con Pro/Max además lee la cuota real 5h/7d de tu cuenta.

¿Toca mi settings.json?

Mergea sus hooks sin borrar los tuyos. El desinstalador solo quita lo suyo y deja el resto intacto.

¿Y otros proveedores de IA?

Hoy incluye monitoreo notify-only de OpenAI Codex CLI (lee sus logs de sesión locales). La arquitectura de adaptadores permite sumar más.

Privacidad primero

  • Corre local en tu máquina; lee las señales que Claude Code ya expone ahí. Tu código nunca sale.
  • Sin cuenta, sin telemetría de Guardian. Es open source (MIT): puedes leer cada línea.
  • Único saliente = notificaciones de Telegram, y solo si tú las activas (el token vive en tu config local, nunca en el repo).

Guardian en uso real

Lo estoy usando en mi propio trabajo y documentando los resultados — checkpoints, cortes evitados y sesiones retomadas. Próximamente: capturas reales de su reporte de actividad.