Install the CLI

The WinkPG integrator CLI, winkpg-integrator, forwards webhook events to your machine, sends sample events to your handler, checks that the handler is ready to ship, and connects your AI tools to the MCP server. Install it as a .NET tool, or download a single executable for your operating system.

The CLI isn't published here

This WinkPG deployment doesn't publish the integrator CLI, so there's nothing to install from it. Ask whoever operates the deployment where to get the CLI.

Install it as a .NET tool

Use this route if you have the .NET 9 SDK or later. The tool runs on the .NET you already have, so it gets runtime security updates when you install them, and one command updates the tool itself.

Install

Update

Both commands name this environment's package feed. Keep the --add-source option when you copy them: without it, .NET looks for the tool on nuget.org, where it isn't published.

Check the installation

winkpg-integrator --version

Package feed

If your NuGet configuration uses package source mapping, .NET refuses --add-source. Add the package feed as a source in that configuration and map the WinkPG.Integrator.Cli package to it, then run the command without the option.

Download an executable

Each archive holds a single executable for one operating system and chip, with the .NET runtime built in, so you don't need .NET installed. This is version .

Operating system	Chip	Download	Size	SHA-256

Every checksum for this version, in one file: SHA256SUMS

Verify the download

Compare the archive's SHA-256 with the value in the table before you extract it. If they differ, the download is incomplete or the file was changed: delete it and download it again.

macOS and Linux

shasum -a 256 winkpg-integrator-*-.tar.gz

Windows PowerShell

Get-FileHash .\winkpg-integrator-*-.zip -Algorithm SHA256

Put it on your PATH

Extract the archive, then move the executable to a folder on your PATH so you can run it from any directory. Run the commands from the folder you downloaded the archive to.

macOS and Linux

tar -xzf winkpg-integrator-*-.tar.gz
mkdir -p ~/.local/bin
mv winkpg-integrator ~/.local/bin/

If ~/.local/bin isn't on your PATH, add it in your shell's profile file, for example ~/.zshrc or ~/.bashrc, and open a new terminal.

On macOS, a file you download in a browser is quarantined, and macOS blocks the executable the first time it runs. After you've verified the download, clear the quarantine flag:

macOS

xattr -d com.apple.quarantine ~/.local/bin/winkpg-integrator

Windows PowerShell

$dir = "$env:LOCALAPPDATA\winkpg-integrator"
Get-ChildItem .\winkpg-integrator-*-.zip | Expand-Archive -DestinationPath $dir
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;$dir", "User")

Open a new terminal so it reads the updated PATH.