Docs/The desktop app
Documentation menu

Using PromptDust

The desktop app

The desktop app wraps the same engine as the command line, with a saved-scan inbox, attention filters, and a persistent detail view. It is the easiest way in for most people.

Run a scan

  1. Open PromptDust.
  2. Read the one-screen explanation and click Scan this computer.
  3. Review the results, grouped by tool. Each store shows an exposure level, what is amplifying it, and plain-language guidance.

A scan runs off the interface thread, so the window stays responsive while it works. A pass over one machine takes roughly a minute.

Read and triage

Results land in an inbox you can work through. Findings are grouped by tool and sorted so the most exposed rise to the top. You can mark a scan as read, and set per-item state (read, pinned, or flagged) so a store you have already dealt with stops competing for attention on the next run. That state is saved under the app’s own config directory. It never touches the files you scanned.

For what the exposure level and the amplifiers mean, see Reading your results.

Reveal a store

Clicking Reveal opens the folder that contains a store in your file manager. It never opens the file’s contents. This keeps the read-only, metadata-only promise intact even when you want to go look at something yourself.

Export a report

Use Export report to save a copy of a scan. It writes to your Downloads folder.

The report maps where sensitive AI data lives on your machine, so treat the file as sensitive: keep it off shared or synced locations, and delete it when you are done. The app warns you about this every time you export.

Updates

The info button (top right) opens About, where Check for updates lives. PromptDust never checks for or downloads an update on its own. It only looks when you click, and any update is cryptographically verified before it installs.

Installed through Homebrew or winget instead? Update with brew upgrade or winget upgrade.

Spotted a mistake in these docs? Open an issue.