Codex Desktop crashes when clicking same-folder relative Markdown link on Windows
Summary
Codex Desktop on Windows crashes/restarts when clicking a local Markdown link inside a rendered local Markdown document. This reproduces with a same-folder relative link to a synthetic Markdown file, so it does not require WSL/UNC paths, private content, parent-relative traversal, or malformed Markdown.
Environment
- OS: Windows 11, observed Windows version string in WER output:
10_0_26200 - Codex Desktop package observed locally:
OpenAI.Codex_26.623.9142.0_x64__2p2nqsd0c76g0 - Workspace path type: normal Windows filesystem path under
C:\Users\<user>\... - Workspace path contains a space, for example:
C:\Users\<user>\Workspace With Space\...
Minimal Privacy-Safe Repro
Create a local Markdown repro with only synthetic content:
$root = Join-Path $env:TEMP "Codex Link Repro With Space"
New-Item -ItemType Directory -Force -Path $root | Out-Null
$target = Join-Path $root "synthetic-large-transcript.md"
$index = Join-Path $root "index.md"
$lines = @(
"# Synthetic Large Transcript",
"",
"This file contains no private content. It is only for local Markdown link navigation testing.",
"",
"## Timestamped Transcript",
""
)
for ($i = 1; $i -le 2600; $i++) {
$lines += "[00:00:00.000 - 00:00:02.000] Synthetic transcript sentence number $i for renderer and navigation testing only."
}
$lines += ""
$lines += "## Plain Transcript"
$lines += ""
for ($i = 1; $i -le 800; $i++) {
$lines += "Synthetic paragraph $i. Placeholder text for testing a markdown file of similar size without private content."
}
Set-Content -LiteralPath $target -Value $lines -Encoding UTF8
@"
# Codex Local Markdown Link Crash Repro
Click this link from inside Codex Desktop's rendered Markdown view:
[synthetic relative transcript](synthetic-large-transcript.md)
"@ | Set-Content -LiteralPath $index -Encoding UTF8
Write-Host $index
Write-Host $target
(Get-Item $target).Length
Then:
- Open
index.mdin Codex Desktop's rendered Markdown view. - Click
[synthetic relative transcript](synthetic-large-transcript.md). - Codex Desktop crashes/restarts.
Expected Behavior
Codex should either:
- open/render the linked Markdown file,
- open it externally,
- or show a handled error if this navigation is unsupported.
It should not crash or restart the desktop app.
Actual Behavior
Clicking the same-folder relative Markdown link causes Codex Desktop to crash/restart. The active turn can be interrupted.
Diagnostics Performed
The synthetic target is intentionally plain Markdown and contains no private content. In the original reproduction environment, the equivalent synthetic file had these characteristics:
- Valid UTF-8.
- No control characters.
- No HTML.
- No URLs.
- Simple Markdown only: headings and transcript-like text lines.
- Reproduced from a same-folder relative Markdown link.
After the synthetic-link crash, Windows Application log scans did not show a clean Codex.exe application-fault entry. The scan did show WER LiveKernelEvent / WATCHDOG entries around the time of reproduction, but those may be unrelated or too indirect to be useful.
No obvious local Codex crash logs were found under %LOCALAPPDATA%\OpenAI in the reproduction environment.
Related Issues
Related but not identical: #29347 (Windows: clicking WSL/UNC file links in chat can restart Codex Desktop). That issue concerns WSL/UNC paths emitted as chat links. This reproduction uses a normal Windows path and a same-folder relative Markdown link inside a rendered local Markdown document.
Related navigation area: #24383 (Codex Desktop: support deep links to Markdown headings from chat and rendered docs). That issue is about heading fragments opening without crashing; this issue is a crash/restart.
Suggested Fix Direction
- Add defensive error handling around local Markdown link navigation and renderer file loading.
- Normalize and escape Windows local paths before opening local Markdown targets, especially paths containing spaces.
- If local Markdown file navigation is unsupported, intercept the click and show a non-crashing error/toast.
- Add regression coverage for relative Markdown links from a rendered local Markdown document to another local Markdown file under a Windows workspace path containing spaces.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