Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/DevDonzo/warden/llms.txt

Use this file to discover all available pages before exploring further.

The status command gives you a quick, human-readable snapshot of Warden’s state in the current directory. It reads the last five scan result files from the scan-results/ folder, checks whether a .wardenrc.json configuration file is present, and reports whether the required environment tokens are set — all without running a scan or modifying any files.
status reads from the current working directory. Run it from your project root (the same directory where you run warden scan) to see accurate results.

Synopsis

warden status

Flags

status takes no flags.

What it displays

Recent Scans

Warden looks for the scan-results/ directory in the current working directory. If it exists and contains .json files, the five most recent files are listed in reverse-chronological order (newest first). For each file, Warden reads:
  • Filename — the scan result file name.
  • Vulnerability count — taken from summary.total when present, or the length of the vulnerabilities array as a fallback.
  • Date — derived from the timestamp field inside the file, or from the filename itself if no timestamp is present.
If the directory exists but contains no JSON files, Warden prints No scan history found. If the directory does not exist at all, Warden prompts you to run warden scan first.

Configuration

Warden checks for a .wardenrc.json file in the current directory:
  • Found✓ .wardenrc.json found
  • Not found⚠ No .wardenrc.json (using defaults)
A missing config file is not an error — Warden falls back to built-in defaults for all options.

Environment

Warden checks for two environment variables and reports their presence without revealing their values:
VariableSetNot set
GITHUB_TOKEN✓ Set✗ Not set
SNYK_TOKEN✓ Set✗ Not set

Example output

Fully configured project with scan history

📊 Warden Status

─── Recent Scans ───────────────────────────────────────────
  scan-results-2025-07-14T06-00-00.json: 3 vulnerabilities (7/14/2025)
  scan-results-2025-07-07T06-00-00.json: 5 vulnerabilities (7/7/2025)
  scan-results-2025-06-30T06-00-00.json: 5 vulnerabilities (6/30/2025)
  scan-results-2025-06-23T06-00-00.json: 8 vulnerabilities (6/23/2025)
  scan-results-2025-06-16T06-00-00.json: 8 vulnerabilities (6/16/2025)

─── Configuration ──────────────────────────────────────────
  ✓ .wardenrc.json found

─── Environment ────────────────────────────────────────────
  GITHUB_TOKEN: ✓ Set
  SNYK_TOKEN: ✓ Set

Fresh project, no scans yet

📊 Warden Status

No scan results directory found. Run "warden scan" first.

─── Configuration ──────────────────────────────────────────
  ⚠ No .wardenrc.json (using defaults)

─── Environment ────────────────────────────────────────────
  GITHUB_TOKEN: ✓ Set
  SNYK_TOKEN: ✗ Not set

Project with scans but an unreadable result file

If a scan result file exists but cannot be parsed (for example, because it was truncated or corrupted), Warden prints Unable to parse next to that filename rather than failing:
  scan-results-broken.json: Unable to parse

Combining status with other commands

status is a read-only, zero-side-effect command. A typical workflow might look like:
# Check the current state before scanning
warden status

# Run a scan
warden scan --scanner npm-audit --severity high

# Confirm the new result appears
warden status
You can also use warden status to quickly verify that environment tokens are present before handing off to CI, or to confirm that a previous scan produced output before running warden baseline --create.

Build docs developers (and LLMs) love