feat: publish Codex 429 auto-continue plugin

2026-09-11 01:29:34 +08:00
commit 6661bf26f1
14 changed files with 990 additions and 0 deletions
@@ -0,0 +1,60 @@
+# Codex 429 Auto Continue
+
+[简体中文](README.zh-CN.md)
+
+A Codex Desktop plugin that continues a task after Codex exhausts its built-in retries with HTTP 429.
+
+## Features
+
+- Detects only structured `response_too_many_failed_attempts` failures with HTTP status 429.
+- Waits exactly 3 seconds for every continuation attempt, with at most four plugin-initiated attempts in one failure chain.
+- Uses a native retry or continue tool when Codex exposes one; otherwise sends only `继续` to the original task.
+- Covers new and reopened tasks through `SessionStart` and backfills all currently loaded tasks through `UserPromptSubmit`.
+- Cancels its pending continuation when Codex or the user has already started another turn.
+- Uses one watcher per task to avoid duplicate continuations.
+
+## Requirements
+
+- Codex Desktop on Windows.
+- Node.js available as `node` on `PATH`.
+
+The plugin currently depends on Codex Desktop's internal local task-tool pipe. That interface is not a stable public API and may require compatibility updates after a Codex release.
+
+## Install
+
+```powershell
+codex plugin marketplace add https://git.crash.work/cneicy/codex-429-auto-continue.git
+codex plugin add codex-429-auto-continue@codex-429-auto-continue
+```
+
+Start or reopen a task after installation. If Codex asks you to review the hook, approve it from `/hooks`.
+
+## Behavior
+
+The watcher reads new records from the task transcript. After a structured 429 task failure, it waits 3 seconds and checks whether a new turn has already started. If not, it attempts native continuation and falls back to sending `继续`.
+
+A successful task completion resets the failure chain. The chain also resets after 15 minutes without a plugin-initiated continuation. A watcher exits when its task ends or after 24 hours without transcript activity.
+
+Prompt text, assistant text, and tool output that merely contain `429` do not trigger the plugin.
+
+## Local Data
+
+Per-task JSONL event logs and lock files are stored under:
+
+```text
+%USERPROFILE%\.codex\plugin-data\codex-429-auto-continue
+```
+
+The plugin does not make its own network requests. It reads local Codex transcripts and communicates with the local Codex Desktop task pipe.
+
+## Development
+
+```powershell
+npm test
+```
+
+The installable plugin is under `plugins/codex-429-auto-continue`. The marketplace manifest is `.agents/plugins/marketplace.json`.
+
+## License
+
+[MIT](LICENSE)