Codex Desktop cannot open a workspace Markdown symlink targeting an external iCloud file

Open 💬 0 comments Opened Jul 11, 2026 by KristenPan

Summary

Codex Desktop shows a Markdown symlink in the workspace file sidebar, but clicking it does not open the file and no clear error is displayed when the symlink target is an iCloud Drive file outside the workspace.

Environment

  • ChatGPT Desktop / Codex mode: 26.707.41301 (5103)
  • macOS: 26.5.1
  • Architecture: Apple Silicon (arm64)

Steps to reproduce

  1. Open a local workspace in Codex Desktop.
  2. Create a symbolic link inside the workspace:

``sh
ln -s "/Users/<user>/Library/Mobile Documents/.../中文文件名.md" "./中文文件名.md"
``

  1. Confirm the target exists and is valid UTF-8 Markdown.
  2. Confirm the symlink can be read and edited from the shell.
  3. Click the symlinked Markdown file in the Codex workspace sidebar.

Expected behavior

Codex opens the Markdown target normally. If external symlink targets are intentionally unsupported, the UI should show a clear error explaining that the target is outside the workspace.

Actual behavior

The file appears in the workspace sidebar, but clicking it does not open the document. There is no visible error explaining the failure. The original iCloud file remains intact and can still be read and edited outside the Codex file viewer.

Additional information

  • The issue is specific to the workspace entry/file viewer; the underlying file, symlink, permissions, and UTF-8 contents are valid.
  • A search of the current desktop log did not show a corresponding explicit file-open error.
  • Removing the symlink removes the broken sidebar entry.
  • The path includes spaces and non-ASCII characters, and the target is under iCloud Drive.

View original on GitHub ↗