codex-vscode-project-patch
v0.3.10
Published
Locally patch the official OpenAI Codex VS Code extension task list to filter by the active workspace.
Maintainers
Readme
codex-vscode-project-patch
Filter the official Codex VS Code task list to the active workspace, without redistributing OpenAI's extension or VSIX.
Use
Requires Node.js 20 or newer and an installed openai.chatgpt VS Code extension.
npx --yes --prefer-online codex-vscode-project-patch@latestThe explicit @latest selects npm's current release tag, while
--prefer-online forces an immediate freshness check. --yes only accepts
npm's install prompt; it does not update an already available command by itself.
The default command discovers the extension, checks its version and bundle hash, creates a verified backup, applies the patch atomically, and verifies the result. It refuses unknown or ambiguous builds instead of guessing.
After a successful run, reload VS Code:
- Press
Cmd+Shift+Pon macOS orCtrl+Shift+Pon Windows/Linux. - Run
Developer: Reload Window. - Reopen the Codex task list.
Restore the official file at any time:
npx --yes --prefer-online codex-vscode-project-patch@latest restoreInspect the installation without changing it:
npx --yes --prefer-online codex-vscode-project-patch@latest status
npx --yes --prefer-online codex-vscode-project-patch@latest status --jsonSupported extension versions and bundle hashes are deliberately allowlisted.
An official extension update may remove the patch; rerun the same npx command.
If the new bundle is unknown, the CLI exits without modifying it.
Automatic update repair
Install Codex Patch, the unofficial companion VS Code extension:
code --install-extension cixiangtao.codex-patchIt detects official Codex extension updates, refreshes the reviewed compatibility registry, and reuses the same fail-closed Core to repair a compatible clean bundle before the user restarts extensions. Unknown or modified bundles are never changed.
The default repair mode asks first. Choose Always Repair Automatically once to make future compatible updates require only a single Restart Extensions. The CLI remains available for diagnostics, recovery, and headless use.
The repository checks the official macOS ARM64/x64 Marketplace builds every
hour, preferring stable releases over pre-releases. A compatible new build is
fully validated, committed through a protected pull request, merged after
required CI, and published through the Actions-owned
npm/GitHub Release workflow. Changed request structure or
ThreadListParams.cwd semantics stop the automation and create a review issue.
The companion extension reads the reviewed registry from main, so it receives
new compatibility data without requiring a Marketplace version bump for every
Codex release.
See the full documentation, contribution guide, and security policy.
MIT licensed. This is an unofficial project and is not affiliated with or endorsed by OpenAI.
