Codex Desktop file tree shows symlinked files but hides symlinked directories outside the workspace
What version of the Codex App are you using?
Codex Desktop 26.818.61809
What subscription do you have?
Unknown
What platform is your computer?
macOS 26.5.2 (25F84), arm64
What issue are you seeing?
The Codex Desktop file tree handles valid symlinks inconsistently based on the target type:
- A symlink whose target is a regular file outside the opened workspace is shown in the file tree and can be opened, but it has the same visual treatment as a regular file. There is no symlink badge or icon to distinguish it.
- A symlink whose target is a directory outside the opened workspace is omitted from the file tree entirely.
The directory symlink and its contents remain accessible from the shell and the Codex agent, so this appears to be a file-tree visibility/filtering issue rather than a filesystem access problem.
This is narrower than #18262, which reported that both symlinked files and directories were invisible in Codex Desktop 26.415.21839. In the current version, file symlinks are visible while directory symlinks are not.
A related but different report, #25245, observed that non-dot symlink aliases to directories inside the same workspace could be displayed. The reproduction below uses targets outside the opened workspace.
What steps can reproduce the bug?
Create a workspace containing one symlink to an external file and one symlink to an external directory:
mkdir -p /tmp/codex-symlink-target/linked-dir
mkdir -p /tmp/codex-symlink-workspace
printf 'linked file\n' > /tmp/codex-symlink-target/linked-file.txt
printf 'nested file\n' > /tmp/codex-symlink-target/linked-dir/nested.txt
ln -s /tmp/codex-symlink-target/linked-file.txt /tmp/codex-symlink-workspace/file-link.txt
ln -s /tmp/codex-symlink-target/linked-dir /tmp/codex-symlink-workspace/dir-link
Then:
- Open
/tmp/codex-symlink-workspaceas a workspace in Codex Desktop. - Open the file tree.
- Observe that
file-link.txtis displayed. - Observe that
dir-linkis missing. - Confirm in the shell that both links resolve and that
dir-link/nested.txtis readable.
The same behavior occurs in a real user configuration directory: regular directories are listed, symlinked skill directories are omitted, while a symlinked JSON file is displayed.
What is the expected behavior?
Both valid symlinked files and valid symlinked directories should be visible in the file tree. Each symlink entry should have a clear badge or icon so it can be distinguished from a regular file or directory. If following external directory symlinks is intentionally restricted, the entry should still be shown with a clear explanation rather than silently omitted.
Additional information
Related issues:
- #18262 — broader older report where both file and directory symlinks were invisible
- #25245 — dot-directory filtering; internal non-dot directory aliases were reportedly visible