61 lines
2.4 KiB
Markdown
61 lines
2.4 KiB
Markdown
# 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)
|