Install & first run
One double-click installs FOX3 and walks you straight into setup. No commands to type, no second terminal.
1. Get the build
Download the beta zip from the gated download page (you'll confirm your invited email with a one-time PIN). Unzip it anywhere.
2. Install
Windows
Double-click Install_for_Windows.cmd. A window opens, installs everything, and
starts the setup wizard.
If Windows shows a blue "Windows protected your PC" box, click More info → Run anyway — the beta build isn't code-signed yet.
macOS
Double-click Install_for_macOS.command.
- If macOS says "unidentified developer": Control-click the file → Open → Open.
- If it says you don't have permission (the execute bit can be lost when a zip is unpacked):
open Terminal, type
bash(with a space), drag the.commandfile in, press Return.
The installer checks for Python 3.11+ (and offers to get it), installs FOX3 in its own isolated environment, downloads the Chromium browser for scraping (~150 MB, one-time), and opens the guided wizard automatically.
3. Your API key (in the wizard)
FOX3 needs a Claude (Anthropic) API key — your own, or the sponsored one we sent you. Paste it when the wizard asks.
Windows 10 paste tip: on older Windows consoles Ctrl+V may not work in the key field. Right-click to paste instead (the field shows this hint too).
4. Where it installed & your data folder
The installer prints the exact resolved command path and your data folder at the end. Your data folder is where your profile, settings, database and reports live:
- Windows:
%LOCALAPPDATA%\JobScout(typicallyC:\Users\<you>\AppData\Local\JobScout) - macOS:
~/Library/Application Support/JobScout
You can pick a custom location during setup; it's recorded in a small
location.json pointer so every run and update finds it.
Updating
Re-running the installer on a newer zip upgrades in place — the old version is replaced, and your data folder is never touched. If FOX3 shows an "update available" banner, download the new zip and double-click the installer again. Any scheduled auto-run keeps working.
Uninstalling
FOX3 lives in its own isolated environment (via pipx). To remove the app:
pipx uninstall jobscout
That removes the program and the fox3 / fox3-gui commands. On Windows,
also delete the FOX3 Desktop shortcut and, if you created a scheduled task, remove it with
setup_task_scheduler.ps1 -Remove.
Your data survives an uninstall, on purpose — so a reinstall picks up where you left off. To erase it permanently, delete the data folder above by hand after uninstalling.
Verify your download (optional)
Compare the zip's SHA-256 against the SHA256SUMS published next to the download link.