openai / openai/codex

Linux window controls ignore the system-configured button layout

Open
#41,572 0 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

app bug
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?
  1. On GNOME, configure a custom window button layout, for example only the close button.
  2. Open Codex Desktop.
  3. 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.