Codex Usage Widget

用于安装、更新、检查或卸载 macOS 上的 Übersicht 桌面小部件：读取本机 Codex 的 SQLite 与 JSONL 文件，展示 token 用量、近期根会话、来源标签与上下文窗口压力；声明不调用外部 API、不需要模型密钥、不上传数据，并提示本地存储字段可能随 Codex 版本变化。

tinadu-ai

热度 8.91

最近更新 2026-07-08 07:22:02

分类：自动化依赖：代码执行 / 读写文件应用场景：数据处理 / 工作流 / 报告撰写

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add tina-codex-usage-widget

Metadata

name: codex-usage-widget
description: Install, update, inspect, or uninstall a local-only Übersicht desktop widget that tracks Codex token usage, recent root sessions, source labels, and context-window pressure. Use when the user asks for a Codex usage widget, desktop usage monitor, Übersicht Codex monitor, local Codex session tracker, or help maintaining this widget.

Codex Usage Widget

What This Skill Provides

Use this skill to install or maintain a lightweight macOS Übersicht widget for Codex. The widget reads only local Codex files under ~/.codex:

state_5.sqlite for thread metadata.
logs_2.sqlite for local log byte totals.
sessions/**/*.jsonl and archived_sessions/*.jsonl for token-count events, origin labels, and context-window pressure.

It does not call external APIs, does not require a model key, and does not upload data.

For OpenClaw / Claw users, use this skill when the machine also runs Codex and the goal is to monitor Codex's local ~/.codex state from the desktop.

Install

Run:

scripts/install.sh

The script copies assets/codex-usage.widget/ to:

~/Library/Application Support/Übersicht/widgets/codex-usage.widget/

Übersicht should refresh automatically. If it does not, use the Übersicht menu bar item to refresh all widgets.

Update

Run scripts/install.sh again. The script overwrites only this widget directory and does not touch Codex settings or other Übersicht widgets.

Uninstall

Run:

scripts/uninstall.sh

This removes only:

~/Library/Application Support/Übersicht/widgets/codex-usage.widget/

Behavior Notes

Recent rows are grouped by root session, so spawned subagents do not appear as separate sessions.
Source labels prefer rollout originator: codex_vscode becomes VSCode, Codex Desktop becomes Client, and terminal/CLI-like originators become Terminal.
The right-side row metric is context-window pressure, calculated from the latest input_tokens. It uses a 200K window until a session exceeds that level, then uses a 1M window.
A root session can be hidden from the recent list after a standard wrap-up prompt plus a short user confirmation such as 23, all, no, or similar local-language variants.
The widget is intentionally best-effort because Codex local storage fields may change between Codex releases.

Validate

After installing, run:

python3 "$HOME/Library/Application Support/Übersicht/widgets/codex-usage.widget/codex-usage.py"

The command should print JSON with "ok": true.