# 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)