Skip to main content

codex-continue

Expect-style wrapper that automatically sends a "Continue" message to Codex CLI after your usage limit resets.

Quickstart:

pipx install codex-continue
codex-continue -- "/goal finish this task"

Background: you have a long task for codex, and a cheap Pro plan. Your task if for fun and you don't want to spend more money on it. But you also don't want to waste your unused plan quotas or your time waiting to click "Enter" when the limit refreshes. This script is for you.

This script waits for a message with the following format to show up:

You've hit your usage limit. Upgrade to Pro (https://chatgpt.com/explore/pro), visit https://chatgpt.com/codex/settings/usage to purchase more credits or try again at 11:42 AM.

When that happens, it parses out the time displayed, sleeps until it is reached and then wakes up and then automatically sends a message which defaults to:

Continue

which should be enough to send Codex on its merry way once again until the next quota is hit and the cycle continues.

Tested on Ubuntu 25.10, Python Python 3.13.7, codex-cli 0.133.0.

Installation

From PyPI:

pipx install codex-continue

Use latest master executable from a clone:

git clone https://github.com/cirosantilli/codex-continue
cd codex-continue
pipx install -e codex-continue

Usage

Run Codex through the wrapper:

codex-continue

Pass an initial prompt to Codex. /goal is recommended, Codex seems to work for much longer with it now:

codex-continue -- "/goal finish this task"

Customize the continuation text:

codex-continue --continue-prompt "Continue exactly where you left off"

When Codex prints a usage-limit message with either an absolute reset time or a relative duration, codex-continue keeps the same Codex process alive, waits until the reset time plus a grace period, then injects the continuation prompt and presses Enter.

Publishing

Build and upload:

pipx install build twine
python -m build
python -m twine upload dist/*

Metadata

Release files for codex-continue 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for codex-continue 0.1.0
File Size Uploaded
codex_continue-0.1.0.tar.gz 6.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for codex-continue 0.1.0
File Interpreter ABI Platform
codex_continue-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 12.6 kB

Release files / codex_continue-0.1.0.tar.gz

Download URL codex_continue-0.1.0.tar.gz
Size 6.2 kB
Tags Source
SHA-256 checksum
How to use checksums
bd55c2383715436451cdcef8e1dab1d3ee9eeb179b131008cdb8a63c2cdc3e9b
BLAKE2b-256 checksum
How to use checksums
71a75f8ff2a3f1b719ad64d764cb26f198bde08b35909f4e9325043a616ef88d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Release files / codex_continue-0.1.0-py3-none-any.whl

Download URL codex_continue-0.1.0-py3-none-any.whl
Size 6.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
80e8d5afb0522060436194140be5f5ce227c5d68fb218a59bb9f5d246bad39e7
BLAKE2b-256 checksum
How to use checksums
754400bb04fa80027f982a9c29a4ff312276fd629a8f3c0abfb855b91e38e95a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page