a weird nul file

[Loulou823]

Description

🐞 Bug: OpenCode creates nul file on Windows (Reserved device name)

Environment

• OS: Windows 11 25H2
• Node.js: v24.13.1
• npm: v11.8.0

---

Description

When executing certain OpenCode commands on Windows, a file named:

nul

is created in the project directory.

On Windows, NUL is a reserved DOS device name (null device) and should not exist as a normal filesystem file. Once created, it cannot be deleted using standard methods such as:

del nul

This causes issues with Git, editors, and project tooling.

---

Expected Behavior

OpenCode should not create files using reserved Windows device names.

No nul file should appear in the working directory.

---

Actual Behavior

• A file named nul appears in the project root.
• It cannot be deleted normally.
• It may require forced deletion using the device namespace path:

del .\C:\path\to\project\nul

---

Possible Cause

This may be related to:

• Improper stdout/stderr redirection (> nul)
• A dependency writing to "nul" as a filename
• Cross-platform handling assuming /dev/null
• Windows-specific path handling bug

---

Reproduction Steps

some times

Plugins

none

OpenCode version

1.2.15

Steps to reproduce

some times

Screenshot and/or share link

No response

Operating System

Windows 11 25H2

Terminal

Windows CMD

[github-actions]

This issue doesn't fully meet our contributing guidelines.

What needs to be fixed:

• The description appears to be AI-generated (you noted "its chatgpt that generated for me") — AI-generated walls of text are not acceptable as bug reports.
• No reproducible steps are provided. "Random chance" and "I don't know what command does that" is insufficient context for a bug report. Please describe what you were doing when the file appeared, what commands you ran, etc.

Please edit this issue to address the above within 2 hours, or it will be automatically closed.

---

This issue might be a duplicate of existing issues. Please check:

• nul file generate #11586: nul file generate
• Unexpected file named "nul" is repeatedly created after updating OpenCode #11403: Unexpected file named "nul" is repeatedly created after updating OpenCode
• Undeletable nul file #13369: Undeletable nul file

If you believe this was flagged incorrectly, please let a maintainer know.

[github-actions]

Thanks for updating the issue! Unfortunately it still has a couple of problems that need to be addressed:

1. AI-generated description: The description block appears to be AI-generated (structured markdown with emoji headers, nested sections, "Possible Cause" bullet lists, etc.). Please replace it with your own words describing what you observed.

2. Reproduction steps are not actionable: The "Steps to reproduce" field just says "some times" — that's not enough to reproduce the bug. Please provide the actual steps you took when the nul file appeared (e.g., which command you ran, what you were doing in the project, etc.).

Please edit the issue to:

• Write the description in your own words (a few plain sentences is fine)
• Provide concrete steps to reproduce the problem

Thanks!

[github-actions]

This issue has been automatically closed because it was not updated to meet our contributing guidelines within the 2-hour window.

Feel free to open a new issue that follows our issue templates.