Skip to content

Fix shebang recommendation in file-based apps docs #53566

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Copilot wants to merge 2 commits into
base: main
Choose a base branch
from
+6 −1
Draft

Fix shebang recommendation in file-based apps docs #53566

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
fa996f2
Initial plan
Copilot May 5, 2026
8b65ccd
Fix incorrect shebang recommendation in file-based apps docs
Copilot May 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion docs/core/sdk/file-based-apps.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -318,7 +318,7 @@ Enable direct execution of file-based apps on Unix-like systems by using a sheba
Add a shebang at the top of your file:

```csharp
#!/usr/bin/env dotnet
#!/usr/bin/env -S dotnet --
#:package Spectre.Console

using Spectre.Console;
Expand All @@ -341,6 +341,11 @@ Run directly:
> [!NOTE]
> Use `LF` line endings instead of `CRLF` when you add a shebang. Don't include a BOM in the file.

To prevent `dotnet` from consuming arguments that match its own parameters—such as `--help`—the shebang uses `--` as a separator. The `--` separator tells `dotnet` to forward all subsequent command-line arguments directly to your app. The `-S` flag lets `env` split the remaining text into separate arguments so you can include `--` in the shebang.

> [!NOTE]
> If `-S` isn't supported on your system, use `#!/usr/bin/env dotnet` instead. With this shebang, `dotnet` might consume arguments that match its own CLI parameters.

## Implicit build files

File-based apps respect MSBuild and NuGet configuration files in the same directory or parent directories. These files affect how the SDK builds your application. Be mindful of these files when organizing your file-based apps.
Expand Down
Loading