Codex Usage Widget

该 Skill 指导在 macOS 上安装、更新、校验或卸载一个 Uebersicht 桌面小组件，组件仅读取本地 ~/.codex 下的数据库与会话日志，汇总 Codex 令牌用量、最近根会话、来源标签与上下文窗口压力，不调用外部 API、不上传数据。文件列表仅含 SKILL.md，所引用的组件资源与安装、卸载脚本均缺失。

tinadu-ai

热度 11.60

最近更新 2026-07-08 07:21:48

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

安装技能

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

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

Metadata

name: codex-usage-widget
description: Install, update, inspect, or uninstall a local-only Uebersicht 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, Uebersicht 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 Uebersicht 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/Uebersicht/widgets/codex-usage.widget/

Uebersicht should refresh automatically. If it does not, use the Uebersicht 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 Uebersicht widgets.

Uninstall

Run:

scripts/uninstall.sh

This removes only:

~/Library/Application Support/Uebersicht/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/Uebersicht/widgets/codex-usage.widget/codex-usage.py"

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