# AI FileSorter diagnostics quick guide

Use this guide when support asks for a diagnostic bundle. The scripts collect
recent AI FileSorter logs, redact common secrets and user paths, and create a
zip file that you can attach to the issue report form.

Do not run the scripts with `--keep-raw` or `-KeepRaw` when sending files to
support.

## Windows

1. Download `collect_windows_diagnostics.ps1`:
   https://raw.githubusercontent.com/hyperfield/ai-file-sorter/main/app/scripts/collect_windows_diagnostics.ps1
2. Open PowerShell.
3. Go to the folder where you downloaded the script, usually Downloads:
   ```powershell
   cd $env:USERPROFILE\Downloads
   ```
4. Run:
   ```powershell
   powershell -ExecutionPolicy Bypass -File .\collect_windows_diagnostics.ps1 -OpenOutput
   ```
5. Attach the zip file it creates. The name should look like:
   `aifs-windows-diagnostics-YYYYMMDD_HHMMSS-redacted.zip`.

## macOS

1. Download `collect_macos_diagnostics.sh`:
   https://raw.githubusercontent.com/hyperfield/ai-file-sorter/main/app/scripts/collect_macos_diagnostics.sh
2. Open Terminal.
3. Go to the folder where you downloaded the script, usually Downloads:
   ```bash
   cd ~/Downloads
   ```
4. Run:
   ```bash
   chmod +x ./collect_macos_diagnostics.sh
   ./collect_macos_diagnostics.sh --open-output
   ```
5. Attach the zip file it creates. The name should look like:
   `aifs-macos-diagnostics-YYYYMMDD_HHMMSS-redacted.zip`.

## Linux

1. Download `collect_linux_diagnostics.sh`:
   https://raw.githubusercontent.com/hyperfield/ai-file-sorter/main/app/scripts/collect_linux_diagnostics.sh
2. Open Terminal.
3. Go to the folder where you downloaded the script, usually Downloads:
   ```bash
   cd ~/Downloads
   ```
4. Run:
   ```bash
   chmod +x ./collect_linux_diagnostics.sh
   ./collect_linux_diagnostics.sh --open-output
   ```
5. Attach the zip file it creates. The name should look like:
   `aifs-linux-diagnostics-YYYYMMDD_HHMMSS-redacted.zip`.

## If the script does not work

You can still submit the issue report. Include:

1. Your operating system.
2. Your AI FileSorter version, if you know it.
3. The exact error text.
4. A screenshot, if possible.
5. What you clicked or selected before the problem happened.