Troubleshooting

Symptom	Try this
macOS blocks the download	Confirm the exact tag and hash. Read the alert and follow the installation guide.
Stash did not record a copy	Finish Stash Setup, check the pause state and exclusions, then copy a new non-sensitive item. The existing clipboard is skipped on initial capture.
The shortcut does not open Stash	Open from the menu bar. In Settings → Shortcuts, record an unused combination or keep using the menu bar.
It says the item is ready on the clipboard	Switch to your destination and use ⌘V. For direct paste, check Accessibility and a compatible focused editable field.
An external file cannot be opened	Check whether the original moved, was removed or is inaccessible. A file reference alone does not contain the original file.
No iCloud sharing setting in the development package	Public Mac downloads disable sharing. Read the signed build requirements.
Suggestions is unavailable	Check device, model and permissions. Use search while the model is unavailable.

For a reproducible issue, open Settings → About and note the build number, then visit support. Use fictional examples in public reports.