CLI OPERATIONS

Execute security assessments directly from your terminal or CI environment.

The TrustNode CLI is the primary interface for triggering security operations, managing repositories, and verifying findings. It securely communicates with the local engine.

CORE COMMANDS

trustnode scan

Initiates a security assessment against a target repository, or checks the status of an ongoing scan.

Usage 
trustnode scan <action_or_target> [<scan_id>]

Arguments:

  • action_or_target: Repository URL to scan, or "status".
  • scan_id: Scan ID (only if action is "status").

trustnode scan:local-upload

Upload a local zip archive for scanning.

Usage 
trustnode scan:local-upload <archive> <target>

trustnode findings

Displays a list of real discovered vulnerabilities and evidence paths across scanned targets.

Usage 
trustnode findings [options]

Options:

  • --severity: Filter by severity (e.g. critical, high).
  • --repository: Filter by repository name.
  • --scan: Filter by scan ID.

trustnode report

Request report generation, check generation status, or download a compiled report.

Usage 
trustnode report <action_or_scan_id> [<scan_id>]

Options:

  • -o, --output: Output file path (only used during download).

trustnode repositories

Lists all currently configured and available repositories.

Usage 
trustnode repositories

AUTHENTICATION

trustnode login / logout

Login using an API token, or revoke the current token.

Usage 
trustnode login
trustnode logout

trustnode whoami

Get current authenticated user information.

Usage 
trustnode whoami

MAINTENANCE COMMANDS

trustnode status

Show TrustNode installation and application status.

Usage 
trustnode status

trustnode doctor

Diagnose CLI authentication and connectivity.

Usage 
trustnode doctor

trustnode repair

Repair local CLI authentication by recreating tokens.

Usage 
trustnode repair

trustnode update

Update TrustNode to the latest release.

Usage 
trustnode update

COMING SOON

The following commands are currently in development and are not available in the current release.

  • trustnode compliance - Show compliance matrix. Coming Soon
  • trustnode fix - Remediate a finding. Coming Soon