# Ferramentas principais (qualquer subconjunto funciona — Pentx se adapta)
sudo apt install nmap nuclei httpx sqlmap ffuf nikto amass subfinder
# ou no Termux:
pkg install nmap nuclei httpx sqlmap ffuf nikto amass subfinder

# Dependências Python
pip3 install requests beautifulsoup4

git clone https://github.com/yashas-13/pentx-vapt-skill.git
cd pentx-vapt-skill

# 1. Verifique quais ferramentas estão disponíveis
python3 scripts/pentx.py --check

# 2. Execute um VAPT completo de 5 fases (somente leitura, seguro)
python3 scripts/pentx.py https://target.example.com ./output --no-exploit

# 3. Avaliação completa (requer autorização — leia os prompts da Fase 1)
python3 scripts/pentx.py https://target.example.com ./output

# 4. Execute apenas uma fase específica
python3 scripts/pentx.py https://target.example.com ./output --phase 3

# 5. Regere o relatório a partir de descobertas existentes
python3 scripts/pentx.py ./output --phase 5

output/
├── phase1-recon/
│   ├── assets.txt        → Todos os ativos descobertos
│   ├── live.json         → Hosts ativos (httpx)
│   └── subdomains.txt    → Enumeração de subdomínios
├── phase2-scan/
│   ├── nmap_full.json    → Resultados completos do nmap
│   ├── ffuf_dirs.json    → Fuzzing de diretórios
│   └── nikto.json        → Descobertas do Nikto
├── phase3-vuln/
│   └── findings.jsonl    → Descobertas de vulnerabilidades (JSONL)
├── phase4-exploit/
│   └── exploits.jsonl    → Exploits confirmados + PoCs
├── report.html           → Relatório HTML completo
├── report.md             → Relatório Markdown completo
├── exec-summary.md       → Resumo executivo
├── findings-merged.json  → Todas as descobertas mescladas
└── poc-full/
    └── poc-*.txt         → Artefatos PoC brutos (*.txt)

pentx-vapt-skill/
├── SKILL.md                        # Especificação da skill do pi-agent
├── README.md                       # Este arquivo
├── LICENSE                         # MIT
├── CONTRIBUTING.md                 # Guia de contribuição
├── assets/
│   └── report_template.md          # Template de relatório
├── references/
│   ├── methodology.md              # Metodologia de 5 fases + template PoC + CVSS
│   └── tools-matrix.md             # Capacidades das ferramentas + estratégia de precisão
└── scripts/
    ├── pentx.py                    # Orquestrador principal da CLI
    ├── tools_check.sh              # Verificador de disponibilidade de ferramentas
    └── lib/
        ├── pentx_common.py         # Armazenamento de descobertas, captura de PoC, fallbacks
        ├── phase_recon.py          # Fase 1
        ├── phase_scan.py           # Fase 2
        ├── phase_vuln.py           # Fase 3
        ├── phase_exploit.py        # Fase 4
        └── report_gen.py           # Fase 5

# Instalar ou atualizar a skill Pentx
bash -c "$(curl -fsSL https://raw.githubusercontent.com/yashas-13/pentx-vapt-skill/main/scripts/install.sh)"

# Ou com pi-agent (se instalado)
/pentx install

#!/usr/bin/env bash
set -euo pipefail
REPO="yashas-13/pentx-vapt-skill"
BRANCH="main"
INSTALL_DIR="${HOME}/.pi/agent/skills/pentx"

echo "🔧 Instalando a skill Pentx VAPT..."
mkdir -p "${INSTALL_DIR}"
curl -fsSL "https://github.com/${REPO}/archive/refs/heads/${BRANCH}.tar.gz" | \
  tar -xz --strip-components=1 -C "${INSTALL_DIR}"

# Verificar ferramentas
python3 "${INSTALL_DIR}/scripts/pentx.py" --check

echo "✅ Pentx instalado em ${INSTALL_DIR}"
echo "📖 Execute: python3 ${INSTALL_DIR}/scripts/pentx.py https://target.example.com ./output --no-exploit"