Paneflow muestra cuánto has usado de tus suscripciones de Claude Code y Codex, para cada cuenta de tu máquina: una cápsula en el pie de la barra lateral, una burbuja con el detalle de cada cuenta y una página **Usage** en Settings con un año de actividad diaria. Paneflow nunca lee tus credenciales ni tus tokens y nunca llama por sí mismo a una API de uso. ## Cuentas [#accounts] Una cuenta es un agente más un directorio de configuración. Paneflow lista los directorios por defecto `~/.claude` y `~/.codex`, cada espacio que define `CLAUDE_CONFIG_DIR` o `CODEX_HOME` en su entorno y cada perfil de agente que lo hace. Dos espacios que apuntan al mismo directorio comparten una sola cuenta. Una cuenta facturada mediante una clave de API (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`) no tiene límites de plan, y así lo indica. ## La cápsula de la barra lateral [#the-sidebar-capsule] La cápsula está entre el filtro y el botón Settings. Su anillo y su porcentaje muestran el límite más restrictivo de las cuentas del espacio activo, o de las cuentas por defecto cuando el espacio no define ninguna. El anillo toma el color de acento por debajo del 80 %, ámbar desde el 80 % y rojo desde el 95 %. Pasa el cursor por encima para ver la cuenta y la ventana que describe. Haz clic en la cápsula, o pulsa Enter o Space sobre ella, para abrir la burbuja. Cada cuenta muestra sus ventanas de sesión y semanal con un medidor, la hora de reinicio en el tooltip del medidor y una línea de ritmo para la semana: o bien el momento en que alcanzarás el límite semanal a tu ritmo actual, o bien la parte de la semana que habrás usado cuando se reinicie. **Open usage settings**, abajo del todo, abre la página Usage. Para ocultar la cápsula, desactiva **Usage** en **Customize sidebar › Show** o pon `sidebar_show.usage` en `false`. Sin ninguna cuenta de Claude Code o Codex, la cápsula no aparece. ## La página Usage [#the-usage-page] **Settings › Usage** muestra una tarjeta por cuenta con dos anillos (la semana por fuera y la sesión por dentro), las horas de reinicio y la línea de ritmo. **Refresh** pide a cada cuenta sus límites actuales. En **Activity by agent**, cada cuenta con actividad en las últimas 53 semanas recibe un registro de una celda por día. Cambia la métrica entre **Turns**, **Tokens** (entrada y salida, sin caché) y **Active time**. Todos los registros comparten una escala, así que una celda más oscura significa más actividad sea cual sea el agente. Pasa el cursor por un día, o recorre los días con las flechas tras entrar en un registro con Tab, para leer el recuento de cada agente ese día. Paneflow cuenta esta actividad por sí mismo, a partir de los agentes que se ejecutan en sus paneles en esta máquina. No sabe nada de las sesiones ejecutadas en otro lugar. ### Importar la actividad pasada [#import-past-activity] La primera vez que Paneflow arranca con el historial de actividad vacío, lee en segundo plano tus transcripciones existentes de Claude Code (`projects/**/*.jsonl` en cada directorio de configuración de Claude) y los archivos de sesión de Codex, y completa los días que todavía no cuenta. **Import past activity**, al pie de la página, vuelve a ejecutar la importación. Importar dos veces nunca cuenta un día dos veces, y el día de hoy siempre queda para el recuento en vivo. La importación lee primero los archivos más recientes y se detiene tras 10.000 archivos o 2 GB. Cuando se detiene antes de terminar, la página muestra **Imported the last \{n\} days**. Claude Code conserva las transcripciones 30 días por defecto (`cleanupPeriodDays` en su configuración), así que los días anteriores quedan vacíos. ## De dónde salen los límites [#where-the-limits-come-from] Paneflow lee los límites solo de los propios programas de los agentes, con tu propia sesión iniciada: - **Línea de estado de Claude Code.** Cuando instalas la integración de Claude Code y no tienes una línea de estado (status line) propia, Paneflow pone `statusLine` de la configuración de Claude en `paneflow-ai-hook StatusLine`. Tras cada respuesta, Claude Code le pasa los límites que reporta y Paneflow los reenvía a la cápsula. El comando no imprime nada, así que tu línea de estado queda vacía. - **Los binarios instalados de Claude Code y Codex.** Cuando abres la burbuja o actualizas la página Usage, Paneflow pide su uso al `claude` instalado, sin enviar ningún mensaje, y pide sus límites de tasa a `codex app-server`. Cada cuenta se consulta como máximo una vez cada 30 segundos. - **Archivos de sesión de Codex.** Tras cada turno de Codex, Paneflow lee los límites que Codex escribió en su archivo de sesión más reciente. Gana la lectura más reciente de cada cuenta. ### Si tienes tu propia línea de estado [#if-you-have-your-own-status-line] Paneflow nunca cambia una línea de estado que hayas configurado. En su lugar, lee tus límites del binario instalado de Claude Code, así que la cápsula funciona igual. Hasta que esa lectura tenga éxito, la cuenta muestra: "Claude Code has not reported plan limits for \{folder\} yet. Check that it is installed and signed in for this folder, then reopen this panel." ## Qué guarda Paneflow [#what-paneflow-stores] Todo queda en la carpeta `usage` del home de Paneflow (`~/.paneflow`, `%USERPROFILE%\.paneflow` en Windows): - `usage/plans.json`: para cada cuenta, el porcentaje usado y la hora de reinicio de cada ventana, cuándo se leyó y la versión del agente. - `usage/ledger.json`: para cada cuenta y cada día de los últimos 400 días, el número de turnos, el tiempo activo y los tokens de entrada y salida, además de la ruta y la posición de lectura de las transcripciones que lee. No guarda ningún texto de prompt ni de respuesta. ## Desactivarlo [#turn-it-off] Pon `usage.plan_limits` en `false` en `paneflow.json` para ocultar la cápsula. La próxima vez que Paneflow actualice su integración de Claude Code, al arrancar o con `paneflow integrations install claude-code`, también quitará la línea de estado que configuró. `paneflow integrations remove claude-code` también la quita.