codex - 💡(How to fix) Fix Computer Use MCP fails to start on macOS 14.8.1 because bundled client requires macOS 15 [2 comments, 3 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openai/codex#20183Fetched 2026-04-30 06:32:35
View on GitHub
Comments
2
Participants
3
Timeline
6
Reactions
0
Author
Timeline (top)
labeled ×4commented ×2

The bundled computer-use plugin fails during MCP startup on macOS 14.8.1. Codex reports an MCP handshake failure, but the underlying process exits immediately because the bundled SkyComputerUseClient binary was built for macOS 15.0 and depends on a Swift runtime library unavailable on macOS 14.

Error Message

Error shown by Codex

Root Cause

Computer Use MCP fails to start on macOS 14.8.1 because bundled client requires macOS 15

Fix Action

Workaround

Disable the plugin in ~/.codex/config.toml:

[plugins."computer-use@openai-bundled"] enabled = false

Code Example

MCP client for `computer-use` failed to start:
  MCP startup failed: handshaking with MCP server failed:
  connection closed: initialize response

  MCP startup incomplete (failed: computer-use)
RAW_BUFFERClick to expand / collapse

Computer Use MCP fails to start on macOS 14.8.1 because bundled client requires macOS 15

Summary

The bundled computer-use plugin fails during MCP startup on macOS 14.8.1. Codex reports an MCP handshake failure, but the underlying process exits immediately because the bundled SkyComputerUseClient binary was built for macOS 15.0 and depends on a Swift runtime library unavailable on macOS 14.

Environment

  • Codex CLI: codex-cli 0.125.0
  • macOS: 14.8.1
  • Build: 23J30
  • Architecture: arm64
  • Plugin: computer-use@openai-bundled
  • Plugin version path: computer-use/1.0.758

Error shown by Codex

MCP client for `computer-use` failed to start:
MCP startup failed: handshaking with MCP server failed:
connection closed: initialize response

MCP startup incomplete (failed: computer-use)

Direct reproduction

Run the bundled MCP binary directly:

cd ~/.codex/plugins/cache/openai-bundled/computer-use/1.0.758 ./Codex\ Computer\ Use.app/Contents/SharedSupport/SkyComputerUseClient.app/Contents/MacOS/SkyComputerUseClient mcp

Actual result

dyld: Library not loaded: /usr/lib/swift/libswift_errno.dylib Referenced from: .../SkyComputerUseClient (built for macOS 15.0 which is newer than running OS) Reason: tried: '/usr/lib/swift/libswift_errno.dylib' ... no such file

Expected result

Either:

  1. computer-use starts successfully on macOS 14, or
  2. Codex detects the minimum OS requirement before startup and reports a clear compatibility message instead of an MCP handshake failure.

Impact

computer-use is unusable on macOS 14.8.1, and Codex shows the startup warning on each session until the plugin is disabled manually.

Workaround

Disable the plugin in ~/.codex/config.toml:

[plugins."computer-use@openai-bundled"] enabled = false

Suggested fix

Please either publish a macOS 14-compatible build, bundle the required Swift runtime if macOS 14 is intended to be supported, or gate the plugin by minimum OS version with a clearer diagnostic.

extent analysis

TL;DR

The most likely fix is to update the SkyComputerUseClient binary to be compatible with macOS 14.8.1 or to bundle the required Swift runtime library.

Guidance

  • Verify the compatibility of the SkyComputerUseClient binary with macOS 14.8.1 by checking its build configuration and dependencies.
  • Consider bundling the required Swift runtime library with the computer-use plugin to ensure compatibility with macOS 14.
  • As a temporary workaround, disable the computer-use plugin in ~/.codex/config.toml by setting enabled = false.
  • To prevent similar issues in the future, consider adding a minimum OS version check for the computer-use plugin to provide a clearer diagnostic message when incompatible.

Example

No code snippet is provided as it is not necessary for this issue.

Notes

The issue is specific to the computer-use plugin and its compatibility with macOS 14.8.1. The suggested fix or workaround may not apply to other plugins or environments.

Recommendation

Apply the workaround by disabling the computer-use plugin until a compatible build or update is available, as this is the most straightforward solution to mitigate the issue.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING