| title | SECURITY.md — get-bashed |
|---|---|
| updated | 2026-04-10 |
| status | current |
This project prioritizes safe defaults, explicit install paths, and minimal privilege. Please help keep it secure by reporting issues responsibly.
- Only the latest release receives security updates.
- The
mainbranch may include fixes before the next release.
- Use GitHub Security Advisories for private reporting.
- If you cannot use GitHub, open a private discussion with the maintainer via GitHub.
- Do not open a public issue for security reports.
- A clear description of the issue and impact.
- Steps to reproduce, including relevant commands or configs.
- Affected versions or commit SHAs.
- Any known mitigations or workarounds.
- Acknowledgement within 3 business days.
- Initial triage within 7 business days.
- Fix and disclosure timeline will be shared after confirmation.
- Coordinated disclosure is expected.
- Please avoid publishing proof-of-concepts until a fix is released.
install.shand scripts ininstallers/are security-sensitive.- Any
curlorgitinstallation path must be verified and pinned when feasible. - Changes that modify PATH, shell startup, or secret handling are in scope.
- User secrets in
secrets.d/and any injected environment variables. - Shell startup integrity (
bashrc,bash_profile,bashrc.d/). - Installer integrity (
install.sh,installers/,scripts/ci-setup.sh). - User PATH and toolchain selection (asdf/brew/system).
- Supply-chain tampering (compromised GitHub releases, mirrors, or plugins).
- Local adversary modifying
~/.get-bashedor symlinked dotfiles. - Malicious PRs introducing unsafe shell behavior.
- Unpinned downloads or unverified
curl/gitinstallers. - Command injection via untrusted input in shell scripts.
- PATH poisoning via incorrect ordering or untrusted directories.
- Secrets leakage via logs or generated config files.
- Installer inputs, profiles, and feature handling.
- Tool registry definitions and dependency ordering.
- Any code touching secrets, PATH, or shell init files.
- Upstream security issues in third-party tools (report to upstream).
- User-specific misconfiguration outside of get-bashed artifacts.
- Avoid
evaland unsafe command substitutions. - Validate all user input that affects execution paths.
- Prefer pinned versions and checksums where feasible.
- Keep idempotency to avoid repeated side effects.