Empezar con capsul: instalar, primera ejecución, primeras cifras

1. Instalar

$npm i -g @penra/capsul

2. Comprobar el entorno

doctor informa de qué CLI de agente detecta, qué credenciales están configuradas y dónde se guardan las cosas. Te enseña dónde viven sin enseñar nunca qué son.

$capsul doctor

Si tu CLI de agente no aparece detectada aquí, nada más funcionará. Resuelve este paso antes de seguir.

3. Construir un contexto sin gastar nada

Este es el comando que conviene ejecutar primero, sobre una tarea que tengas de verdad. Monta el contexto e informa de lo que cuesta, sin llamar a ningún modelo y sin tocar tu cuota.

$capsul context 'por qué el redirect de login entra en bucle'

Añade --json para una salida legible por máquina, y --open cuando ya sepas qué archivo importa:

$capsul context 'arregla el bucle de redirect' --open src/middleware.ts --json

4. Lanzar la tarea

ask hace el mismo montaje y luego entrega la petición a la CLI de agente en la que has iniciado sesión. Responde tu suscripción de Claude o ChatGPT existente: ninguna clave de API que pegar, ninguna segunda factura de modelo.

$capsul ask 'arregla el bucle de redirect' --budget 3000

Ejecutar capsul sin subcomando abre en cambio una sesión interactiva, donde eliges el agente y conversas.

$capsul

Después

• →capsul stats acumula los tokens ahorrados con el tiempo. El registro es un archivo llano en tu propio disco.
• →capsul burn desglosa el gasto local por agente, modelo y proyecto.
• →--model haiku para el trabajo mecánico: renombrados, formato, ediciones de un solo archivo.
• →--budget <n> pone un techo duro al contexto. Nada se desborda en silencio.