Skip to content

tulu-g559/WrathOps-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

28 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

β–ˆβ–ˆβ•—    β–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—  β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ•—  β–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—
β–ˆβ–ˆβ•‘    β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—β•šβ•β•β–ˆβ–ˆβ•”β•β•β•β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β•β–ˆβ–ˆβ•—β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—β–ˆβ–ˆβ•”β•β•β•β•β•
β–ˆβ–ˆβ•‘ β–ˆβ•— β–ˆβ–ˆβ•‘β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•”β•β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•”β•β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—
β–ˆβ–ˆβ•‘β–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β•β• β•šβ•β•β•β•β–ˆβ–ˆβ•‘
β•šβ–ˆβ–ˆβ–ˆβ•”β–ˆβ–ˆβ–ˆβ•”β•β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘β•šβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•”β•β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘
 β•šβ•β•β•β•šβ•β•β• β•šβ•β•  β•šβ•β•β•šβ•β•  β•šβ•β•   β•šβ•β•   β•šβ•β•  β•šβ•β• β•šβ•β•β•β•β•β• β•šβ•β•     β•šβ•β•β•β•β•β•β•

πŸ” AI-Powered Secret Detection, Understanding, and Prevention


License Python PyPI pre-commit Security


Stop secrets before they stop you. WrathOps doesn't just detect β€” it understands, explains, and protects.



⚑ Why WrathOps?

Most security tools scream at you with a vague Secret detected and leave you stranded. WrathOps is built differently.

Traditional Tools    β†’    "Secret detected. Good luck."
WrathOps             β†’    "Here's what it is, how dangerous it is,
                           whether it's active, and exactly how to fix it."
Question WrathOps Answers It
🎯 What is it? Identifies the exact provider and secret type
⚠️ How dangerous? Classifies risk from 0–100 with confidence scoring
πŸ’₯ Why does it matter? Explains real-world impact in plain language
πŸ” Is it even active? Validates key status without external exposure
πŸ”§ How do I fix it? Guides you toward safe, immediate remediation

🧠 Key Features


01 β€” Context-Aware Secret Detection

Beyond regex. WrathOps reads the room.

  • Distinguishes test keys from production keys
  • Understands intent based on file type and usage context
  • Adapts detection logic per developer environment

02 β€” AI-Based Risk Classification

Every finding gets an intelligent verdict:

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  Classifications                            β”‚
β”‚                                             β”‚
β”‚  🟒  fake_or_test       β†’ Safe to ignore    β”‚
β”‚  🟑  expired_or_invalid β†’ Low priority      β”‚
β”‚  πŸ”΄  real_and_dangerous β†’ Act immediately   β”‚
β”‚                                             β”‚
β”‚  + Risk Score    (0 – 100)                  β”‚
β”‚  + Confidence Score                         β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

03 β€” Developer-Friendly Explanations

No jargon. No vague warnings. Just clarity:

πŸ’¬  "This appears to be a production AWS key. If exposed, attackers
     could access your cloud infrastructure and incur billing charges."

04 β€” Safe Validation Layer

Key status β€” determined without sending your secrets anywhere:

  • βœ… Likely Active β€” Matches known production patterns
  • ⚠️ Likely Inactive β€” Test/example pattern detected
  • ❓ Unknown β€” Valid format, status unverified

05 β€” False Positive Reduction

Tired of your example docs getting flagged?

  • Detects known dummy/test key patterns automatically
  • Filters noise so you focus on real threats only

06 β€” Pre-Commit Protection

Write code β†’ Stage changes β†’ WrathOps checks β†’ βœ… Clean commit  OR  ❌ Blocked
  • Runs entirely locally β€” fast and lightweight
  • Stops secrets at the source, before they ever touch a remote

