codex-usage-and-resets — плагин для Claude Code: установка и функции
Плагин codex-usage-and-resets показывает расход недельного лимита Codex, темп использования и сроки сброса. Помогает оценить, хватит ли лимита на запланированную работу.
Apache-2.0 ★ 1 596 обновлён 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install codex-usage-and-resets@awesome-codex-pluginsЧто делает codex-usage-and-resets
Плагин собирает локальный отчёт о недельном лимите Codex: сколько уже использовано, сколько осталось, есть ли сохранённые сбросы и когда они истекают. Он сравнивает текущий расход с линейным темпом и оценивает, закончится ли лимит до следующего запланированного сброса. При возврате расхода к нулю плагин фиксирует наблюдение, но не утверждает, что знает причину или точное время сброса.
Для чтения лимитов используется локальный метод Codex App Server account/rateLimits/read. Плагин не читает файлы авторизации и журналы сессий, не запускает запросы к модели и не расходует сбросы. Потребуются Node.js 18 или новее, совместимый codex и авторизация Codex через ChatGPT; без них локальный отчёт не получить. Остаток отображается целыми процентами, поэтому это верхняя граница, а не точное измерение.
Локально сохраняются один очищенный снимок использования и не более одного недавнего наблюдения о сбросе; устаревшие записи удаляются при следующем успешном отчёте. Если сравнение ненадёжно, цепочка наблюдений сбрасывается, поэтому отчёт не делает выводов через такой промежуток. Запросите отчёт через $cuar или спросите агента о расходе, темпе и сроках сброса.
Какие задачи решает
- проверить остаток недельного лимита Codex
- сравнить текущий расход с линейным темпом
- оценить, закончится ли лимит до следующего сброса
- узнать число сохранённых сбросов и сроки их истечения
- зафиксировать неожиданное возвращение расхода к нулю
Примеры запросов агенту
- Покажи текущий расход Codex и сколько осталось на неделю через
$cuar. - Сравни мой темп использования с линейным и оцени, хватит ли лимита до сброса.
- Проверь сохранённые сбросы и их сроки истечения через
$cuar.
Как установить codex-usage-and-resets
Через маркетплейс плагинов
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install codex-usage-and-resets@awesome-codex-pluginsПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о codex-usage-and-resets
Как установить codex-usage-and-resets в Claude Code?
Выполните /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем /plugin install codex-usage-and-resets@awesome-codex-plugins.
Что делает codex-usage-and-resets?
Плагин формирует отчёт о расходе недельного лимита Codex, темпе использования и сохранённых сбросах. Также он оценивает возможное исчерпание лимита до следующего планового сброса.
Что нужно для работы плагина?
Нужны Node.js 18 или новее, совместимый локальный codex, авторизация Codex через ChatGPT и клиент Codex, который запускает локальные скиллы.
Исходный текст
codex-usage-and-resets · Apache-2.0
# Codex Usage and Resets [](https://github.com/joelfarthing/codex-usage-and-resets/actions/workflows/ci.yml) [](https://github.com/joelfarthing/codex-usage-and-resets/actions/workflows/hol-plugin-scanner.yml) **Canonical project site:** [Codex Usage and Resets on Filament Labs](https://filamentlabs.io/CUAR/) — a visual tour, installation guidance, and field notes. Codex Usage and Resets (CUAR) is a local Codex plugin from Filament Labs. It turns the current Codex weekly usage window, banked reset inventory, and a tiny local observation ledger into deterministic usage-planning facts: - banked reset count and returned expiration details; - used and remaining weekly usage; - the whole-percentage precision limit, including an imminent-exhaustion warning when the reported remainder reaches 1%; - pace above, below, or approximately at linear usage; - projected exhaustion when the current average burn would exhaust capacity before the next scheduled reset; and - an unexpected early return to zero used, reported conservatively as an observation rather than proof of the reset's cause or exact time. CUAR uses the documented local Codex App Server `account/rateLimits/read` method. It does not read Codex authentication files, inspect session logs, call private ChatGPT endpoints, start a thread or model turn, or consume a reset. CUAR is read-only toward Codex and OpenAI. Locally, it keeps one sanitized usage snapshot and at most one recent reset observation, ignoring and pruning either on the next successful report once it is more than eight days old. A report that cannot form a trustworthy comparison clears the comparison chain, so a later report cannot infer across the blind interval. ## Requirements - Node.js 18 or newer - a compatible local `codex` executable - ChatGPT-backed Codex authentication - a Codex client able to run local plugin skills The same packaged skill and CLI are intended for Codex in the ChatGPT desktop app, the Codex VS Code extension, and Codex CLI. ## Installation Install from [the direct Codex Usage and Resets listing in the OpenAI Plugins Directory](https://chatgpt.com/plugins/plugins_6a6920fb32b48191b80cb783761d4cd5): open it and choose **Install plugin**. The directory copy is a reviewed, versioned snapshot and does not automatically track this repository. ## Use Invoke `$cuar` or ask Codex about current Codex usage, linear pace, projected exhaustion, banked reset expirations, or whether an unexpected reset was observed. CUAR's machine report is deterministic; the model explains what the facts mean for planned work without recalculating its fields. OpenAI reports usage in whole percentage points, so CUAR treats displayed remaining usage as an upper bound rather than an exact measurement. CUAR is independently developed and is not developed, supported, or endorsed by OpenAI. Reset observation cannot rule out an account switch or every coincident banked-reset change. Current observations and projections do not promise future unscheduled resets. ## Validation and trust The public repository runs its portable test suite on macOS and Linux across supported Node.js versions. A separate [HOL Guard](https://github.com/hashgraph-online/hol-guard) workflow scans the plugin on pull requests and `main`, requires a score of at least 80, and fails on any high-or-critical finding. Both workflows use read-only repository permissions. They do not receive Marketplace credentials, upload SARIF, or submit or publish the plugin. Passing automated checks is reproducible project evidence, not certification, endorsement, or Marketplace acceptance by OpenAI, HOL, Cisco, or any other party. The July 28, 2026 CUAR 0.1.1 pre-publication run used HOL Guard `plugin-scanner` 2.0.1116 against both the public source and extracted release ZIP. Both produced: - `public-marketplace` policy: **PASS**; - score: **97/100 — A, Excellent**; - critical, high, medium, and low findings: **zero**; - HOL runtime verification: **PASS**; and - Cisco skill scanning: completed with the balanced policy and no elevated findings. The two remaining notices are informational schema differences. HOL scores an absent optional screenshot field as invalid; CUAR does not invent screenshots. Cisco recommends a per-skill license field, while Codex skill authoring permits only `name` and `description` frontmatter. The repository and plugin manifest declare Apache-2.0. ## Privacy, security, and support See [PRIVACY.md](./PRIVACY.md), [SECURITY.md](./SECURITY.md), and [SUPPORT.md](./SUPPORT.md).
© Filament Labs · Apache-2.0 · hashgraph-online/awesome-codex-plugins