{"id":29861190,"url":"https://github.com/atharvbyadav/ghostpath","last_synced_at":"2025-07-30T04:13:05.161Z","repository":{"id":286770601,"uuid":"962477088","full_name":"atharvbyadav/GhostPath","owner":"atharvbyadav","description":"👻 GhostPath — A powerful modular reconnaissance toolkit built for hackers, OSINT professionals \u0026 bug bounty hunters — passive + active recon in a sleek CLI shell. Discover subdomains, probe paths, mine archives and hunt certificates — all from one interactive terminal interface.","archived":false,"fork":false,"pushed_at":"2025-07-09T13:47:20.000Z","size":5143,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-28T15:55:20.664Z","etag":null,"topics":["bug-bounty","cli-tool","commoncrawl","cybersecurity","ethical-hacking","ghostpath","hacking","historical-data","information-gathering","infosec","osint","passive-recon","reconnaissance","web-recon"],"latest_commit_sha":null,"homepage":"https://atharvbyadav.github.io/GhostPath/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/atharvbyadav.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-08T08:04:07.000Z","updated_at":"2025-07-13T13:17:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"42fc55d0-2b6d-4934-8b00-32497a8bad9f","html_url":"https://github.com/atharvbyadav/GhostPath","commit_stats":null,"previous_names":["atharvbyadav/ghostpath"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/atharvbyadav/GhostPath","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atharvbyadav%2FGhostPath","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atharvbyadav%2FGhostPath/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atharvbyadav%2FGhostPath/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atharvbyadav%2FGhostPath/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atharvbyadav","download_url":"https://codeload.github.com/atharvbyadav/GhostPath/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atharvbyadav%2FGhostPath/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267808420,"owners_count":24147391,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-30T02:00:09.044Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bug-bounty","cli-tool","commoncrawl","cybersecurity","ethical-hacking","ghostpath","hacking","historical-data","information-gathering","infosec","osint","passive-recon","reconnaissance","web-recon"],"created_at":"2025-07-30T04:13:04.536Z","updated_at":"2025-07-30T04:13:05.140Z","avatar_url":"https://github.com/atharvbyadav.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch2 align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/atharvbyadav/GhostPath/blob/gh-pages/GhostPath-New.png\" alt=\"GhostPath Logo\" width=\"700\"/\u003e\n\u003c/h2\u003e\n\n\u003cH3\u003e\n\u003cp align=\"center\"\u003e\n  \u003ci\u003e\u003cb\u003eGhostPath\u003c/b\u003e — A Modern Interactive Reconnaissance Toolkit for Hackers \u0026 Security Researchers 🕵️‍♂️\u003c/i\u003e\n\u003c/p\u003e\n\u003c/H3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-BSD%203--Clause-blue.svg\" alt=\"License\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/python-3.8%2B-blue\" alt=\"Python\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/type-Passive%20%2F%20Active%20Recon-yellow\" alt=\"Recon Type\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/modules-TimeTrail%20|%20CertTrack%20|%20PathProbe%20|%20DomainScope-orange\" alt=\"Modules\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/focus-OSINT%20Recon-red\" alt=\"Focus\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/debug-Verbose%20Logs%20Available-lightgrey\" alt=\"Debug\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-Linux%20|%20WSL%20|%20MacOS-lightgreen\" alt=\"Platform\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/status-Under%20Active%20Development-brightgreen\" alt=\"Status\"\u003e\n\u003c/p\u003e\n\n---\n\n## 🧠 What is GhostPath?\n\n**GhostPath** is a professional-grade CLI reconnaissance toolkit designed for cybersecurity researchers, penetration testers and bug bounty hunters. It provides a modular, extensible and interactive shell to run recon operations in an intuitive and streamlined way.\n\n💡 Powered by Python and focused on speed, clarity and results.\n\n---\n\n## ✨ Features\n\n- 🔍 Interactive hacker-style CLI shell\n- 🔗 Passive and active recon modules\n- 🧩 Modular architecture with shared utilities\n- 📁 Output saving in TXT, JSON, CSV\n- 🚀 Multithreaded path probing with live feedback\n- 🧾 Certificate transparency \u0026 subdomain discovery\n- 🌐 Wayback, URLScan and CommonCrawl support\n- 🧠 Built-in wordlist fallback \u0026 auto-detection\n- 🔧 `pipx`-installable for global CLI use\n- ✅ `--help`, `--version` and `update` command support\n\n---\n\n## 🚀 Installation (Recommended: pipx)\n\nUse **pipx** for a clean, isolated global installation:\n\n```bash\n# Install pipx (if not already)\nsudo apt install pipx\npipx ensurepath\nsource ~/.bashrc  # or ~/.zshrc\n\n# Clone and install GhostPath\ngit clone https://github.com/atharvbyadav/GhostPath.git\ncd GhostPath\npipx install .\n````\n\n### ✅ Run from anywhere:\n\n```bash\nGhostPath\n```\n\n---\n\n\u003cimg src=\"https://github.com/atharvbyadav/GhostPath/blob/gh-pages/GhostPath-TerminalLogo.png\" alt=\"GhostPath Terminal Banner\" width=\"100%\"/\u003e\n\n---\n\n## 🐍 Running without pipx (Direct Script Mode)\n\nIf you prefer not to use pipx, you can run GhostPath directly using Python:\n\n### 1. Clone the repository\n\n```bash\ngit clone https://github.com/atharvbyadav/GhostPath.git\ncd GhostPath\n```\n\n### 2. (Optional) Create a virtual environment\n\n\u003e Highly recommended to isolate dependencies.\n\n```bash\npython3 -m venv venv\nsource venv/bin/activate\n```\n\n### 3. Install the dependencies\n\n```bash\npip install -r requirements.txt\n```\n\n### 4. Run the GhostPath CLI shell\n\n```bash\npython3 main_cli.py\n```\n\n---\n\n## 💻 Usage Overview\n\nOnce inside the shell:\n\n```bash\nghostpath\u003e help\n```\n\nYou’ll see:\n\n```\n🧩 Available GhostPath Commands:\n  timetrail      → Fetch historical URLs from archives (Wayback, URLScan, Common Crawl)\n  domainscope    → Discover subdomains \u0026 DNS profiling\n  pathprobe      → Actively probe directories and endpoints\n  certtrack      → Get subdomains from public SSL/TLS certs\n  version        → Show current installed version\n  clear          → Clear the screen\n  help           → Show this help menu\n  exit           → Exit GhostPath CLI\n```\n\n---\n\n## 🧩 Modules\n\n### 🕰️ `timetrail`\n\nFetch historical URLs from:\n\n* Common Crawl *(default)*\n* Wayback Machine\n* URLScan.io\n\n```bash\ntimetrail --target example.com\ntimetrail --target example.com --source wayback --output urls.json --format json\n```\n\n---\n\n### 🌐 `domainscope`\n\nFind subdomains and related DNS data.\n\n```bash\ndomainscope --target example.com\ndomainscope --target example.com --output domains.txt\n```\n\n---\n\n### 📜 `certtrack`\n\nGather subdomains from SSL/TLS certificate transparency logs.\n\n```bash\ncerttrack --target example.com\ncerttrack --target example.com --output certs.csv --format csv\n```\n\n---\n\n### 🔓 `pathprobe`\n\nActively probe common paths/endpoints on a web app using HTTP requests.\n\n```bash\npathprobe --target https://example.com\npathprobe --target https://example.com --wordlist lists/path-wordlist.txt --output result.json --format json\n```\n\n\u003e If no wordlist is passed, it will fallback to:\n\u003e `GhostPath/lists/path-wordlist.txt`\n\n---\n\n## 🧪 Output Formats\n\nAll modules support output saving in:\n\n* ✅ `.txt`\n* ✅ `.json`\n* ✅ `.csv`\n\nJust pass:\n\n```bash\n--output filename --format txt|json|csv\n```\n\n---\n\n## 📦 Version \u0026 Self-Update\n\n### Check current version:\n\n```bash\nghostpath\u003e version\n```\n\n---\n\n### Reinstall / Update (via pipx):\n\n```bash\npipx reinstall GhostPath\n```\n\n---\n\n## 📜 License\n\n```text\nBSD 3-Clause License\n\nCopyright (c) 2025, Atharv Yadav\nAll rights reserved.\n```\n\n\u003e 📄 See the [LICENSE](LICENSE) file for full license terms.\n\n---\n\n## 🤝 Contributing\n\nWe welcome your pull requests, feature ideas and improvements to make **GhostPath** even better! Here's how to contribute:\n\n1. **Fork** the repository\n2. **Clone** your fork locally:\n\n   ```bash\n   git clone https://github.com/yourusername/GhostPath.git\n   cd GhostPath\n   ```\n3. **Create a new branch** for your changes:\n\n   ```bash\n   git checkout -b feature/your-feature\n   ```\n4. Make your changes and **commit**:\n\n   ```bash\n   git commit -m \"Add: your feature/fix summary\"\n   git push origin feature/your-feature\n   ```\n5. Open a **Pull Request** on GitHub 📬\n\n\u003e Please follow best practices and write clear commit messages 🙌\n\n---\n\n## 👨‍💻 Author\n\n```bash\n┌─[ Coded with ☕ + ⚡ by Atharv Yadav ]\n│\n├─🛠️  Creator of GhostPath\n├─🌐  https://github.com/atharvbyadav\n└─📧  uuwr5t1s [at] duck [dot] com\n      { _Looks suspicious? Good. It’s mine. The ducks work for me. 🦆💻_ }\n```\n\n\u003e *\"I don’t just scan — I haunt networks.\"* 👻\n\n\u003cp\u003e\n  🔗 \u003ca href=\"https://github.com/atharvbyadav\" target=\"_blank\"\u003eGitHub: @atharvbyadav\u003c/a\u003e \u003cbr\u003e\n  ✉️ \u003ca href=\"mailto:uuwr5t1s@duck.com\"\u003eEmail Me\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\u003ci\u003e🕷️ GhostPath — Stealthy. Modular. Effective.\u003c/i\u003e\u003c/p\u003e\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatharvbyadav%2Fghostpath","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatharvbyadav%2Fghostpath","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatharvbyadav%2Fghostpath/lists"}