alprina history

View scan history and detailed results from previous security scans.

Synopsis


alprina history [OPTIONS]

Description

The alprina history command displays a list of all your previous security scans, including detailed information about findings, timestamps, and scan results. Use this to track your security posture over time, review past vulnerabilities, and monitor remediation progress.

Options

`--scan-id, -i`

View detailed information about a specific scan.


alprina history --scan-id abc123def456

`--limit, -l`

Number of scans to display (default: 20).


alprina history --limit 50

`--severity, -s`

Filter scans by minimum severity of findings.

Valid values: critical, high, medium, low


alprina history --severity high

`--page, -p`

Page number for pagination (default: 1).


alprina history --page 2 --limit 10

Examples

List Recent Scans

View your 20 most recent scans:


alprina history

Output:


📜 Scan History
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

ID         Date                 Target          Findings
────────────────────────────────────────────────────────
abc123     2025-11-12 14:30    ./src           3 (2 HIGH)
def456     2025-11-12 10:15    ./api           1 (1 CRITICAL)
ghi789     2025-11-11 16:45    ./frontend      5 (3 MEDIUM)
...

Showing 20 of 156 total scans
Use --page 2 to see more

View Specific Scan Details

Get detailed information about a particular scan:


alprina history --scan-id abc123def456

Output:


📊 Scan Details
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Scan ID:    abc123def456
Date:       2025-11-12 14:30:15 UTC
Target:     ./src
Profile:    code-audit
Duration:   12.3 seconds
Agent:      Code Security Agent

📋 Findings Summary
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Total:      3 vulnerabilities
Critical:   0
High:       2
Medium:     1
Low:        0

🔍 Vulnerabilities
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. HIGH - SQL Injection
   📍 src/database.py:42
   🔗 CWE-89
   
2. HIGH - Hardcoded Credentials
   📍 src/config.py:15
   🔗 CWE-798
   
3. MEDIUM - Weak Cryptography
   📍 src/auth.py:23
   🔗 CWE-327

Filter by Severity

Show only scans with high or critical findings:


alprina history --severity high

Paginate Results

View older scans:


# View 50 scans per page
alprina history --limit 50 --page 1
 
# Next page
alprina history --limit 50 --page 2

Combine Filters

Filter and paginate together:


alprina history --severity critical --limit 10 --page 1

Use Cases

Track Security Progress

Monitor how your security posture improves over time:


# View all scans
alprina history --limit 100
 
# Compare critical findings over time
alprina history --severity critical

Review Specific Vulnerability

Look up details about a past finding:


# Find the scan
alprina history | grep "2025-11-10"
 
# View its details
alprina history --scan-id <scan-id>

Generate Reports

Export scan history for reporting:


# View scan
alprina history --scan-id abc123
 
# Generate report
alprina report --format pdf --output security-report.pdf

Audit Trail

Maintain compliance by reviewing past scans:


# All scans from last month
alprina history --limit 1000 --page 1
 
# Filter by critical issues only
alprina history --severity critical --limit 100

Scan Data

Each scan entry includes:

Scan ID - Unique identifier for the scan
Timestamp - When the scan was performed (UTC)
Target - What was scanned (path, URL, IP)
Profile - Scan profile used
Duration - How long the scan took
Agent - Which security agent performed the scan
Findings Count - Number of vulnerabilities found
Severity Breakdown - Count by severity level
Status - Completed, failed, or in progress

Data Storage

Scan history is stored:

Locally: ~/.alprina/history/
Cloud: Synced to your Alprina account (if authenticated)

To clear local history:


rm -rf ~/.alprina/history/

Note: Cloud history remains available when authenticated.

Retention Policy

Free Tier: 30 days of history
Pro Tier: 1 year of history
Team+ Tier: Unlimited history

Export Scan History

Export to JSON for further analysis:


alprina history --scan-id abc123 --output scan-details.json

Integration with Other Commands

After Scanning


# Run a scan
alprina scan ./src
 
# View the result
alprina history --limit 1

Before Fixing


# Check what needs fixing
alprina history --severity high
 
# Fix the issues
alprina fix ./src --severity high

For Reports


# Find scan ID
alprina history
 
# Generate report
alprina report --scan-id abc123 --format html

Keyboard Shortcuts

When viewing history in interactive mode:

↑/↓ - Navigate scans
Enter - View scan details
f - Filter by severity
q - Quit
/ - Search scans

Performance

For large scan histories:


# Use pagination for better performance
alprina history --limit 20 --page 1
 
# Filter to reduce results
alprina history --severity critical

alprina scan - Run new scans
alprina report - Generate reports from scans
alprina fix - Fix vulnerabilities from past scans

Troubleshooting

”No scan history found”

You haven’t run any scans yet. Run alprina scan first.

”Scan ID not found”

The scan may have been deleted or the ID is incorrect. Check available scan IDs with alprina history.

History not syncing to cloud

Ensure you’re authenticated:


alprina auth status
alprina auth login  # if not authenticated