Using the Command-Line Scanner

True Protection by Jag includes a powerful command-line interface (CLI) that allows you to run scans, manage quarantine, and update definitions from the terminal. This is particularly useful for server environments, automated scripts, and CI/CD pipelines.

Basic Commands

tpjscan --quick - Run a quick scan
tpjscan --full - Run a full system scan
tpjscan --path /path/to/scan - Scan a specific path
tpjscan --update - Update threat definitions
tpjscan --status - Show protection status and last scan results
tpjscan --quarantine list - List quarantined items
tpjscan --quarantine restore [id] - Restore a quarantined item

Advanced Options

--output json - Output results in JSON format for parsing by scripts
--output csv - Output results in CSV format
--exclude /path/to/skip - Exclude a path from the scan
--severity high - Only report findings at high severity or above
--archive-depth 3 - Set the maximum archive nesting depth
--quiet - Suppress progress output, only show results
--exit-code - Return a non-zero exit code if threats are found (useful for CI/CD)

CI/CD Integration Example

Add a scan step to your build pipeline to check artifacts before deployment:

Run tpjscan --path ./build/output --exit-code --output json --severity high
If the exit code is non-zero, the build fails and the JSON output contains details about detected threats.

The CLI is installed alongside the main application. On Windows, it is located at C:\Program Files\True Protection\tpjscan.exe. On macOS and Linux, it is available as /usr/local/bin/tpjscan.