Install Verfy in three steps
Pick your system and do the steps in order. Copy each box with its button, paste it into the window named above it and press Enter.
If the window asks about pasting several lines at once, choose Paste anyway.
Windows
Open PowerShell: press Start, type PowerShell and open Windows PowerShell. You do not need to run it as administrator. Not Command Prompt (cmd): these commands are for PowerShell.
Download the installer and read it
cd ~ irm https://verfy.dev/install.ps1 -OutFile install.ps1 notepad install.ps1Notepad opens with the installer. Read what it does, then close Notepad.
Install
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force & "$HOME\install.ps1"The first line lets scripts run in this window only; your Windows settings do not change. The installer checks the download, puts verfy in
%LOCALAPPDATA%\Programs\verfyand adds it to your PATH.Check it and set it up
verfy --version verfy initverfy --versionprints the version, for exampleverfy 0.23.1.verfy initcreates your signing key and a starter policy, and asks how Verfy should update.
macOS and Linux
For Macs with Apple silicon (M1 and newer) and Linux on x64 or ARM64. On an Intel Mac, install with Python.
Open Terminal: on a Mac press Cmd + Space and type Terminal; on Linux open your terminal app.
Download the installer and read it
cd ~ curl -fsSLO https://verfy.dev/install.sh less install.shThe installer opens in the terminal. Read it with the arrow keys, then press
qto close it.Install
sh install.shThe installer checks the download, puts verfy in
~/.local/binand adds that folder to your shell profile.Check it and set it up
export PATH="$HOME/.local/bin:$PATH" verfy --version verfy initThe first line tells this window where verfy is; new windows find it on their own.
verfy initcreates your signing key and a starter policy.
Next: guard every agent on this computer
This one command finds Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot and Devin Desktop (Windsurf), adds the Verfy check to each and puts their MCP servers behind the gateway. A backup of every changed file is kept. Without --write it only shows what it would change. Restart the agents afterwards. From then on there is nothing to type: the agent asks Verfy before each tool call.
verfy setup --writeIn VS Code, Cursor or Devin Desktop you can also download the Verfy extension and install it with Extensions > ... > Install from VSIX: it does the same and can open the terminal inside the sandbox (beta). Each agent one by one, MCP servers, CI and Verfy Cloud are in the docs.
With Python instead
With Python 3.10 or newer you can install verfy from PyPI. Use this on an Intel Mac, or when Windows blocks the installer.
Windows (PowerShell)
python -m pip install verfy
python -m verfy --version
python -m verfy initmacOS and Linux (Terminal)
pipx install verfy
export PATH="$HOME/.local/bin:$PATH"
verfy --version
verfy initOn Windows, type python -m verfy wherever these pages say verfy. On macOS and Linux, if you do not have pipx, get it first: brew install pipx or sudo apt install pipx.
If something goes wrong
'irm' is not recognized- You are in Command Prompt (cmd). Open PowerShell and paste the commands again.
running scripts is disabled on this system- The first line of step 2 was left out. Copy step 2 with its button and paste both lines together.
'verfy' is not recognized / verfy: command not found- Step 2 did not finish: read the last lines it printed. On macOS and Linux, run the first line of step 3.
An Application Control policy has blocked this file- Windows Smart App Control or an antivirus blocked the program. Install with Python instead.
there is no standalone build for Intel Macs yet- Install with Python.
Why not one line
When an agent runs a script from the internet without reading it, Verfy asks about it (rule VFY-SH-005), so the installer is downloaded first and run second. It takes the build for your system from verfy-releases and checks its SHA-256, and its build attestation when a signed-in GitHub CLI is there. How to check a release yourself: Security.