Codex Usage Widget pour Openclaw

Openclaw Skills vous permet d'installer et de maintenir un widget Übersicht uniquement local qui suit l'utilisation des tokens Codex, les sessions parentes (root sessions), les étiquettes de source et la pression de la fenêtre de contexte sur macOS.

tinadu-ai
v1.1.0
Jul 15, 2026
0
617
0

Installer & Télécharger

1. ClawHub CLI

Le moyen le plus rapide d'installer une compétence directement depuis le registre.

npx clawhub@latest install codex-usage-widget

2. Installation manuelle

Copiez le dossier de la compétence dans l'un de ces emplacements

Global
~/.openclaw/skills/
Espace de travail
<project>/skills/

Priorité : Espace de travail > Local > Intégré

3. Installation du prompt

Copiez ce prompt dans OpenClaw pour l'installer automatiquement.

Aide-moi à installer codex-usage-widget via Clawhub. Si Clawhub n'est pas installé, installe-le d'abord (npm i -g clawhub).

Vous préférez télécharger ?

Obtenez les fichiers bruts de la compétence dans une archive ZIP.

Qu'est-ce que Codex Usage Widget ?

Openclaw Skills fournit un widget Übersicht pour macOS respectueux de la vie privée pour surveiller l'activité de Codex sans quitter votre machine. Il lit les fichiers locaux de Codex sous ~\/.codex, agrège les signaux de session et de token, et affiche sur votre bureau une vue compacte de l'utilisation, des sessions parentes récentes et de la pression de la fenêtre de contexte.\n\nComme il n'appelle jamais d'API externes, ne nécessite aucune clé de modèle et n'envoie aucune donnée en ligne, il est idéal pour les développeurs qui recherchent un tableau de bord Codex local et léger. Openclaw Skills est conçu de manière pragmatique (best-effort) afin de rester aligné avec les formats de stockage local de Codex tout en étant facile à installer, mettre à jour, valider et supprimer.

Cas d'utilisation de Codex Usage Widget

  • Installer un outil de suivi d'utilisation Codex local sur macOS avec Übersicht.\n- Inspecter les sessions parentes récentes et les événements de comptage de tokens sans analyser le texte des messages.\n- Distinguer les sources d'utilisation telles que VSCode, Client et Terminal à partir d'étiquettes d'origine locales.\n- Suivre d'un coup d'œil la pression de la fenêtre de contexte pour repérer les sessions volumineuses ou en croissance.\n- Mettre à jour ou réinstaller le widget après une modification de Codex ou de Übersicht.\n- Supprimer proprement le widget sans toucher aux autres widgets ou aux paramètres de Codex.

Comment fonctionne Codex Usage Widget

  1. Lancez scripts\/install.sh pour copier assets\/codex-usage.widget\/ dans ~\/Library\/Application Support\/Übersicht\/widgets\/codex-usage.widget\/.\n2. Übersicht s'actualise automatiquement ; si ce n'est pas le cas, utilisez l'icône de la barre des menus pour actualiser tous les widgets.\n3. Le widget lit uniquement les fichiers Codex locaux : ~\/.codex\/state_5.sqlite, ~\/.codex\/logs_2.sqlite, ~\/.codex\/sessions\/**\/*.jsonl et ~\/.codex\/archived_sessions\/*.jsonl.\n4. Il regroupe les lignes récentes par session parente, de sorte que les sous-agents (subagents) créés soient regroupés dans leur session parente au lieu d'apparaître séparément.\n5. Il normalise les étiquettes de source à partir des métadonnées originator et calcule la pression de la fenêtre de contexte à partir des derniers input_tokens, en utilisant une fenêtre de 200K jusqu'à ce que la session dépasse cette limite, puis bascule à 1M.\n6. Pour maintenir le widget, réexécutez scripts\/install.sh pour les mises à jour, validez avec le point d'entrée Python ou exécutez scripts\/uninstall.sh pour supprimer uniquement ce répertoire de widget.

