htbmachines.sh is a Bash-based command-line utility to query Hack The Box (HTB) machine data from the community-maintained bundle.js database.
It allows you to search machines by name, IP address, skills, OS, difficulty, or browse interactively by category.

This tool is ideal for:

• HTB players who want fast recon of machines
• Keeping track of progress or searching for skill-based practice
• Filtering targets for specific certifications or challenges

📦 Requires internet for updates, and uses a local cached JS file once downloaded.

• Search by machine name, IP address, or skill
• Show machines by difficulty or OS
• Live updates of the latest HTB machines
• Installs required tools automatically (js-beautify, moreutils, etc.)
• Clean, colored terminal output
• Interactive menu mode

Before to start searching machines, you have to clone the repo into your machine, install dependencies and download the necessary files like bundle.js. You just have to do the following:

git clone https://github.com/venomcrane/HTB-Machines.git
cd HTB-Machines
./htbmachines -d
./htbmachines -u

Once you have already run this commands, you are ready to use this tool.

Searching by Machine Name:

./htbmachines -m Inception

Searching by IP Address:

./htbmachines.sh -i 10.10.10.84

Show all options available:

./htbmachines -a