Swift Investigations Portal

Device Agent for Windows Client Tool

This guide walks through installing and running the Windows Device Agent in full detail, including what to do if something on screen doesn't match exactly — phone/PC brands and Windows versions vary the wording of a few prompts slightly. If you just need the quick version, the download page has a short numbered list; this page is the extended version with troubleshooting.

What this tool actually does

The Device Agent is a single script — nothing is installed on your computer, and nothing stays behind afterward. When you run it, it does exactly three things: (1) asks for your case number and shows you which case and client name it found, so you can confirm it's talking to the right case before anything happens; (2) reads a list of the applications currently installed on this computer, plus a few basic system details (computer name, Windows version, manufacturer/model); (3) sends that information directly to your case file, where your investigator can see it immediately. It does not read your files, browsing history, passwords, messages, or anything beyond the installed-program list and the basic system details described above.

Before you start

You'll need: a Windows 10 or 11 computer, an internet connection, and your case number (your investigator will give you this — it looks like 117331-KG44T). You do not need administrator access for the normal path below.

Step-by-step

1. Download the file. From the download page, click the download button. A file called SwiftDeviceAgent.zip will land in your Downloads folder (check the notification that pops up in your browser, or open File Explorer → Downloads).

2. Extract it. Right-click SwiftDeviceAgent.zip and choose Extract All (or just double-click it — Windows can browse a zip like a regular folder). This gives you two files, SwiftDeviceAgent.bat and SwiftDeviceAgent.ps1 — keep them together in the same folder; the first runs the second.

3. Double-click SwiftDeviceAgent.bat. That's it — unlike some other technical tools, this one does not need a right-click menu or "Run with PowerShell." Double-clicking it runs the tool directly, the same as any other program.

4. Expect a security prompt the first time. Because this file was just downloaded from the internet, Windows will very likely show one of two warnings before it runs: a blue full-screen box titled "Windows protected your PC", or a smaller Open File - Security Warning box. Both are standard for any small tool from outside the Microsoft Store, not a sign of a problem.

5. Skip that prompt next time (optional). Right-click SwiftDeviceAgent.bat before running it and choose Properties. On the General tab, near the bottom, check the box labeled Unblock, then click OK. This tells Windows the file is fine, and the double-click in step 3 will run with no warning screen at all.

6. Enter your case number. A console window opens, prepares the tool for a second, then shows a green banner and asks: "Enter your case number." Type it exactly as given to you (letters and numbers, no spaces) and press Enter. If it says the case wasn't found, just try again — there's no limit on attempts, so stay on the line with your investigator until it goes through.

7. Confirm your information. You'll see your name, case number, and case title printed on screen. Double-check this is actually you and your case — if it isn't, close the window and contact your investigator instead of continuing.

8. Begin the scan. Press Enter again when prompted. You'll see a short sequence: reading system information, then enumerating installed applications (this can take up to 10–15 seconds on a computer with a lot of software installed — this is normal, let it finish).

9. Done. You'll see "Report filed successfully" with a count of how many applications were found. Press Enter (or just close the window) — that's the whole process.

Troubleshooting

"Case number not found" — Double check every character, especially the dash and any letters that look similar (0 vs O, 1 vs I). There's no attempt limit, so keep trying — the tool tolerates a stray "#" or "Case" in front of the number and a couple of common dash substitutions, so most typos still get through.

"Could not reach the Swift Investigations portal" — This means your computer couldn't connect to the internet at that moment. Check your Wi-Fi/network connection and run the script again.

An error mentioning "execution policy" — Rare, and only seen on locked-down work/managed computers where Group Policy overrides everything, including this tool's own built-in bypass. Fix: open the Start menu, type PowerShell, right-click it and choose Run as administrator, then paste in:

Set-ExecutionPolicy -Scope Process Bypass

Press Enter, type Y if asked to confirm, then close that window and double-click SwiftDeviceAgent.bat again.

Antivirus flagged the file — Some antivirus software is cautious about any downloaded script/batch tool by default, even legitimate ones. If yours quarantines it, restore it from quarantine/allow it, or contact your investigator, who can walk through it with you live on a call.

Privacy note

The information collected here is attached only to your specific case, identified by your case number, and is visible only to your assigned investigator and authorized staff — the same access that already applies to the rest of your case file.