Installation

Use the Strikekit website to download the local installer. The wizard downloads and installs everything you need (runner, browser tooling, agent) and starts the background service. You do not need to run install scripts by hand.

Install flow: Open Strikekit → Download → pick OS / arch / package → download the GUI installer → run Strikekit Installer → accept terms → keep user-local install (or choose system) → Install → open web app → Run tests → Pair this computer.

What you install

You stay in the browser after install. The agent has no separate product UI.

Step 1 — Open the Download page

1. Go to the Strikekit website.
2. Open Download (or /download).
3. You should see Download the local installer.

Step 2 — Choose your platform and download

1. Select your OS: Windows, macOS, or Linux.
2. If shown, pick Architecture (e.g. Apple Silicon / Intel on Mac; x86_64 / ARM64 on Linux).
3. Pick a package format (recommended defaults below).
4. Click Download.

Recommended packages

Other options (bare .exe / binary) work too; archives (.zip / .tar.gz) are easiest because they include the matching install script next to the app.

Step 3 — Run the GUI installer

Windows

1. Unzip the downloaded .zip (if you used .zip).
2. Run strikekit-installer (or the .exe).
3. Follow the wizard.

macOS

1. Extract the .tar.gz.
2. Open strikekit-installer.
3. Follow the wizard.

Linux (.deb)

sudo dpkg -i strikekit-installer-linux-amd64.deb   # or arm64
strikekit-installer

Linux (.tar.gz)

tar -xzf strikekit-installer-linux-amd64.tar.gz
./strikekit-installer

Step 4 — Walk through the wizard

The installer window title is Strikekit Installer. Pages, in order:

1. Welcome — Explains that the agent runs tests locally while you use the web app. Click Continue.
2. Terms & Conditions — Read and check I have read and agree…. Click Continue.
3. Install options
   • Default (recommended for most users): install to a user-local folder with no admin password:
     • Linux/macOS: ~/.local/bin
     • Windows: %LOCALAPPDATA%\Strikekit
   • Uncheck that option only if you want a system-wide install (/usr/local/bin or Program Files; may need admin/sudo).
   • Click Install.
4. Installing… — Log output streams in the window. Wait until it finishes (browser download can take several minutes).
5. Install complete — Click Open Strikekit to open the web app, or Close.

What the installer does automatically

You do not need to download these yourself. On Install, the wizard:

1. Downloads the latest install.sh (macOS/Linux) or install.ps1 (Windows) from GitHub Releases (gloocan/strikekit-agent).
2. Runs that script, which then:
   • Downloads and installs the strikekit runner
   • Installs browser tooling for web tests
   • Downloads and installs strikekit-agent
   • Writes production config (~/.strikekit/agent.yaml)
   • Starts the background service (systemd / LaunchAgent / Windows Service)
3. Checks agent health on http://127.0.0.1:19527/v1/health

Step 5 — Pair this computer (required before runs)

1. Open Strikekit and sign in (same machine where you installed).
2. Go to Run tests.
3. Click Pair this computer.
4. When pairing succeeds, use Sync & run or Local folder.

Re-pair after upgrading the agent or changing config.

Optional — Verify after install

strikekit-agent status
curl http://127.0.0.1:19527/v1/health

Healthy response looks like:

{ "ok": true, "paired": false, "allowCustomPaths": true }

paired becomes true after you complete Pair this computer.

Important notes

• Internet required during install (downloads script, agent, runner, browsers).
• Prefer the user-local checkbox for a quick install without admin.
• Pair and run from the same computer as the agent (localhost).
• The agent is a background service, not a desktop app you leave open.
• First install can take several minutes because of browser tooling.

Next

• Write your first test
• Editor setup (optional)
• What is Strikekit? — web app + agent overview