🛡️ LeakGuard

LeakGuard is a professional, high-performance terminal-based secret scanning engine built strictly for Linux Operating Systems. It functions as a real-time monitoring agent that audits target GitHub users or entire corporate organizations for leaked critical credentials—including AWS keys, OpenAI tokens, Google API keys, Slack tokens, and exposed Database Connection Strings—using ultra-precise regex pattern-matching architectures.

Developed by Unknownx007.

---

📊 Terminal Dashboard Interface

Instead of deploying a heavy, resource-intensive web browser framework, LeakGuard features an interactive black-and-white Linux terminal dashboard layout. It displays live tracking data, active engine process lines, and instant vulnerability log updates smoothly in real time.

---

🔑 How to Generate Your GitHub Personal Access Token (PAT)

To scan repositories at maximum speed without hitting public API rate limitations, the engine requires a GitHub Token. Follow these exact steps to create a Classic Token with the correct scopes:

1. Log into your account on GitHub.com.
2. Click your profile picture in the top-right corner and select Settings.
3. Scroll to the bottom of the left sidebar and click Developer settings.
4. In the left menu, select Personal access tokens -> Tokens (classic).
5. Click the Generate new token dropdown button and choose Generate new token (classic).
6. Token Details Setup:
   • Note: Give it a clear name (e.g., LeakGuard-Scanner).
   • Expiration: Set your preferred expiration limit (e.g., 30 days).
7. Select Scopes (Crucial Step):
   • Check the parent box for repo (This automatically selects repo:status, repo_deployment, public_repo, repo:invite, and security_events). This grants access to read target repository code trees.
8. Scroll to the absolute bottom of the page and click Generate token.
9. ⚠️ Copy the generated token immediately! GitHub will hide this token permanently once you refresh or navigate away from the page.

---

📦 Local Installation Guide

Modern Linux distributions require Python dependencies to be safely separated within isolated environments. Follow these commands to set up the engine workspace:

# 1. Clone this repository
git clone https://github.com/Unknownx007/LeakGuard
cd LeakGuard

# 2. Configure and isolate the python virtual environment layer
python3 -m venv .venv
source .venv/bin/activate

# 3. Pull required microservice modules securely
pip install -r requirements.txt

# 4. Initialize the scanner setup engine
python3 leakguard.py

---

🚀 Operational Workflow

1. Upon executing python3 leakguard.py, a branded initialization manager will display within the terminal.
2. Input the target GitHub Username or Organization Name you wish to monitor.
3. Paste the Personal Access Token (PAT) you generated using the steps above.
4. Hit Enter. The console window will immediately wipe and launch the live security telemetry grid.
5. Discovered secrets instantly trigger an internal terminal audio alert and log persistently to leaks/leak_report.txt.
6. Press q at any point to gracefully terminate background worker loops and close the application.

---

📜 License

Distributed under the MIT License. See LICENSE for more details.