Configuration de Codex Usage Widget

Prérequis\n- macOS avec Übersicht installé\n- Données Codex locales disponibles sous ~\/.codex\n- Aucune clé d'API, clé de modèle ou configuration réseau requise\n\n### Installer\nbash\nscripts\/install.sh\n\n\nCela copie assets\/codex-usage.widget\/ dans ~\/Library\/Application Support\/Übersicht\/widgets\/codex-usage.widget\/. Si Übersicht ne s'actualise pas automatiquement, utilisez le menu de la barre d'état pour actualiser tous les widgets.\n\n### Valider\nbash\npython3 "$HOME\/Library\/Application Support\/Übersicht\/widgets\/codex-usage.widget\/codex-usage.py"\n\n\nUne exécution réussie doit afficher du code JSON avec "ok": true.\n\n### Mettre à jour\nbash\nscripts\/install.sh\n\n\n### Désinstaller\nbash\nscripts\/uninstall.sh\n\n\nCela supprime uniquement le dossier ~\/Library\/Application Support\/Übersicht\/widgets\/codex-usage.widget\/ et laisse les autres widgets ainsi que les paramètres de Codex intacts.

Schéma de données et taxonomie de Codex Usage Widget

Sources d'entrée\n| Chemin | Objectif | Notes |\n| --- | --- | --- |\n| ~\/.codex\/state_5.sqlite | Métadonnées de fil de discussion | Utilisé pour comprendre les relations entre fils de discussion et sessions parentes |\n| ~\/.codex\/logs_2.sqlite | Totaux des octets des journaux locaux | Prend en charge un contexte d'utilisation léger |\n| ~\/.codex\/sessions\/**\/*.jsonl | Flux d'événements de session active | Fournit les événements de comptage de tokens, les étiquettes d'origine et les signaux de pression |\n| ~\/.codex\/archived_sessions\/*.jsonl | Flux d'événements de session archivée | Utilisé pour l'historique récent et les lignes regroupées |\n\n### Taxonomie dérivée\n- root_session : clé de regroupement canonique qui rassemble les sous-agents créés sous la session parente.\n- source_label : étiquette d'affichage normalisée dérivée des valeurs de déploiement originator, telles que codex_vscode -> VSCode, Codex Desktop -> Client, et les sources de type terminal ou CLI -> Terminal.\n- context_window_pressure : calculé à partir des derniers input_tokens ; le widget utilise par défaut une fenêtre de 200K et bascule vers 1M dès qu'une session dépasse cette limite.\n- recent_rows : lignes d'activité locale générées au mieux (best-effort) à partir de l'état archivé uniquement ; le widget n'analyse jamais le texte des messages.\n\n### Sortie générée\n- ~\/Library\/Application Support\/Übersicht\/widgets\/codex-usage.widget\/ — répertoire du widget installé copié depuis assets\/codex-usage.widget\/.\n- Aucune télémétrie externe, charge utile d'API, exportation vers le cloud ou fichier de base de données dérivé à long terme n'est créé par la skill.

Fonctionnalités avancées de Codex Usage Widget

  • Architecture exclusivement locale sans appels d'API externes, clés de modèle ni téléversements.\n- Agrégation des sessions parentes regroupant les sous-agents créés au sein d'une seule ligne de tableau de bord lisible.\n- Normalisation des étiquettes de source pour une reconnaissance rapide entre vos flux de travail VSCode, Codex Desktop et terminal.\n- Score adaptatif de la pression de la fenêtre de contexte passant de 200K à 1M lorsque les sessions augmentent.\n- Scripts d'installation, de mise à jour et de désinstallation non destructifs qui ne touchent qu'au répertoire du widget.\n- Compatibilité de type « best-effort » conçue pour tolérer les modifications de stockage local de Codex entre les versions.\n- Validation en ligne de commande via codex-usage.py pour une vérification rapide après l'installation.

SKILL.md


Chargement

Compétences Openclaw associées

METADATA

Github Stars: 0
forks: 0

En vedette*