Terminal UI para herramientas de hacking ético en Kali Linux via Distrobox.

Navega, aprende y lanza herramientas de pentesting desde una interfaz TUI sin salir de tu entorno de trabajo. DockShade organiza las herramientas por categoría y nivel, explica cuándo y cómo usarlas, y las ejecuta directamente en un contenedor Kali Linux aislado.

• 32 herramientas organizadas por categoría (Recon, Web, Exploitation, Passwords, Wireless, Network, Post-Exploitation, Forensics, Reversing)
• 3 niveles de dificultad — filtra por Básico, Intermedio o Avanzado
• Búsqueda semántica — busca por nombre, tag, descripción, caso de uso o troubleshooting
• Ejemplos navegables con nivel propio — usa ↑↓ para moverte entre ellos
• Lanzar en Kali — abre el comando directamente en el contenedor, la terminal queda como shell interactiva
• Instalar herramientas — si una herramienta no está en el contenedor, la instala con un botón
• Notas personales por herramienta (guardadas en SQLite local)
• Favoritos y historial de comandos lanzados
• Flujos guiados de pentest — pasos ordenados para cada tipo de engagement
• Verificación automática de qué herramientas están realmente instaladas en el contenedor
• Setup completo — el instalador configura Docker, Distrobox y el contenedor Kali si no existen

• Linux (Debian, Ubuntu, Kali, Arch, Fedora o derivados)
• Python 3.10+
• Docker (el instalador lo configura si no está)
• Distrobox (el instalador lo configura si no está)

git clone https://github.com/iric-Sauldc/dockshade.git
cd dockshade
chmod +x install.sh
./install.sh

El instalador verifica e instala automáticamente:

1. Python 3.10+ y la dependencia textual
2. Docker (desde el repositorio oficial)
3. Distrobox
4. El contenedor kali con kalilinux/kali-rolling

Al terminar, dockshade queda disponible como comando global.

dockshade

./install.sh --remove

Elimina los archivos, el binario y opcionalmente el contenedor Kali.

dockshade/
├── main.py          # Aplicación TUI principal (Textual)
├── db.py            # Capa de persistencia SQLite
├── checker.py       # Verificación de instalación en el contenedor
├── kali_tools.json  # Base de datos de herramientas y flujos
├── install.sh       # Instalador / desinstalador
├── LICENSE          # MIT License
└── README.md

Edita kali_tools.json siguiendo la estructura existente:

{
  "name": "nombre-herramienta",
  "category": "Web",
  "level": 1,
  "tags": ["tag1", "tag2"],
  "description": "Qué hace la herramienta.",
  "when_to_use": "En qué momento del pentest se usa.",
  "output_guide": "Qué buscar en el output.",
  "chain": ["herramienta-siguiente"],
  "installed": true,
  "examples": [
    {
      "desc": "Descripción del ejemplo",
      "cmd": "comando --flags {target}",
      "level": 1
    }
  ],
  "troubleshooting": [
    "Problema común: solución."
  ]
}

Los placeholders disponibles en cmd son: {target}, {domain}, {canal}, {MAC_AP}, {hash}. El modal de lanzamiento pedirá su valor antes de ejecutar.

DockShade incluye 6 flujos de pentest paso a paso:

• Reconocimiento Externo (Básico)
• Pentest Web Básico (Básico)
• Red Interna Windows (Intermedio)
• Post-Explotación Linux (Intermedio)
• CTF Forense (Intermedio)
• Investigación de Vulnerabilidades (Avanzado)

• Textual — framework TUI en Python
• SQLite — persistencia de notas, favoritos e historial
• Distrobox + Docker — aislamiento del entorno Kali
• JSON — base de datos de herramientas extensible

DockShade es una herramienta educativa para profesionales de seguridad y estudiantes. Úsala únicamente en sistemas donde tengas autorización explícita. El autor no se hace responsable del uso indebido.

MIT — consulta el archivo LICENSE para más detalles.