ACX — AutoContinue + Codex

What is ACX?

ACX = AutoContinue + CodeX

Built on top of OpenAI Codex CLI, ACX embeds the core logic of AutoContinue to provide:

• Auto-Continue: Automatically sends a continue prompt after each turn completes — no manual intervention needed
• Smart Retry: Retries with exponential backoff on transient errors (rate limits, server overload, connection failures, etc.), capped at 5 minutes
• Auto-Stop on Fatal Errors: Permanent errors like context exceeded or auth failure stop immediately without wasting retries
• Extensible Stop Hooks: Stop based on round count, wall-clock time, duration, or custom commands
• /acx-stop Command: Manually stop auto-continue at any time from the TUI

All original Codex CLI features are fully preserved.

Installation

npm install -g @moyeranqianzhi/acx

After installation, use the acx command. Auto-continue is enabled by default — no extra flags needed.

Usage

# Auto-continue is enabled by default
acx "your task description"

# Custom continue prompt and delay
acx --continue-prompt "Keep iterating" --sleep-time 10 "refactor the project"

# With stop conditions
acx --stop-when "<round=5>" --stop-when "<duration=3600>" "optimize the codebase"

# Stop manually during a session: type /acx-stop in the TUI

ACX Flags

| Flag | Short | Description | Default | |------|-------|-------------|---------| | --continue-prompt | -cp | Continue prompt text | "Continue" | | --continue-prompt-io | -cpio | Continue prompt IO file (re-read each time) | — | | --continue-prompt-pipe | -cpp | Continue prompt pipe command | — | | --sleep-time | -st | Base delay in seconds (exponential backoff on errors) | 15 | | --stop-when | -sw | Preset stop condition (repeatable) | — | | --stop-hook | -sh | Custom stop hook command (repeatable) | — |

Stop Condition Examples

--stop-when "<round=10>"       # Stop after 10 rounds
--stop-when "<error>"           # Stop on any error (no retry)
--stop-when "<duration=3600>"   # Stop after 1 hour
--stop-when "<time=2026-01-01T08:00:00>"  # Stop at a specific time

Supported Platforms

| Platform | Architecture | Status | |----------|-------------|--------| | Linux | x86_64, ARM64 | ✅ | | macOS | ARM64 (Apple Silicon) | ✅ | | Windows | x86_64, ARM64 | ✅ |

Upstream Sync

ACX automatically syncs with openai/codex upstream updates every hour via GitHub Actions. ACX modifications follow a minimal-insertion principle (marked with // [ACX] comments), with core logic encapsulated in a standalone codex-auto-continue crate to minimize merge conflicts.

Acknowledgements

• OpenAI Codex CLI — The underlying CLI framework, licensed under Apache-2.0
• AutoContinue — The original auto-continue/retry logic

License

This project is licensed under the Apache-2.0 License, consistent with upstream Codex.

Documentation

• Codex Documentation
• AutoContinue Project
• Contributing
• Installing & building