Installation

TestimoX can be deployed as a standalone CLI for ad-hoc assessments, a PowerShell module for automation, a .NET library for integrations, or a Windows Service for continuous monitoring.

CLI (Standalone Executable)

Download the latest CLI package from the GitHub releases page , then extract it and run it.

# After downloading the latest CLI package from GitHub Releases
Expand-Archive "$HOME\Downloads\TestimoX.zip" -DestinationPath "C:\Tools\TestimoX" -Force

# Optionally add the folder to PATH for the current session
$env:PATH += ";C:\Tools\TestimoX"

# Verify
TestimoX.exe --version

The CLI supports interactive mode by default and non-interactive runs for automation:

# Interactive mode
TestimoX.exe

# Non-interactive
TestimoX.exe --all --html-path "C:\Reports\assessment.html"

PowerShell Module

The PowerShell module provides consolidated cmdlets for assessments, configuration generation, comparisons, and service management.

# Install from PowerShell Gallery
Install-Module -Name TestimoX -Scope CurrentUser

# Import and verify
Import-Module TestimoX
Get-Command -Module TestimoX

The module supports both PowerShell 5.1 and PowerShell 7+ on Windows.

.NET Library (NuGet)

For custom C# applications or integrations, reference TestimoX as a NuGet package:

<PackageReference Include="TestimoX" Version="*" />

using TestimoX.Execution;

var catalog = await ToolingRuleService.DiscoverRulesAsync(new ToolingRuleDiscoveryRequest
{
    IncludeDisabled = true,
    Categories = new[] { "Security" }
});

Console.WriteLine($"Discovered rules: {catalog.ReturnedCount}");

Windows Service (Monitoring)

For continuous monitoring, deploy TestimoX as a Windows Service and manage it through the consolidated PowerShell cmdlets.

# Install the service
Initialize-TestimoXService -Install -ServicePath "C:\Apps\TestimoX.Service.exe"

# Generate and apply a service.json configuration
Get-TestimoXService -Path "C:\Configs\service.json" -Mode Daily -DailyTimes 01:00 -EnableAdSnapshot
Set-TestimoXService -Name TestimoX -ConfigPath "C:\Configs\service.json" -Restart

# Connect to the management API
Connect-TestimoXService -Url "http://127.0.0.1:7809/" -ApiKey (Get-Content C:\secret.txt -Raw)
Get-TestimoXService -Status

See the Monitoring Setup guide for detailed configuration.

System Requirements

Licensing

TestimoX uses portable .txlic license containers. For the CLI, you can install a license into the application directory with:

TestimoX.exe --license-set "C:\Licenses\TestimoX.txlic"
TestimoX.exe --license-info

See the Pricing page for edition comparison and license details.