[Windows] Severe mouse stuttering after launching Codex Desktop until pet/avatar overlay is opened and closed
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.5k
- PR merge metrics
- PR metrics pending
Description
What version of the Codex App are you using (From “About Codex” dialog)?
26.810.50856
What subscription do you have?
Team
What platform is your computer?
Windows 11
What issue are you seeing?
[!IMPORTANT]
Temporary workaround
If Codex Desktop causes severe system/UI stuttering:
- Open the Codex pet/avatar feature.
- Close or disable the pet/avatar feature again.
On my system, the mouse and UI stuttering stops immediately after the pet/avatar overlay is opened once and then closed.
Issue
Simply launching Codex Desktop causes severe system/UI stuttering on Windows 11, including noticeable mouse cursor stutter.
The issue starts immediately after Codex is opened and does not require starting a task.
During investigation, I observed approximately 974 MiB/s (~1 GB/s) of continuous read I/O while Codex is running.
Interestingly, the measured throughput is very close to the bandwidth required for repeatedly processing an uncompressed 4K BGRA/RGBA frame at roughly 30 FPS:
3840 × 2160 × 4 bytes × 30 FPS ≈ 949 MiB/s
What steps can reproduce the bug?
Simply launching Codex Desktop causes severe system/UI stuttering on Windows 11, including noticeable mouse cursor stutter.
What is the expected behavior?
A hidden or disabled avatar/pet overlay should not continuously process/copy full-resolution frames.
Launching Codex should also not generate ~1 GB/s of continuous read I/O or cause system-wide mouse/UI stuttering.
Additional information
Investigation / suspected cause
The logs show that the newer Codex build creates an additional hidden window named:
avatarOverlay
Events also appear to be dispatched to both the main Codex window and this hidden overlay window.
Based on the measured ~974 MiB/s read throughput and the timing/size correlation, it appears that the hidden avatar/pet overlay may still be processing or copying full-resolution desktop/frame data at approximately 30 FPS even when the overlay is not visible.
I have not confirmed this from the Codex source code, so this is currently a suspected cause based on runtime measurements and logs.
Reproduction
- Start Windows 11 normally.
- Confirm that mouse/system responsiveness is normal.
- Launch Codex Desktop.
- Immediately observe significant mouse/UI stuttering.
- Open the Codex pet/avatar feature.
- Disable/close the pet feature.
- The mouse/UI stuttering immediately disappears.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing the stutter on Windows 11 and comparing behavior before and after opening and closing the pet/avatar feature. Inspect logs and event activity around the hidden avatarOverlay window, then verify that launching Codex with the overlay hidden no longer causes continuous high read I/O or system-wide stuttering.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- desktop, operating-systems, performance
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100