English | 简体中文

dsh-codex-reset-tracker

DeepSeek Harness plugin for Codex reset status. It adds a composer entry with a compact status popover and registers the read-only codex_reset agent tool.

Acknowledgements

Reset signals and available translations are provided by Did Codex Reset. Thank you to its maintainers for collecting and organizing these public reset signals and providing the read-only API and OpenAPI specification. This repository is a DSH integration of that upstream work; the API does not include account-specific quota information.

Original reset announcements are from Tibo Sottiaux (@thsottiaux).

Screenshots

Light theme	Dark theme

What it shows

• The composer entry opens a compact popover with today's reset status, the latest reset time, and the next scheduled time.
• The day check uses the browser's local calendar day. Scheduled events do not count as completed resets. If completedAt and effectiveAt are unavailable or invalid, the summary uses announcedAt.
• The popover includes the Tibo Sottiaux source post. It shows the Simplified Chinese translation and the English source when both differ.
• New schedule announcements and completed reset events show an unread marker. The marker clears when the popover is open in a visible tab.
• The client requests /status on mount and refreshes every 10 minutes. The agent tool can query status or paginated records.

Install from source

Clone the repository, then add it to a DSH profile:

git clone https://github.com/loshanvren/dsh-codex-reset-tracker.git
cd dsh-codex-reset-tracker
dsh plugin --profile <profile> add .

The package is named dsh-codex-reset in the DSH loader and package manifest.

Agent tool

codex_reset supports:

• action: "status" — the latest global and Banked reset signals and the next scheduled reset.
• action: "records" — one page of records, filtered by kind, page, and pageSize.

The tool accepts an optional lang for record translations. Successful responses are cached for 60 seconds by default.

Config	Default	Purpose
apiBaseUrl	https://didcodexreset.com/openapi/v1	Public API base URL used by the agent tool
cacheTtlSeconds	60	Tool response cache, from 5 to 3600 seconds
timeoutMs	20000	Tool call timeout, from 1000 to 120000 milliseconds

Override these values under the plugin row's config in cordis.patch.yml. The public API documents a shared limit of 60 requests per hour per IP.

License

The MIT License applies to this repository's code only. It does not relicense Did Codex Reset's data or translations, or Tibo Sottiaux's post and profile image.