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 [#accounts] 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 [#the-sidebar-capsule] 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 [#the-usage-page] **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 [#import-past-activity] 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 [#where-the-limits-come-from] 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 [#if-you-have-your-own-status-line] 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 [#what-paneflow-stores] 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 [#turn-it-off] 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.