https://github.com/qoli/codex-disable-escape-tweak
Codex++ tweak that blocks Escape in Codex Desktop renderer windows
https://github.com/qoli/codex-disable-escape-tweak
codex-desktop codex-plusplus escape-key tweak
Last synced: about 1 month ago
JSON representation
Codex++ tweak that blocks Escape in Codex Desktop renderer windows
- Host: GitHub
- URL: https://github.com/qoli/codex-disable-escape-tweak
- Owner: qoli
- License: mit
- Created: 2026-05-05T12:31:57.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-05T12:36:38.000Z (3 months ago)
- Last Synced: 2026-05-05T14:35:26.718Z (3 months ago)
- Topics: codex-desktop, codex-plusplus, escape-key, tweak
- Language: JavaScript
- Size: 444 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Codex Disable Escape Tweak
A small [Codex++](https://github.com/b-nnett/codex-plusplus) renderer tweak
that consumes `Escape` key events inside Codex Desktop before the app's
shortcut handlers can interrupt an active response.
The demo is a cropped and annotated version of a Codex Desktop screen recording.
It shows the runtime path: Codex++ loads `co.qoli.disable-escape`, the tweak
registers capture-phase key handlers, and `Escape` is consumed before Codex
shortcut handling sees it.
Related upstream issue:
- [openai/codex#20767](https://github.com/openai/codex/issues/20767) -
`Escape` from CJK IME composition can pass through and interrupt the model.
## What It Does
The tweak registers capture-phase `keydown`, `keyup`, and `keypress` handlers
on `window` and `document`. When `event.key === "Escape"`, it calls
`stopImmediatePropagation()` and `stopPropagation()`.
This only affects Codex Desktop renderer windows after Codex++ has loaded the
tweak. It does not change the global macOS `Escape` key behavior.
## Install
Install Codex++ first, then copy or symlink this repository into your Codex++
tweaks directory:
```bash
codexplusplus install --no-default-tweaks --no-watcher
codexplusplus dev /path/to/codex-disable-escape-tweak --name co.qoli.disable-escape --replace --no-watch
```
Restart Codex Desktop after installing or reloading the tweak.
## Verify
```bash
codexplusplus validate-tweak /path/to/codex-disable-escape-tweak
codexplusplus status
codexplusplus doctor
```
Codex++ ad-hoc signs the local app bundle after patching. `spctl` notarization
checks may reject the patched app even when `codexplusplus doctor` and
`codesign --verify` pass.