🚨 Parallel .git Exposure Scanner & Dumper (Military-Grade UI + Resumable State)
xposedRepo.py is a high-performance tool that scans targets in parallel for exposed .git repositories and optionally dumps their contents. It features a "Hardcore Tech" dashboard with industrial aesthetics for real-time reconnaissance.
- Industrial UI: Heavy-duty tables with high-contrast headers (White on Blue).
- Live Intel: Real-time progress bars with "M of N" counters (e.g.,
15/45). - Recon Columns: Instantly see critical intel:
- STATUS:
VULNERABLE(Red) /SUSPICIOUS(Yellow) - SERVER:
nginx,Apache,Cloudflare(Magenta) - TIME: Discovery timestamp (Dim White)
- STATUS:
- Clean Exit:
Ctrl+Cexits immediately without leaving terminal artifacts. Results already written to the.statefile are kept; in-flight probes and dumps are abandoned.
- Parallel Execution: Scans hundreds of targets concurrently (default: 50 threads).
- Resumable: Progress is saved to the
.statefile immediately. The default state file is timestamped per run, so pass--state-file <file>to resume a previous scan (the path is printed when a scan ends). - Smart Detection: Checks
/.git/,HEAD,configand pack files. Redirects are not followed, HTML responses are rejected on paths that are never HTML, andHEADmust contain a real symbolic ref or a bare 40-hex object ID -- so 200-status "soft 404" pages are not reported as findings.
- --dump: Automatically triggers the standard
git-dumperlogic for vulnerable targets. - Artifact Recovery: Extracts commits and objects to a local directory.
- Commit Counting: Displays the number of extracted commits (e.g.,
Dumped target.com ✓ (120 commits)).
- Clone the repository:
git clone https://github.com/your-repo/xposed.git cd xposed - Install Dependencies:
pip3 install -r requirements.txt
- Requires
rich,requests,dulwich(for dumper).
- Requires
Scan a list of targets and see the live dashboard.
python3 xposedRepo.py -i targets.txtScan targets and automatically dump the source code of vulnerable ones.
python3 xposedRepo.py -i targets.txt --dumpNote: Dumps are saved to the current directory (or
--output-dir) with a timestamped folder name.
Dump a specific target immediately.
python3 xposedRepo.py -u http://target.com --dumppython3 xposedRepo.py -i targets.txt -t 100 --timeout 10 --state-file operation_alpha.state| Flag | Description | Default |
|---|---|---|
-i / --input |
List of targets (one per line) | - |
-u / --url |
Single target URL | - |
--dump |
Enable auto-dumping of artifacts | False |
-t / --threads |
Number of worker threads | 50 |
-T / --timeout |
Request timeout (seconds) | 5 |
--output-dir |
Directory to save dumps | ./<domain>-xposed-<time> |
--csv |
Write a CSV report when the scan finishes | False |
--rate-limit |
Cap HTTP requests per second across all workers (0 = unlimited). Each target costs up to 5 requests. | 0 |
--resolve |
Resolve IPs for findings and show the IP column | False |
--state-file |
State file to resume from | .state_<timestamp> |
--max |
Stop after N targets from the input file | 0 (all) |
A heavy-duty terminal UI showing:
- Target Status:
VULNERABLE/SUSPICIOUS - Server Tech: e.g.,
nginx/1.18 - Action:
Dumping...orLogged
With --csv, results are written to a CSV file (e.g., 28-Dec-2025-RepoXpose.csv).
Fields containing commas or quotes are properly quoted, so the url column is
always the third field.
status,code_or_message,url
VULNERABLE,200,https://victim.com
SUSPICIOUS,403,https://example.orgRaw log for resuming scans.
VULNERABLE,200,https://victim.com
OK,404,https://safe.com
This tool is for security research and authorized testing only. Usage against systems without permission is illegal. The author assumes no liability for misuse.