seculint 0.3.1

Local secret & privacy leak scanner with optional AI verification

🔒 SecuLint — Secret & Privacy Leak Scanner

Version 0.3.0 — New filters, debugging tools, JSON reporting & pattern configs!

---

📦 Installation

pip install seculint

Run a quick scan:

seculint --path .

Enable AI mode:

seculint --path . --enable-ai

---

📝 What is SecuLint?

SecuLint is a fast, offline-first secret & privacy leak scanner detecting:

• Hard-coded credentials
• API keys & OAuth tokens
• JWTs, bearer tokens
• Database passwords & URIs
• Private keys (RSA/PEM)
• Personal data

Outputs include: terminal, JSON reports, HTML reports, and optional AI verification.

---

🚀 Key Features

• Recursive scanning
• JSON/HTML outputs
• AI-based verification
• Custom pattern configs
• Changed-only scanning
• Debug ignore mode
• Extension filtering
• Fast & offline

---

🛠️ CLI Arguments

Includes:

• --path
• --enable-ai
• --changed-only
• --debug-ignore
• --include-ext
• --exclude-ext
• --max-size
• --config
• --json-report

---

🧩 Pattern Config Example

{
  "patterns": {
    "AWS_SECRET_KEY": { "enabled": true, "severity": "HIGH" },
    "PRIVATE_KEY": { "enabled": true, "severity": "CRITICAL" }
  }
}

---

📊 JSON Report Example

seculint --path . --json-report reports/findings.json

---

🧪 Example Full Command

seculint --path .   --include-ext .py .json   --exclude-ext .log   --changed-only   --debug-ignore   --config config/patterns.json   --json-report reports/findings.json   --enable-ai

---

🗂️ Recommended .seculintignore

venv/
dist/
build/
__pycache__/
*.log
*.cache/
node_modules/

---

📚 Version History

• v0.3.0 — Added filters, JSON reports, config engine, debug-ignore
• v0.2.0 — Added AI mode
• v0.1.0 — Initial release

---

License

MIT License.