Sobre o projeto

hackingtool é um kit de ferramentas CLI baseado em Python que consolida 215 ferramentas de teste de segurança curadas em um único console, organizado em 21 categorias, incluindo coleta de informações, ataques web, ataques sem fio, phishing, injeção SQL, forense, pós-exploração, quebra de senhas e mais. O diferencial é sua camada de IA: os usuários podem descrever um objetivo em português simples (por exemplo, "encontrar subdomínios de exemplo.com") e a ferramenta mapeia essa intenção para as ferramentas certas com o comando documentado exato. O comando `/goal` elabora um plano passo a passo, solicita confirmação de autorização e executa cada etapa por meio de chamadas subprocess em lista — nunca por shell. A saída das ferramentas não é realimentada no modelo após o planejamento. `/find` busca primeiro no catálogo local, depois na API do GitHub, classificando os resultados com explicações e nunca instalando ou executando nada automaticamente. Solicitações fora do escopo (jamming, DoS, direcionamento em massa) são recusadas antes de qualquer chamada de rede. Outros recursos notáveis incluem execução em segundo plano por meio de painéis tmux (`/run ... &`), modo headless para intervenções scriptadas gerando `findings.json` normalizado e relatórios Markdown, descoberta baseada em tags através de uma taxonomia fixa de 63 tags e práticas seguras de instalação (sem `curl | bash`, verificação SHA-256, releases assinados com SBOM). A camada de IA é opt-in e traz sua própria chave — suportando endpoints compatíveis com OpenAI ou uma instância local do Ollama — e degrada para comportamento determinístico offline quando nenhum modelo está configurado. Requisitos: Python 3.10+, Linux ou macOS. Windows não é suportado. Runtime opcionais incluem Go (para ferramentas como nuclei, ffuf, amass), Ruby, tmux e Docker. A instalação é feita via pipx (recomendado), uv, um venv padrão ou Docker. O projeto enfatiza o teste de segurança autorizado apenas e oferece documentação extensa sobre operação segura.