βš™οΈ How It Works

  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  β”‚              β”‚     β”‚                  β”‚     β”‚                  β”‚     β”‚                  β”‚
  β”‚  DETECTION   │────▢│  CLASSIFICATION  │────▢│  EXPLANATION     │────▢│  VALIDATION      β”‚
  β”‚              β”‚     β”‚                  β”‚     β”‚                  β”‚     β”‚                  β”‚
  β”‚  Scans your  β”‚     β”‚  AI determines   β”‚     β”‚  Human-readable  β”‚     β”‚  Safely checks   β”‚
  β”‚  codebase    β”‚     β”‚  severity &      β”‚     β”‚  risk summary    β”‚     β”‚  key format &    β”‚
  β”‚  for secrets β”‚     β”‚  category        β”‚     β”‚  is generated    β”‚     β”‚  status          β”‚
  β”‚              β”‚     β”‚                  β”‚     β”‚                  β”‚     β”‚                  β”‚
  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ’» Getting Started

Installation

pip install git+https://github.com/tulu-g559/WrathOps-cli.git
wrathops install

Scan a File or Directory

wrathops scan ./my_project

Pre-Commit Setup (Recommended)

Add to your .pre-commit-config.yaml:

repos:
  - repo: https://github.com/your-org/wrathops
    rev: v1.0.0
    hooks:
      - id: wrathops

Then install the hook:

pre-commit install

πŸ› οΈ Example Output

🚨 Secrets Detected in ./app.py
════════════════════════════════════════════════════════════

  β†’ AWS_SECRET_KEY
    Risk: 100/100  β”‚  Class: real_and_dangerous  β”‚  Confidence: 0.99
    ──────────────────────────────────────────────────────
    This appears to be a production AWS secret key. If exposed,
    attackers could access your cloud resources and incur costs.
    Status: ❓ Unknown (valid format, not externally verified)

  β†’ GOOGLE_API_KEY
    Risk: 82/100   β”‚  Class: real_and_dangerous  β”‚  Confidence: 0.82
    ──────────────────────────────────────────────────────
    This appears to be a Google API key. It could allow access to
    your services and lead to data exposure or abuse.
    Status: ⚠️ Likely Inactive (test/example pattern detected)

════════════════════════════════════════════════════════════
❌ Commit blocked: 2 secret(s) detected. Remediate before committing.

πŸ”’ Safety & Privacy

WrathOps is designed with absolute privacy at its core.

βœ…  No secrets stored         β€” ever.
βœ…  No external API calls     β€” your keys never leave your machine.
βœ…  Fully local execution     β€” runs entirely on your system.
βœ…  Masked outputs & logs     β€” sensitive values are never printed raw.

Your code is your business. WrathOps keeps it that way.


πŸ“¦ Use Cases & Target Audience

Who Is It For?

Audience Use Case
πŸ‘¨β€πŸ’» Jr. Software Engineers Lightweight, noise-free pre-commit security hook
πŸŽ“ Students & Learners Learn security best practices and env variable hygiene
πŸ‘” Engineering Managers Improve team-wide security culture and code hygiene

When Should You Use It?

  • Before pushing any code to GitHub / GitLab
  • To secure hackathon, student, or beginner projects
  • As a final safety net in any development workflow

πŸš€ Roadmap

The vision for WrathOps is to become a complete Developer Security Assistant.

  • Automated Fix Generation β€” Move hardcoded secrets to .env and replace with os.getenv() automatically
  • GitHub PR Remediation β€” Automated PR comments explaining risks, natively in GitHub
  • CI/CD Integration β€” Native GitHub Actions and GitLab CI plugins
  • Provider-Level Safe Validation β€” Secure, non-intrusive validation against AWS, OpenAI, and more
  • Org-Level Analytics β€” Dashboards to monitor security hygiene trends across teams


Built for developers who care about security β€” without sacrificing speed.


WrathOps β€” Detect. Understand. Prevent.


Star on GitHub

About

Never let your secrets leave your local codebase, if left WrathOps will delete that file in commit and make secreats env exchangable

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors