Contributing

Bug reports, feature requests, and pull requests are welcome on GitHub.

Filing a bug

Please include:

• The command you ran and its exact output.
• Your distro and shell (bash --version).
• Whether the affected directories ($ANDROID_HOME, $ASD_CSV) are user-owned or required sudo.
• The output of asd --list <name> if the issue is about a specific package not resolving correctly.

Requesting a feature

Open an issue describing the workflow you’re trying to support — asd is intentionally a single Bash script with no dependencies beyond common CLI tools, so proposals that keep that footprint small are easiest to land.

Pull requests

• Keep changes focused; separate unrelated fixes into separate PRs.
• Match the existing style: set -euo pipefail, small single-purpose functions (do_install, do_list, …), and run_priv for anything that might need elevated permissions.
• Test both the system-wide (sudo ./setup) and user-only (./setup ~/.local/bin ...) install paths — see Bypassing sudo.
• Update README.md and these docs if you change command behavior or add a new flag.

License

asd is MIT licensed.