Utilisation du forfait

Paneflow affiche la part de vos abonnements Claude Code et Codex que vous avez utilisée, pour chaque compte de votre ordinateur : une capsule dans le pied de la barre latérale, une bulle avec le détail de chaque compte, et une page Usage dans Settings avec une année d'activité quotidienne. Paneflow ne lit jamais vos identifiants ni vos jetons d'accès et n'appelle jamais lui-même une API d'utilisation.

Comptes

Un compte correspond à un agent et un dossier de configuration. Paneflow liste les dossiers par défaut ~/.claude et ~/.codex, chaque espace qui définit CLAUDE_CONFIG_DIR ou CODEX_HOME dans son environnement, et chaque profil d'agent qui le fait. Deux espaces qui pointent vers le même dossier partagent un seul compte. Un compte facturé via une clé d'API (ANTHROPIC_API_KEY, OPENAI_API_KEY) n'a pas de limites de forfait, et Paneflow l'indique.

La capsule de la barre latérale

La capsule se trouve entre le filtre et le bouton Settings. Son anneau et son pourcentage montrent la limite la plus contraignante parmi les comptes de l'espace actif, ou parmi les comptes par défaut quand l'espace n'en définit aucun. L'anneau prend la couleur d'accent sous 80 %, l'ambre à partir de 80 % et le rouge à partir de 95 %. Survolez-la pour voir le compte et la fenêtre qu'elle décrit.

Cliquez sur la capsule, ou appuyez sur Enter ou Space quand elle a le focus, pour ouvrir la bulle. Chaque compte affiche ses fenêtres de session et hebdomadaire avec une jauge, l'heure de réinitialisation dans l'infobulle de la jauge, et une ligne de rythme pour la semaine : soit le moment où vous atteindrez la limite hebdomadaire à votre rythme actuel, soit la part de la semaine que vous aurez utilisée à sa réinitialisation. Open usage settings, en bas, ouvre la page Usage.

Pour masquer la capsule, désactivez Usage dans Customize sidebar › Show, ou réglez sidebar_show.usage sur false. Sans compte Claude Code ni Codex, la capsule n'apparaît pas.

La page Usage

Settings › Usage affiche une tuile par compte avec deux anneaux, la semaine à l'extérieur et la session à l'intérieur, les heures de réinitialisation et la ligne de rythme. Refresh demande à chaque compte ses limites actuelles.

Sous Activity by agent, chaque compte qui a de l'activité sur les 53 dernières semaines reçoit un registre d'une cellule par jour. Basculez la métrique entre Turns, Tokens (entrée et sortie, cache exclu) et Active time. Tous les registres partagent la même échelle : une cellule plus foncée signifie plus d'activité, quel que soit l'agent. Survolez un jour, ou parcourez les jours avec les flèches après être entré dans un registre avec Tab, pour lire le décompte de chaque agent ce jour-là.

Paneflow compte cette activité lui-même, à partir des agents qui tournent dans ses panneaux sur cet ordinateur. Il ne connaît pas les sessions lancées ailleurs.

Importer l'activité passée

Au premier démarrage avec un journal d'activité vide, Paneflow lit en arrière-plan vos transcriptions Claude Code existantes (projects/**/*.jsonl dans chaque dossier de configuration Claude) et vos fichiers de session Codex, et complète les jours qu'il ne compte pas encore. Import past activity, en bas de la page, relance l'import. Importer deux fois ne compte jamais un jour deux fois, et le jour en cours reste toujours au décompte en direct.

L'import lit d'abord les fichiers les plus récents et s'arrête après 10 000 fichiers ou 2 Go. Quand il s'arrête avant la fin, la page affiche Imported the last {n} days. Claude Code conserve les transcriptions 30 jours par défaut (cleanupPeriodDays dans ses paramètres), donc les jours plus anciens restent vides.

D'où viennent les limites

Paneflow lit les limites uniquement depuis les programmes des agents eux-mêmes, connectés avec vos propres identifiants :

• Ligne d'état de Claude Code. Quand vous installez l'intégration Claude Code et que vous n'avez pas de ligne d'état (status line) à vous, Paneflow règle statusLine dans les paramètres de Claude sur paneflow-ai-hook StatusLine. Après chaque réponse, Claude Code lui passe les limites qu'il rapporte, et Paneflow les relaie à la capsule. La commande n'affiche rien, donc votre ligne d'état reste vide.
• Les binaires Claude Code et Codex installés. Quand vous ouvrez la bulle ou actualisez la page Usage, Paneflow demande son utilisation au claude installé, sans envoyer de message, et demande ses limites de débit à codex app-server. Chaque compte est interrogé au plus une fois toutes les 30 secondes.
• Fichiers de session Codex. Après chaque tour Codex, Paneflow lit les limites que Codex a écrites dans son fichier de session le plus récent.

La lecture la plus récente d'un compte l'emporte.

Si vous avez votre propre ligne d'état

Paneflow ne modifie jamais une ligne d'état que vous avez configurée. Il lit alors vos limites depuis le binaire Claude Code installé, et la capsule fonctionne de la même façon. Tant que cette lecture n'a pas réussi, le compte affiche : « 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. »

Ce que Paneflow stocke

Tout reste dans le dossier usage du home Paneflow (~/.paneflow, %USERPROFILE%\.paneflow sous Windows) :

• usage/plans.json : pour chaque compte, le pourcentage utilisé et l'heure de réinitialisation de chaque fenêtre, le moment de la lecture et la version de l'agent.
• usage/ledger.json : pour chaque compte et chaque jour des 400 derniers jours, le nombre de tours, le temps actif et les tokens d'entrée et de sortie, plus le chemin et la position de lecture des transcriptions qu'il lit. Il ne stocke aucun texte de prompt ni de réponse.

Désactiver

Réglez usage.plan_limits sur false dans paneflow.json pour masquer la capsule. La prochaine fois que Paneflow actualise son intégration Claude Code, au démarrage ou avec paneflow integrations install claude-code, il retire aussi la ligne d'état qu'il avait définie. paneflow integrations remove claude-code la retire également.