Downloading the C++ Agent (Windows)

Two download strategies are available — choose based on your environment.

Strategy 1: Latest version

Use for quick starts, sandbox environments, or proof-of-concept work. Avoid this strategy in production pipelines because the version may change without notice.

PowerShell

$dest = "C:\SealightsAgent"
Invoke-WebRequest `
  -Uri "https://agents.sealights.co/slcpp/latest/sealights-cpp-agent-windows-self-contained.zip" `
  -OutFile "sealights-cpp-agent.zip"
Expand-Archive -Path "sealights-cpp-agent.zip" -DestinationPath $dest -Force

Azure DevOps

- task: PowerShell@2
  displayName: Download SeaLights C++ Agent (latest)
  inputs:
    targetType: inline
    script: |
      Invoke-WebRequest `
        -Uri "https://agents.sealights.co/slcpp/latest/sealights-cpp-agent-windows-self-contained.zip" `
        -OutFile "sealights-cpp-agent.zip"
      Expand-Archive -Path "sealights-cpp-agent.zip" `
        -DestinationPath "$(Agent.ToolsDirectory)\SealightsAgent" -Force

Strategy 2: Specific version (Recommended)

Use for production pipelines. Pinning the version keeps builds reproducible. Update the variable in one place to upgrade all pipelines.

PowerShell

$SL_CPP_VERSION = "0.5.9.1"
$dest = "C:\SealightsAgent"
Invoke-WebRequest `
  -Uri "https://agents.sealights.co/slcpp/v$SL_CPP_VERSION/sealights-cpp-agent-windows-self-contained.zip" `
  -OutFile "sealights-cpp-agent.zip"
Expand-Archive -Path "sealights-cpp-agent.zip" -DestinationPath $dest -Force
Write-Host "SeaLights C++ Agent $SL_CPP_VERSION installed to $dest"

Azure DevOps

variables:
  SL_CPP_VERSION: '0.5.9.1'

steps:
- task: PowerShell@2
  displayName: Download SeaLights C++ Agent $(SL_CPP_VERSION)
  inputs:
    targetType: inline
    script: |
      Invoke-WebRequest `
        -Uri "https://agents.sealights.co/slcpp/v$(SL_CPP_VERSION)/sealights-cpp-agent-windows-self-contained.zip" `
        -OutFile "sealights-cpp-agent.zip"
      Expand-Archive -Path "sealights-cpp-agent.zip" `
        -DestinationPath "$(Agent.ToolsDirectory)\SealightsAgent" -Force
      Write-Host "SeaLights C++ Agent $(SL_CPP_VERSION) installed"

After extracting

The self-contained agent package needs no .NET runtime installation. Reference SL.Agent.Cpp.exe by its full path in all subsequent commands. For example: C:\SealightsAgent\SL.Agent.Cpp.exe.

You can download .zip and .tar.gz archives from the same URL paths. Use .zip for Windows pipelines.

Next step: MSBuild Integration