Issue Station
Sign In
Tools hereToolbox

codex - 💡(How to fix) Fix Codex cannot see symlinked files or directories in workspace [1 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#18262•Fetched 2026-04-17 08:30:39
View on GitHub
Comments
0
Participants
1
Timeline
2
Reactions
0
Author
mingxu1031mingxu1031
Participants
mingxu1031mingxu1031
Timeline (top)
labeled ×2
RAW_BUFFERClick to expand / collapse

What version of the Codex App are you using (From “About Codex” dialog)?

26.415.21839 (build 1763)

What subscription do you have?

Pro

What platform is your computer?

Darwin 25.3.0 arm64 arm

What issue are you seeing?

When I open a folder as a Codex workspace, symlinked files or directories inside that folder do not show up in the file tree.

The symlinks are valid and work normally in the shell, but Codex behaves as if they do not exist.

<img width="600" height="922" alt="Image" src="https://github.com/user-attachments/assets/4a479e0a-f895-4a55-a56c-4489b8d85bcd" /> <img width="928" height="442" alt="Image" src="https://github.com/user-attachments/assets/6378f528-97db-42d1-b0db-66671a31d4f9" />

What steps can reproduce the bug?

  1. Create a folder outside the workspace, for example real-dir, and put a file in it.
  2. Create another folder that will be opened as the Codex workspace.
  3. Inside that workspace folder, create a symlink to the external file or directory.
  4. Open the workspace folder in Codex.
  5. Check the file tree.

The symlinked file or directory does not appear in the file tree.

What is the expected behavior?

Symlinked files and directories inside the workspace should be visible in the file tree and accessible from Codex.

Additional information

No response

extent analysis

TL;DR

The issue can likely be resolved by configuring Codex to follow symlinks or by using a different method to link files and directories.

Guidance

  • Verify that the symlinks are correctly created and functional outside of Codex by checking them in the shell.
  • Check if there are any settings or options in Codex to enable the display of symlinked files and directories in the file tree.
  • Consider using a different method to link files and directories, such as using a symbolic link creation tool or a plugin that supports symlinks.
  • Test if the issue persists when using a different type of link, such as a hard link, to see if the problem is specific to symlinks.

Example

No code snippet is provided as the issue does not imply a specific code-related solution.

Notes

The issue may be specific to the version of Codex being used (26.415.21839) or the platform (Darwin 25.3.0 arm64 arm), and the solution may vary depending on these factors.

Recommendation

Apply a workaround, such as using a different method to link files and directories, as the issue may be related to how Codex handles symlinks.

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…
#orchestration issue#cache issue#memory leak#API versioning#request timeout

Still need to ship something?

×6

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

Back to top recommendations

TRENDING