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 (This is a hassle, I know. I'm working on it.)

Double-click Install_for_macOS.command.

• 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 .command file in, press Return.
• If macOS blocks it ("unidentified developer"):
  open System Settings → Privacy & Security, scroll to Security, and click Open Anyway (shown for a short while after the blocked attempt), then double-click again.
• Fastest on any recent macOS: in Terminal paste xattr -d com.apple.quarantine and drag the .command file in.

The installer checks for Python 3.11+ (and gets it for you if you don't), installs FOX3 in its own isolated environment, downloads the Chromium browser for scraping (~150 MB, one-time), and opens the guided wizard automatically.

macOS: the installer also creates ~/Applications/FOX3.app, so you can re-open FOX3 later from Launchpad or Spotlight (type "FOX3"). The short fox3 / fox3-gui terminal commands only work in a newly opened Terminal window (the installer just updated your PATH); the FOX3.app works straight away.

3. Your API key (in the wizard)

FOX3 needs a Claude (Anthropic) API key — your own, or the sponsored one I 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 (typically C:\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

FOX3 does not auto-update. To actually upgrade, you have to download a fresh installer zip for the new version and run that one.

So when FOX3 shows an "update available" banner: go to the download page, grab the new zip, unzip it, and double-click the installer in it. The old version is replaced, your data folder is never touched, and 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.