Linux window controls ignore the system-configured button layout
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.4k
- PR merge metrics
- PR metrics pending
Description
What version of the Codex App are you using (From “About Codex” dialog)?
26.818.41705
What subscription do you have?
Plus
What platform is your computer?
Linux 7.1.9-200.fc44.x86_64 x86_64 unknown
What issue are you seeing?
On Linux, the Codex desktop app uses Window Controls Overlay, but the window buttons do not respect the desktop's configured layout.
For example, GNOME may be configured to show only the close button or to place the controls on a specific side, but Codex shows a different layout.
This makes the window inconsistent with the rest of the desktop.
What steps can reproduce the bug?
- On GNOME, configure a custom window button layout, for example only the close button.
- Open Codex Desktop.
- Compare its window controls with native GNOME applications.
What is the expected behavior?
Codex should respect the system-configured window button layout and placement while keeping the current integrated title bar.
Additional information
Electron 43 added support for system-configured button layouts in Window Controls Overlay on Linux (electron/electron#51161).
It now respects which buttons the user has configured and whether they are placed on the left or right.
Electron 44 also adds system-themed WCO titlebar icons (electron/electron#52461).
This seems like it could be solved by updating the Electron runtime while keeping the current Codex title bar unchanged.
Related but different: openai/codex#38595 asks for an option to use full native system decorations. This issue is only about making the existing Window Controls Overlay respect the Linux desktop configuration.
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 at the Electron runtime configuration and review the Linux Window Controls Overlay support added in Electron 43 and 44. Reproduce the issue with a GNOME custom button layout, then verify that the existing integrated title bar follows the configured button selection and placement without switching to native decorations.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- electron, linux
- Domain
- desktop, operating-systems
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 68/100