Primeros pasos

Qué necesitas

• Node 24 o más nuevo.
• npm, que viene con Node.

Todo corre localmente. No se crea ninguna cuenta, no se requiere ninguna clave para empezar, y ninguna solicitud sale de tu máquina durante ninguno de los pasos de abajo.

Instala OpenLimiter

Instala la herramienta de línea de comandos de forma global y luego corre su demo sintética.

npm install -g openlimiter
openlimiter demo

openlimiter demo renderiza datos sintéticos. Demuestra que el binario funciona sin tocar ninguna cuenta real, y cada número que imprime está inventado.

Dale algo que medir

OpenLimiter nunca contacta a un proveedor en este release. Analiza datos que algo más ya puso frente a él. Hasta que una de las rutas de ingesta corra, cada orden honestamente reporta unknown.

La ruta que no necesita trabajo extra es el statusline de Claude Code. Claude Code corre tu comando de statusline en cada render y escribe un objeto JSON que describe la sesión actual en la entrada estándar de ese comando. Cuando ese objeto lleva un bloque de límite de tasa, OpenLimiter lo valida, lo guarda en caché y renderiza los números frescos en la misma llamada.

openlimiter statusline < session.json
OpenLimiter NEAR_CAP NONE UNKNOWN OPENROUTER,CODEX,ANTIGRAVITY,OPENCODE,MANUAL  CLAUDE ####. 87.5%

No todas las versiones de Claude Code envían campos de límite de tasa. Si la tuya no lo hace, esta ruta se queda en silencio y las dos rutas manuales siguen funcionando. La página de ingesta cubre las tres.

Conecta Claude Code

Agrega esto a tu settings.json de Claude Code. La instalación global hace disponible la orden openlimiter para Claude Code.

{
  "statusLine": {
    "type": "command",
    "command": "openlimiter statusline"
  },
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "openlimiter hook"
          }
        ]
      }
    ]
  }
}

Contribuye desde el código fuente

Usa las herramientas del repositorio cuando quieras contribuir.

git clone https://github.com/lucaswebsystems/openlimiter
cd openlimiter
pnpm install
pnpm build
pnpm typecheck
pnpm test
node packages/cli/dist/bin.js demo

La compilación tiene que correr antes de la revisión de tipos, porque cada paquete resuelve a sus vecinos a través de los archivos de declaración que produce la compilación.

Qué sigue

Un orden de lectura razonable

1. 1Por qué OpenLimiter para el problema que esto resuelve.
2. 2Proveedores compatibles para qué lee cada connector y qué tan frágil es.
3. 3Agent context para exactamente lo que llega a tu agente.
4. 4Referencia de la CLI para cada orden y código de salida.