---
name: security:dashboard
description: Cross-project security dashboard — machine-wide posture overview with per-project grades
allowed-tools: Read, Glob, Grep, Bash
model: sonnet
---

# /security dashboard

Machine-wide security dashboard. Discovers all Claude Code projects, runs posture-scanner on each, shows aggregated overview.

## Step 1: Run Dashboard Aggregator

Run the aggregator (uses 24h cache by default):

```
node <this plugin's scanners/dashboard-aggregator.mjs>
```

If user specified `--no-cache` or `--fresh`, add `--no-cache` flag.

Parse the JSON output. The result contains:
- `meta.scanner`, `meta.version`, `meta.timestamp`, `meta.from_cache`
- `machine.grade` (weakest link), `machine.projects_scanned`, `machine.total_findings`, `machine.counts`
- `projects[]` with path, display_name, grade, risk_score, risk_band, worst_category, worst_status, findings_count, counts
- `errors[]` with path, display_name, error

## Step 2: Format Dashboard

Present the results:

```
# Security Dashboard

| Field | Value |
|-------|-------|
| **Machine Grade** | [A-F] (weakest link) |
| **Projects Scanned** | [N] |
| **Total Findings** | [N] |
| **Scan Time** | [N]ms |
| **Cache** | [Fresh scan / Cached (age)] |

## Project Overview

| Project | Grade | Risk | Worst Category | Findings |
|---------|-------|------|----------------|----------|
[one row per project, sorted by grade (worst first)]

## Errors

[List any projects that failed to scan, if any]
```

Sort the project table by grade (F first, A last), then by risk score descending.

## Step 3: Recommendations

- If machine grade is A/B: "Machine posture is solid. Re-run after major changes or new plugin installs."
- If machine grade is C: "Some projects need attention. Run `/security posture` in the worst-graded project."
- If machine grade is D/F: "Significant exposure. Run `/security audit` in projects graded D/F."
- If from_cache: "Results cached. Run `/security dashboard --fresh` for a live scan."
