{"id":21417955,"url":"https://github.com/esonhugh/weaponizedvscode","last_synced_at":"2025-08-20T07:30:44.254Z","repository":{"id":207176371,"uuid":"718524096","full_name":"Esonhugh/WeaponizedVSCode","owner":"Esonhugh","description":"A VSCode Workspace based hacking environment utils. Starting your Note-Driven Hacking experience. Checkout the following link to sample of HackThebox mist.htb","archived":false,"fork":false,"pushed_at":"2024-10-05T12:55:48.000Z","size":1972,"stargazers_count":57,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-12-05T23:51:22.528Z","etag":null,"topics":["environment","hacking","note-driven-hacking","notebook","penetration-testing","red-team","vscode","weaponized"],"latest_commit_sha":null,"homepage":"https://github.com/Esonhugh/WeaponziedVSCode-Example-MIST.HTB","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Esonhugh.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}},"created_at":"2023-11-14T09:03:33.000Z","updated_at":"2024-10-27T15:45:08.000Z","dependencies_parsed_at":"2023-12-14T10:01:03.412Z","dependency_job_id":"58258098-3b0d-4105-9690-07dccc378f88","html_url":"https://github.com/Esonhugh/WeaponizedVSCode","commit_stats":{"total_commits":28,"total_committers":1,"mean_commits":28.0,"dds":0.0,"last_synced_commit":"d19f9e70048e5c2761f1b5b92813d2fdaceab48c"},"previous_names":["esonhugh/createhackingenv","esonhugh/weaponizedvscode"],"tags_count":11,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Esonhugh%2FWeaponizedVSCode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Esonhugh%2FWeaponizedVSCode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Esonhugh%2FWeaponizedVSCode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Esonhugh%2FWeaponizedVSCode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Esonhugh","download_url":"https://codeload.github.com/Esonhugh/WeaponizedVSCode/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230400616,"owners_count":18219831,"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","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":["environment","hacking","note-driven-hacking","notebook","penetration-testing","red-team","vscode","weaponized"],"created_at":"2024-11-22T19:18:19.836Z","updated_at":"2025-08-20T07:30:44.242Z","avatar_url":"https://github.com/Esonhugh.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WeaponizedVSCode\n\nA lightweight penetration testing environment management tool based on Visual Studio Code, designed for cybersecurity professionals and penetration testers.\n\n## 🎯 Project Goals\n\nWeaponizedVSCode aims to solve the following problems in traditional penetration testing:\n\n1. **Difficult Environment Switching** - Frequent switching between different project environment configurations\n2. **Chaotic Tool Management** - Tools and payloads scattered across different directories\n3. **Repetitive Configuration** - Each project requires reconfiguring Metasploit, reverse shells, etc.\n4. **Scattered Records** - Credentials, notes, and files stored dispersedly\n5. **Low Efficiency** - Lack of mechanisms for rapid payload generation\n\n## ✨ Core Features\n\n### 🔄 Project Environment Management\n- **One-Click Project Environment Creation** - Use `createhack \u003cproject-name\u003e` to quickly create pre-configured penetration testing projects\n- **Smart Environment Switching** - Seamless switching between different projects with automatic configuration loading\n- **Template-Based Configuration** - Pre-configured VSCode settings, tasks, and extension configurations\n\n### 🛠️ Integrated Tool Support\n- **300+ Security Tool Integration** - Pre-configured command completion for common penetration testing tools\n- **Smart Command History** - Tool index-based command history and auto-completion\n- **Environment Variable Management** - Automatic detection and management of tool-dependent environment variables\n\n### 🎮 Multi-Mode Terminals\n- **Standard Shell** - Enhanced Zsh terminal with status display\n- **Meterpreter Handler** - Auto-configured Metasploit listener\n- **MSF Console** - Pre-configured Metasploit console\n- **Netcat Handler** - Reverse shell handling terminal\n- **Web Delivery** - HTTP server mode for file transfer\n- **Kali OrbStack** - Virtual machine integration support (macOS)\n\n### 📋 Project Organization Features\n- **Structured Directories** - Automatically create hosts, users, credentials directories\n- **File Management** - Convenient project file and web transfer file management\n- **Note System** - Integrated Foam extension with bidirectional linked notes\n- **Credential Management** - Centralized management of discovered user credentials\n\n### ⚡ Quick Operations\n- **Payload Generation** - VSCode task integration for rapid Msfvenom payload generation\n- **Automated Scanning** - Integration of RustScan, Nmap, and other scanning tools\n- **Proxy Management** - Convenient proxy switching and configuration\n- **Host Management** - Automatic /etc/hosts file updates\n\n## 🔧 System Requirements\n\n### Supported Platforms\n- **Linux** (Recommended)\n- **macOS**\n- **Windows** (Partial functionality, not fully supported)\n\n### Required Dependencies\n```bash\n# Core Tools\nzsh                    # Shell environment\ncode                   # Visual Studio Code\npython3                # Python runtime\nvim                    # Editor\n\n# Network Tools\nnc                     # Netcat\nrlwrap                 # Command line wrapper\n\n# Parsing Tools\nawk, sed, grep, tr     # Text processing tools\nyq                     # YAML processor\n\n# Security Tools\nmsfvenom               # Metasploit payload generator\nrustscan               # Port scanner\nwfuzz                  # Web fuzzing tool\nhashcat                # Password cracking tool\n```\n\n### Recommended Tools\n```bash\nsimplehttpserver       # Enhanced HTTP server\nuv                     # Python package manager (performance optimization)\n```\n\n## 🚀 Installation Guide\n\n### 1. Clone Repository\n```bash\ngit clone https://github.com/Esonhugh/WeaponizedVSCode.git\ncd WeaponizedVSCode\n```\n\n### 2. Build Project\n```bash\n# Build using Make (recommended)\nmake build\n\n# Or build manually\nuv run ./craft.py\nuv run ./completion_creator.py\n```\n\n### 3. Install to System\n```bash\n# Default installation (installs to ~/.local/weapon)\n./installer.sh\n\n# Custom installation location\nWEAPON_LOCATION=/your/custom/path ./installer.sh\n\n# Force reinstallation\n./installer.sh --force-install\n\n# Enable performance tracing mode\n./installer.sh --trace-mode\n```\n\n### 4. Verify Installation\n```bash\n# Check script integrity\npython3 verify.py createhackenv.sh\n\n# Reload shell configuration\nsource ~/.zshrc\n```\n\n## 📖 Usage\n\n### Create New Project\n```bash\n# Create new penetration testing project\ncreatehack my-project\n# Or use alias\ncreatehackenv my-project\n```\n\n### Environment Variable Configuration\nSet environment variables in the project's `.vscode/env.zsh` file:\n```bash\nexport RHOST=\"10.10.10.1\"\nexport RPORT=\"4444\"\nexport LHOST=\"10.10.14.1\"\nexport LPORT=\"9001\"\nexport DOMAIN=\"target.com\"\n```\n\n### Terminal Mode Usage\n\n#### 1. Standard Shell Mode\n- Automatically load project environment variables\n- Display current status information\n- Support all tool command completion\n\n#### 2. Meterpreter Handler Mode\n```bash\n# Select \"meterpreter-handler\" terminal profile in VSCode\n# Automatically start configured Metasploit listener\n```\n\n#### 3. Web Delivery Mode\n```bash\n# Select \"web-delivery\" terminal profile in VSCode\n# Automatically switch to $PROJECT_WEB_DELIVERY directory and start HTTP server\n```\n\n### Common Command Examples\n```bash\n# Host Management\nset_current_host 10.10.10.1\ndump_hosts | sudo tee -a /etc/hosts\n\n# User Management\nset_current_user administrator\nupdate_user_cred_to_env\n\n# Scanning Operations\nrustscan -a $RHOST --ulimit 5000 -- -A --script=vuln\nnmap -sC -sV -p 139,445,80,21 $RHOST\n\n# Proxy Management\nproxys on\nproxys set http://127.0.0.1:8080\n\n# File Operations\ncp payload.exe $PROJECT_WEB_DELIVERY/\n```\n\n## 🏗️ Project Structure\n\n```\nWeaponizedVSCode/\n├── craft.py                    # Environment build script\n├── completion_creator.py       # Command completion generator\n├── installer.sh               # Installation script\n├── verify.py                  # Script verification tool\n├── launch_helper.zsh          # Shell launch helper\n├── Makefile                   # Build configuration\n├── .vscode/                   # VSCode template configuration\n│   ├── settings.json          # Editor settings\n│   ├── tasks.json             # Task configuration\n│   ├── extensions.json        # Recommended extensions\n│   ├── env.zsh               # Environment variables\n│   ├── metasploit_handler.rc  # MSF configuration\n│   └── source_*.zsh          # Mode launch scripts\n├── completion_indexer/        # Tool command index\n│   ├── nmap                   # Nmap command set\n│   ├── burpsuite             # Burp Suite command set\n│   ├── metasploit            # Metasploit command set\n│   ├── _weapon               # Built-in tool commands\n│   └── ...                   # 300+ tool command sets\n└── documents/                 # Project documentation\n    ├── USE.md                # Usage instructions\n    ├── CUSTOM.md             # Customization guide\n    └── DEMO.md               # Demo documentation\n```\n\n### Created Project Structure\n```\nmy-project/\n├── .vscode/                   # VSCode configuration\n│   ├── .zshrc                # Shell configuration\n│   ├── env.zsh               # Environment variables\n│   └── ...                   # Other configuration files\n├── hosts/                     # Host information\n├── users/                     # User information\n├── credentials/               # Credential information\n└── web-delivery/             # Web transfer files\n```\n\n## 🎨 Custom Configuration\n\n### Modify Templates\n1. Edit configuration files in the `.vscode/` directory\n2. Run `python3 craft.py` to regenerate installation script\n3. Commit changes to Git repository\n\n### Add New Tools\n1. Create new tool command files in the `completion_indexer/` directory\n2. Run `python3 completion_creator.py` to update command index\n3. Rebuild and install\n\n### Environment Variable Check\n```bash\n# Check all used environment variables\npython3 completion_creator.py\n```\n\n## 🔍 Troubleshooting\n\n### Common Issues\n\n#### 1. Command Completion Not Working\n```bash\n# Check if zsh_history file exists\nls -la ~/.local/weapon/zsh_history\n\n# Regenerate command index\npython3 completion_creator.py\n```\n\n#### 2. Metasploit Mode Cannot Start\n```bash\n# Check if Metasploit is properly installed\nwhich msfconsole\nmsfconsole --version\n\n# Check RC file\ncat .vscode/metasploit_handler.rc\n```\n\n#### 3. Environment Variables Not Loading Correctly\n```bash\n# Check project environment variable file\nsource .vscode/env.zsh\necho $PROJECT_FOLDER\n```\n\n## 🤝 Contributing\n\n1. Fork this repository\n2. Create a feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Create a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Inspired by Cobalt Strike's environment management concepts\n- Thanks to all security tool developers for their contributions\n- Thanks to the VSCode community for providing a powerful extension ecosystem\n\n## 📞 Support\n\n- **GitHub Issues**: [Report Issues](https://github.com/Esonhugh/WeaponizedVSCode/issues)\n- **Author**: Esonhugh \u003cweapon_vscode@eson.ninja\u003e\n\n---\n\n**Happy Hacking! 🎯**\n\n ## 404Starlink\n\u003cimg src lazysrc=\"https://github.com/knownsec/404StarLink-Project/raw/master/logo.png\" width=\"30%\"\u003e\nWeaponizedVSCode has joined [404Starlink](https://github.com/knownsec/404StarLink)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesonhugh%2Fweaponizedvscode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fesonhugh%2Fweaponizedvscode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesonhugh%2Fweaponizedvscode/lists"}