v1.2.1 • Open Source

Security Health Monitor for Your Development Environment

Scan your installed software, detect vulnerabilities, and monitor your security posture — all from your terminal.

$ npm install -g manel
Get Started →

Powerful Security Features

Everything you need to keep your development environment secure.

🔍

Software Detection

Detects 21 technologies: Node.js, Python, Docker, PostgreSQL, and more — including package managers, databases, and development tools.

🛡️

Vulnerability Analysis

Checks against OSV, NVD, and GHSA databases for known CVEs in your installed software stack.

🔒

Hardening Checks

7 security checks for Linux: firewall status, SELinux, SSH configuration, kernel parameters, and more.

📊

Security Score

Weighted score combining all security aspects into one metric (0-100) with actionable recommendations.

Smart Local Cache

Vulnerability and version data cached 24h in local SQLite — repeat scans skip the network and avoid API rate limits.

📴

Offline Mode

manel sync downloads the full OSV database locally — --offline scans run with zero network requests.

📈

Scan History

Every scan is persisted locally — manel history shows past scores and findings to track your posture over time.

🤖

AI-Friendly Schema

manel schema outputs a JSON describing every command and flag — plug Manel into AI agents and automation.

Flexible Output Formats

Choose the format that fits your workflow.

table

Human-readable terminal output with colors and formatting.

Default
json

Pretty-printed JSON for scripts, APIs, and debugging.

Programmatic
sarif

Static Analysis Results Interchange Format for CI/CD integration.

CI/CD Ready
ndjson

Newline-delimited JSON for streaming and batch processing.

Streaming

How to Use Manel

Common workflows — from first setup to fully offline security checks.

1 Install & first setup

terminal
# Install globally from npm
npm install -g manel

# Download the offline vulnerability database (one time)
# Auto-detects ecosystems from your installed software
manel sync

Downloads the public OSV.dev database from Google's servers into ~/.manel/manel.db — nothing is bundled in the repo since CVEs are published daily. First sync takes a few minutes (npm is ~200 MB); re-run weekly.

2 Daily security check

terminal
# Quick overview of detected technologies
manel status

# Full scan: vulnerabilities + hardening + score
manel scan

3 Focus on what matters

terminal
# Only critical and high severity findings
manel vulns --severity CRITICAL,HIGH

# Fail the command (exit 1) if anything critical exists
# — perfect for pre-commit hooks and pipelines
manel scan --fail-on critical

4 Export & integrate

terminal
# SARIF report for GitHub Code Scanning
manel scan --format sarif --output scan.sarif

# JSON for scripts and dashboards
manel score --format json | jq .data.overall

5 Work fully offline

terminal
# Zero network requests — uses the synced local database
manel scan --offline

# Great for planes, secure networks, and CI without internet
manel vulns --offline --severity CRITICAL

Requires "manel sync" beforehand. Local data stays fresh for 7 days.

6 Track your posture over time

terminal
# List your last scans with scores and findings
manel history

# More entries, machine-readable
manel history --last 20 --format json

CI/CD Integration

Integrate Manel into your pipelines for automated security checks on every commit.

  • GitHub Actions compatible
  • Fail builds on critical vulnerabilities
  • Upload SARIF to GitHub Code Scanning
  • Works with any CI/CD platform
.github/workflows/security.yml
# GitHub Actions example
- name: Security Scan
  run: |
    npm install -g manel
    manel scan --format sarif \
      --output scan.sarif \
      --fail-on critical