Use portable shebang for cross-platform compatibility #17556
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Replace `#!/bin/bash` with `#!/usr/bin/env bash` in all shell scripts and documentation examples. This fixes compatibility issues on systems like NixOS where bash is not located at /bin/bash. The `/usr/bin/env bash` approach uses PATH to locate bash, making the scripts portable across different Unix-like systems including Linux distributions, macOS, BSD variants, and NixOS. Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
gui-wf
approved these changes
Jan 13, 2026
gui-wf
left a comment
gui-wf
left a comment
There was a problem hiding this comment.
This is an awesome change!
For OSes that don't have the bash binary at /bin/bash,
Like NixOS
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
#!/bin/bashwith#!/usr/bin/env bashin all shell scripts and documentation/bin/bashMotivation
The hardcoded
/bin/bashshebang breaks on several systems:/bin/bashUsing
/usr/bin/env bashresolves the bash executable from the user'sPATH, making the scripts portable across all Unix-like systems.🤖 Generated with Claude Code