codex - 💡(How to fix) Fix Custom pets fail to load in WSL environments due to path normalization [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#20730Fetched 2026-05-03 04:46:36
View on GitHub
Comments
2
Participants
3
Timeline
6
Reactions
2
Timeline (top)
labeled ×3commented ×2cross-referenced ×1

Custom Pets appear to not work in WSL-enabled environments. This may be caused by Windows/WSL path normalization for the custom pets directory.

Error Message

Custom Pets do not load correctly when running Codex from a WSL-enabled environment.

Root Cause

Summary

Custom Pets appear to not work in WSL-enabled environments. This may be caused by Windows/WSL path normalization for the custom pets directory.

RAW_BUFFERClick to expand / collapse

Summary

Custom Pets appear to not work in WSL-enabled environments. This may be caused by Windows/WSL path normalization for the custom pets directory.

Environment

  • Windows host with WSL-enabled Codex environment
  • Custom Pets enabled/configured

Observed behavior

Custom Pets do not load correctly when running Codex from a WSL-enabled environment.

The suspected problem is that Codex is resolving or normalizing the custom pet asset path incorrectly instead of looking under the expected \pets path.

Expected behavior

Custom Pets should work in WSL-enabled environments. Codex should normalize/translate the custom pet path consistently between the Windows host and WSL/Linux runtime so the configured pet assets can be located.

Possible cause

Path normalization between Windows host paths and WSL/Linux paths may be incomplete for custom pet assets. The custom pet lookup may need to normalize to the expected pets directory before attempting to load pet assets.

Notes

This issue is specifically about Custom Pets failing in WSL-enabled environments. A previous local screenshot read error was unrelated to the underlying Custom Pets behavior and has been removed from this report.

extent analysis

TL;DR

Normalizing the custom pet asset path to consistently point to the expected \pets directory may resolve the issue with Custom Pets not loading in WSL-enabled environments.

Guidance

  • Verify that the custom pet directory path is correctly configured and accessible from both the Windows host and WSL environment.
  • Check if the path normalization issue can be mitigated by using a consistent path separator (e.g., forward slash /) in the custom pet configuration.
  • Investigate if the Codex environment provides any built-in path normalization functions or utilities that can be used to translate Windows paths to WSL-compatible paths.
  • Test loading Custom Pets with a simplified path configuration to isolate if the issue is specific to complex paths or the normalization process.

Example

No specific code example can be provided without more details on the Codex configuration and custom pet asset loading mechanism.

Notes

The solution may depend on the specific version of Codex and WSL being used, as well as the configuration of the custom pet assets. Further debugging may be required to identify the exact cause of the path normalization issue.

Recommendation

Apply a workaround by manually normalizing the custom pet asset paths to ensure consistency between the Windows host and WSL environment, as the root cause of the issue appears to be related to path normalization.

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…

FAQ

Expected behavior

Custom Pets should work in WSL-enabled environments. Codex should normalize/translate the custom pet path consistently between the Windows host and WSL/Linux runtime so the configured pet assets can be located.

Still need to ship something?

×6

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

Back to top recommendations

TRENDING

codex - 💡(How to fix) Fix Custom pets fail to load in WSL environments due to path normalization [2 comments, 3 participants]