ed1s0nz/cyberstrikeaiEl sistema de acción para la ciberseguridad nativa de IA—donde la intención se convierte en ejecución gobernada, la evidencia se convierte en memoria operativa y cada operación mejora la siguiente.
<div align="center">
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/logo.png" alt="CyberStrikeAI Logo" width="200" >
</div>
# CyberStrikeAI
[中文](https://github.com/ed1s0nz/cyberstrikeai/blob/main/README_CN.md) | [English](https://github.com/ed1s0nz/cyberstrikeai/blob/main/README.md)
**El sistema de acción para la ciberseguridad nativa de IA—donde la intención se convierte en ejecución gobernada, la evidencia se convierte en memoria operativa y cada operación mejora la siguiente.**
CyberStrikeAI conecta la planificación, la ejecución, la supervisión humana, la evidencia y la reproducción en un único espacio de trabajo auditable. Construido en Go, combina agentes impulsados por Eino, herramientas nativas de MCP, conocimiento RAG, flujos de trabajo visuales y modelado y análisis de cadenas de ataque para operaciones de seguridad autorizadas.
**Comienza aquí:** [Inicio rápido](#quick-start-one-command-deployment) · [Documentación](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/README.md) · [Endurecimiento de seguridad](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md)
> [!IMPORTANT]
> Utiliza CyberStrikeAI únicamente en sistemas que poseas o para los que tengas autorización explícita de realizar pruebas. Para entornos compartidos o de producción, revisa el [modelo de seguridad](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-model.md) y la [guía de endurecimiento](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md) antes de habilitar herramientas de alto riesgo, WebShell o capacidades de C2.
## Vista previa de la interfaz y la integración
<div align="center">
### Descripción general del panel del sistema
<table>
<tr>
<td width="50%" align="center">
<strong>Modo claro</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/dashboard.png" alt="System Dashboard (Light)" width="100%">
</td>
<td width="50%" align="center">
<strong>Modo oscuro</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/dark.png" alt="System Dashboard (Dark)" width="100%">
</td>
</tr>
</table>
*El panel proporciona una descripción general completa del estado de ejecución del sistema, las vulnerabilidades de seguridad, el uso de herramientas y la base de conocimiento, ayudando a los usuarios a comprender rápidamente las características principales de la plataforma y su estado actual.*
<details>
<summary><strong>Más capturas de pantalla de la interfaz</strong></summary>
### Descripción general de las características principales
<table>
<tr>
<td width="33.33%" align="center">
<strong>Consola web</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/web-console.png" alt="Web Console" width="100%">
</td>
<td width="33.33%" align="center">
<strong>Gestión de tareas</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/task-management.png" alt="Task Management" width="100%">
</td>
<td width="33.33%" align="center">
<strong>Gestión de vulnerabilidades</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/vulnerability-management.png" alt="Vulnerability Management" width="100%">
</td>
</tr>
<tr>
<td width="33.33%" align="center">
<strong>Gestión de WebShell</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/webshell-management.png" alt="WebShell Management" width="100%">
</td>
<td width="33.33%" align="center">
<strong>Gestión de MCP</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/mcp-management.png" alt="MCP management" width="100%">
</td>
<td width="33.33%" align="center">
<strong>Base de conocimiento</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/knowledge-base.png" alt="Knowledge Base" width="100%">
</td>
</tr>
<tr>
<td width="33.33%" align="center">
<strong>Gestión de Skills</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/skills.png" alt="Skills Management" width="100%">
</td>
<td width="33.33%" align="center">
<strong>Gestión de agentes</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/agent-management.png" alt="Agent Management" width="100%">
</td>
<td width="33.33%" align="center">
<strong>Gestión de roles</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/role-management.png" alt="Role Management" width="100%">
</td>
</tr>
<tr>
<td width="33.33%" align="center">
<strong>Configuración del sistema</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/settings.png" alt="System settings" width="100%">
</td>
<td width="33.33%" align="center">
<strong>Modo MCP stdio</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/mcp-stdio2.png" alt="MCP stdio mode" width="100%">
</td>
<td width="33.33%" align="center">
<strong>Plugin de Burp Suite</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/plugins.png" alt="Burp Suite plugin" width="100%">
</td>
</tr>
</table>
</details>
</div>
## Aspectos destacados
### Agentes y orquestación
- 🤖 **Ejecución agéntica** traduce la intención en lenguaje natural en acciones de seguridad gobernadas y auditables.
- 🧩 **Orquestación con Eino** admite la ejecución de un solo agente, además de los modos multiagente Deep, Plan-Execute y Supervisor.
- 🔀 **Flujos de trabajo gráficos** combinan agentes, herramientas, condiciones, aprobaciones y salidas en flujos reutilizables.
- 🎭 **Pruebas basadas en roles** proporcionan prompts específicos y políticas de herramientas para escenarios de seguridad comunes.
### Herramientas y conocimiento
- 🧰 **Herramientas de seguridad** incluyen más de 100 recetas YAML seleccionadas con extensiones personalizadas y acceso delimitado por rol.
- 🔌 **Integración con MCP** admite HTTP, stdio, SSE, federación externa y descubrimiento dinámico de herramientas.
- ⏱️ **Ejecución resiliente de herramientas** ejecuta llamadas bloqueantes a MCP/herramientas en workers con esperas de agente acotadas, sondeo reanudable mediante `execution_id`, cancelación, interruptores de circuito por servidor, límites de concurrencia y límites de salida unificados.
- 🎯 **Agent Skills** siguen el diseño estándar de Skill y admiten carga progresiva y bajo demanda.
- 📚 **Base de conocimiento** combina reescritura de consultas, recuperación vectorial, reranking y posprocesamiento de resultados.
- 🖼️ **Análisis de visión** utiliza un modelo de visión independiente para capturas de pantalla, captchas e interfaz de usuario, conservando únicamente resúmenes de texto.
### Gobernanza y auditoría
- 🧑⚖️ **Human in the loop** proporciona modos de aprobación, listas de permitidos de herramientas, revisión por agente auditor y decisiones trazables.
- 🛡️ **Bloqueo de llamadas** en Seguridad añade comprobaciones regex configurables antes de la ejecución de MCP, plantillas de recordatorio y ejecuciones en seco, con protección del dominio gubernamental habilitada por defecto. Consulta [Bloqueo de llamadas a herramientas](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/tool-call-guard.md).
- 🔐 **RBAC de la plataforma** admite múltiples usuarios, roles del sistema y personalizados, permisos delimitados, propiedad y asignaciones explícitas.
- 🔒 **Seguridad y auditoría** proporcionan acceso autenticado, registros de auditoría, persistencia en SQLite y retención de evidencia operativa.
- 📄 **Gobernanza de resultados** almacena el mismo resultado de herramienta acotado que ve el agente, protege las rutas de reanudación frente a salidas históricas sobredimensionadas y añade salvaguardas de interfaz para vistas de detalle grandes. Consulta [Gobernanza de ejecución de herramientas](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/tool-execution-governance.md).
### Operaciones de seguridad
- 📁 **Gestión de conversaciones** proporciona fijación, cambio de nombre y organización por lotes.
- 📂 **Proyectos y cadenas de ataque** conectan hechos entre sesiones, puntuación de riesgo, vistas de grafo y reproducción paso a paso.
- 🗂️ **Gestión de activos** normaliza y deduplica dominios, direcciones IP, puertos y servicios; admite importación y exportación XLSX/CSV, filtros avanzados y vistas guardadas, propiedad y metadatos de negocio, mantenimiento masivo entre páginas y fusión de duplicados; y realiza un seguimiento de la cobertura de escaneo, las vulnerabilidades vinculadas y el estado de riesgo. Consulta la [guía de gestión de activos](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/asset-management.md).
- 🛡️ **Gestión de vulnerabilidades** proporciona clasificación por severidad, seguimiento del ciclo de vida, filtrado y estadísticas.
- 📋 **Tareas por lotes** proporcionan ejecución en cola, edición, seguimiento de estado y resultados retenidos.
- 📱 **Chatbots** conectan WeChat personal, WeCom, DingTalk, Lark, Telegram, Slack, Discord y QQ Bot.
### Operaciones de seguridad autorizadas
- 🐚 **Gestión de WebShell** proporciona gestión de conexiones, una terminal virtual, operaciones con archivos y flujos de trabajo asistidos por IA.
- 📡 **C2 integrado** proporciona listeners, beacons cifrados, sesiones, colas de tareas, asistentes de payload y eventos en vivo.
> WebShell, C2 y otras capacidades de alto riesgo son para sistemas que poseas o para los que tengas autorización explícita de realizar pruebas. Consulta el [modelo de seguridad](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-model.md) y la [guía de endurecimiento](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md).
## Plugins
CyberStrikeAI incluye integraciones opcionales en `plugins/`.
- **Extensión de Burp Suite**: `plugins/burp-suite/cyberstrikeai-burp-extension/`
Salida de compilación: `plugins/burp-suite/cyberstrikeai-burp-extension/dist/cyberstrikeai-burp-extension.jar`
Documentación: `plugins/burp-suite/cyberstrikeai-burp-extension/README.md`
- **Extensión de navegador (Chrome / Edge)**: `plugins/browser-extension/cyberstrikeai-browser-extension/`
Captura el tráfico de red en DevTools y lo envía a CyberStrikeAI para pruebas de seguridad asistidas por IA, en línea con el plugin de Burp.
Instalación: `chrome://extensions/` → Load unpacked → F12 → pestaña **CyberStrikeAI**
Salida del paquete: `plugins/browser-extension/cyberstrikeai-browser-extension/dist/cyberstrikeai-browser-extension.zip`
Documentación: `plugins/browser-extension/cyberstrikeai-browser-extension/README.md` / `README.zh-CN.md`
## Descripción general de las herramientas
CyberStrikeAI incluye más de 100 herramientas seleccionadas que cubren toda la kill chain:
<details>
<summary><strong>Ver las categorías completas de herramientas</strong></summary>
- **Escáneres de red** – nmap, masscan, rustscan, arp-scan, nbtscan
- **Escáneres web y de aplicaciones** – sqlmap, nikto, dirb, gobuster, feroxbuster, ffuf, httpx
- **Escáneres de vulnerabilidades** – nuclei, wpscan, wafw00f, dalfox, xsser
- **Enumeración de subdominios** – subfinder, amass, findomain, dnsenum, fierce
- **Motores de búsqueda de espacio de red** – fofa_search, zoomeye_search, quake_search, shodan_search
- **Seguridad de API** – graphql-scanner, arjun, api-fuzzer, api-schema-analyzer
- **Seguridad de contenedores** – trivy, clair, docker-bench-security, kube-bench, kube-hunter
- **Seguridad en la nube** – prowler, scout-suite, cloudmapper, pacu, terrascan, checkov
- **Análisis binario** – gdb, radare2, ghidra, objdump, strings, binwalk
- **Explotación** – metasploit, msfvenom, pwntools, ropper, ropgadget
- **Cracking de contraseñas** – hashcat, john, hashpump
- **Forense** – volatility, volatility3, foremost, steghide, exiftool
- **Post-explotación** – linpeas, winpeas, mimikatz, bloodhound, impacket, responder
- **Utilidades CTF** – stegsolve, zsteg, hash-identifier, fcrackzip, pdfcrack, cyberchef
- **Asistentes del sistema** – exec, create-file, delete-file, list-files, modify-file
</details>
Consulta [tools/README_EN.md](https://github.com/ed1s0nz/cyberstrikeai/blob/main/tools/README_EN.md) para definiciones de herramientas, personalización y notas de uso.
## Uso básico
### Inicio rápido (despliegue con un solo comando)
**Requisitos previos:**
- Go 1.25+ ([Instalar](https://go.dev/dl/); requerido por `go.mod`)
- Python 3.10+ ([Instalar](https://www.python.org/downloads/))
**Despliegue con un solo comando:**
```bash
git clone https://github.com/Ed1s0nZ/CyberStrikeAI.git
cd CyberStrikeAI
chmod +x run.sh && ./run.sh
```
El script `run.sh` hará automáticamente lo siguiente:
- ✅ Verificar y validar los entornos de Go y Python
- ✅ Crear un entorno virtual de Python
- ✅ Instalar las dependencias de Python
- ✅ Descargar las dependencias de Go
- ✅ Compilar el proyecto
- ✅ Iniciar el servidor
**Verificar el arranque:**
1. Confirma que la terminal muestre `● ONLINE` seguido de la URL real de la interfaz web.
2. Abre esa URL; el modo HTTPS predeterminado usa un certificado autofirmado local, así que acepta la advertencia del navegador una vez.
3. En una instalación nueva, guarda la contraseña de `admin` de un solo uso que aparece bajo `ADMIN SETUP REQUIRED`, inicia sesión y cámbiala de inmediato.
**Valores predeterminados de red:** `run.sh` inicia el servidor con **`--https`** y el **`config.yaml`** del repositorio (TLS autofirmado local; mejor para muchas transmisiones concurrentes). Usa **`./run.sh --http`** para HTTP sin cifrado. En producción, configura **`server.tls_cert_path`** / **`server.tls_key_path`** en **`config.yaml`** (consulta los comentarios allí). Para ejecuciones manuales, añade **`--https`** o **`CYBERSTRIKE_HTTPS=1`**; si **`-config`** es incorrecto, el binario imprime una breve indicación de uso en stderr.
**Configuración inicial:**
1. **Configurar canales de IA** (obligatorio antes del primer uso)
- Tras el lanzamiento, abre **`https://127.0.0.1:8080/`** (o **`https://localhost:8080/`**; reemplaza **8080** con `server.port` en `config.yaml`) y acepta la advertencia del certificado autofirmado una vez. Si usaste `./run.sh --http`, usa **`http://`** en su lugar.
- Ve a `System Settings` → `Basic Settings` → `AI Channel Configuration`, añade o edita un canal y luego completa el proveedor, la Base URL, la clave de API, el modelo y los límites de tokens. Haz clic en **Save changes**. La lista de canales de la izquierda permite establecer un canal predeterminado, copiar, eliminar y sondear en bloque.
```yaml
ai:
default_channel: openai-main
channels:
openai-main:
name: OpenAI Main
provider: openai_compatible
api_key: "${OPENAI_API_KEY}"
base_url: "https://api.openai.com/v1" # or https://api.deepseek.com/v1
model: "gpt-4o" # or deepseek-chat, qwen3-max, etc.
max_total_tokens: 120000
max_completion_tokens: 16384
```
- O edita `config.yaml` directamente antes de lanzar. `ai.default_channel` se usa para conversaciones nuevas y tareas que no seleccionan explícitamente un canal; la página de chat también puede seleccionar cualquier canal guardado por sesión.
2. **Iniciar sesión** - En el primer arranque, la consola imprime una contraseña inicial `admin` generada automáticamente; crea cuentas desde **Platform permissions → User management**
3. **Instalar herramientas de seguridad (opcional)** - Instala las herramientas de `tools/` según sea necesario; las herramientas faltantes se omiten o se sustituyen en tiempo de ejecución. Ejemplos comunes:
**macOS (Homebrew):**
```bash
brew install nmap masscan sqlmap nikto gobuster ffuf hydra hashcat nuclei subfinder
```
**Linux (Kali / Debian / Ubuntu):**
```bash
sudo apt update
sudo apt install -y nmap masscan sqlmap nikto gobuster hydra hashcat john binwalk
# On some distros, install ffuf/nuclei/subfinder via go install or upstream docs
```
Consulta el directorio `tools/` para ver la lista completa; consulta la documentación oficial de cada herramienta para obtener detalles de instalación.
**Métodos de lanzamiento alternativos:**
```bash
# Direct Go run (set up env yourself); add --https to match run.sh defaults
go run ./cmd/server --https
# Manual build
go build -o cyberstrike-ai ./cmd/server
./cyberstrike-ai --https
```
Si los registros del servidor muestran `client sent an HTTP request to an HTTPS server`, un cliente sigue usando **`http://`** en un puerto solo TLS; cambia la URL a **`https://`**.
**Nota:** El entorno virtual de Python (`venv/`) es creado y gestionado automáticamente por `run.sh`. Las herramientas que requieren Python (como `api-fuzzer`, `http-framework-test`, etc.) usarán automáticamente este entorno.
### Actualización y compatibilidad
**Prefiere la actualización con un solo clic de la propia plataforma** (consola System settings -> One-click update, o
`./cyberstrike-ai -update` / `-check-update` / `-update-rollback`): obtiene el commit más reciente de la
rama predeterminada del **repositorio de origen de actualizaciones** (el repositorio oficial por defecto; una configuración lo
apunta a tu propio fork o a un espejo), hace fast-forward, reconstruye e intercambia el binario de forma atómica, mantiene
`roles/skills/tools/agents/data/config.yaml` intactos (el resultado nombra cada archivo que conservó; solo
el campo `version` de `config.yaml` se sincroniza con el nuevo código, para que la insignia de la cabecera coincida), y
se niega —en lugar de sobrescribir— cuando el código fuente se ha modificado localmente o el historial local ha divergido.
Consulta la [guía de despliegue](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/deployment.md).
`upgrade.sh` sigue funcionando: cuando este directorio es un árbol de trabajo de git, es una capa fina sobre el comando
anterior; solo una instalación sin git (tarball) recurre a la antigua ruta de "descargar un GitHub Release e
integrarlo con rsync", donde el repositorio de origen proviene de `--repo owner/name` o `GITHUB_REPO` y el
valor predeterminado integrado se aplica solo cuando no se da ninguno (con una advertencia que nombra el repositorio).
El origen de actualizaciones es una única configuración, una dirección de repositorio en la sección `update` de
`config.yaml` o directamente en la página de la consola: el repositorio oficial, tu propio fork o el fork de otra persona. Una
instalación desempaquetada desde un archivo Release (sin git) se puede previsualizar y conectar desde la misma
página y actualizarse con un solo clic a partir de entonces.
**Script de actualización de CyberStrikeAI:**
1. (Primera vez) habilita el script: `chmod +x upgrade.sh`
2. Actualiza con: `./upgrade.sh` (flags opcionales: `--check`, `--tag vX.Y.Z`, `--repo owner/name`, `--no-venv`, `--yes`). Los directorios locales `tools/`, `roles/`, `skills/` y `agents/` siempre se conservan.
3. El script hará una copia de seguridad de tu `config.yaml` y `data/`, actualizará el código, actualizará el campo `version` de `config.yaml` y luego reiniciará el servidor.
One-liner recomendado:
`chmod +x upgrade.sh && ./upgrade.sh --yes`
Si algo sale mal: dentro de un árbol de trabajo de git solo ejecuta `./cyberstrike-ai -update-rollback` (vuelve
al commit y al binario conservados antes de esa actualización); para una instalación tarball, restaura desde
`.upgrade-backup/` (o copia manualmente `data/` y `config.yaml` de vuelta) y ejecuta `./run.sh` de nuevo.
Requisitos / consejos (solo para la ruta tarball):
* Necesitas `curl` o `wget` para descargar los paquetes Release.
* Se recomienda/requiere `rsync` para la sincronización segura del código.
* Si la API de GitHub te limita la tasa, establece `export GITHUB_TOKEN="..."` antes de ejecutar `./upgrade.sh`.
⚠️ **Antes de actualizar:** revisa las notas de la versión de destino para cambios de configuración, base de datos y API. Las copias de seguridad son obligatorias incluso para actualizaciones de parches; un número de versión por sí solo no es una garantía de compatibilidad.
## Configuración
Usa [`config.example.yaml`](https://github.com/ed1s0nz/cyberstrikeai/blob/main/config.example.yaml) como plantilla de configuración autoritativa y copia solo los valores requeridos para tu entorno. Como mínimo, configura el servidor y un canal de IA:
```yaml
server:
host: "127.0.0.1"
port: 8080
ai:
default_channel: openai-main
channels:
openai-main:
provider: openai_compatible
api_key: "${OPENAI_API_KEY}"
base_url: "https://api.openai.com/v1"
model: "your-model"
```
`openai` es un campo de tiempo de ejecución retrocompatible; mantén la configuración de nuevos modelos en `ai.channels`. No confirmes credenciales reales. Revisa la [referencia de configuración](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration.md), los [perfiles recomendados](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration-profiles.md) y la [guía de endurecimiento de seguridad](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md) antes de exponer el servicio más allá de localhost.
## Documentación relacionada
- **Nuevos usuarios:** [Despliegue](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/deployment.md) → [Configuración](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration.md) → [Solución de problemas](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/troubleshooting.md)
- **Operadores:** [Perfiles de configuración](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration-profiles.md) → [Endurecimiento de seguridad](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md) → [Runbooks](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/runbooks.md)
- **Integradores:** [Referencia de API](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/api-reference.md) → [Recetas de API](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/api-recipes.md) → [Federación MCP](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/mcp-federation.md)
- **Colaboradores:** [Guía para desarrolladores](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/developer-guide.md) → [Pruebas](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/testing.md) → [Contribuir](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/contributing-guide.md)
- **Todos los temas:** [Documentación en inglés](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/README.md) · [Índice de documentación bilingüe](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/README.md)
## Estructura del proyecto
```
CyberStrikeAI/
├── cmd/ # Server, MCP stdio entrypoints, tooling
├── internal/ # Agent, MCP core, handlers, C2 (`internal/c2`), security executor
├── web/ # Static SPA + templates
├── tools/ # YAML tool recipes (100+ examples provided)
├── roles/ # Role configurations (12+ predefined security testing roles)
├── skills/ # Agent Skills dirs (SKILL.md + optional files; demo: cyberstrike-eino-demo)
├── agents/ # Multi-agent Markdown (orchestrator.md + sub-agent *.md)
├── docs/ # Topic docs (deployment, config, security, API, knowledge base, C2, WebShell, etc.)
├── images/ # Docs screenshots & diagrams
├── config.yaml # Runtime configuration
├── run.sh # Convenience launcher
└── README*.md
```
## Ejemplos de uso básico
```
Scan open ports on 192.168.1.1
Perform a comprehensive port scan on 192.168.1.1 focusing on 80,443,22
Check if https://example.com/page?id=1 is vulnerable to SQL injection
Scan https://example.com for hidden directories and outdated software
Enumerate subdomains for example.com, then run nuclei against the results
```
## Playbooks avanzados
```
Load the recon-engagement template, run amass/subfinder, then brute-force dirs on every live host.
Use external Burp-based MCP server for authenticated traffic replay, then pass findings back for graphing.
Compress the 5 MB nuclei report, summarize critical CVEs, and attach the artifact to the conversation.
Build an attack chain for the latest engagement and export the node list with severity >= high.
```
## 404Starlink
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/404StarLinkLogo.png" width="30%">
CyberStrikeAI se ha unido a [404Starlink](https://github.com/knownsec/404StarLink)
## TCH Top-Ranked Intelligent Pentest Project
<div align="left">
<a href="https://zc.tencent.com/competition/competitionHackathon?code=cha004" target="_blank">
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/tch.png" alt="TCH Top-Ranked Intelligent Pentest Project" width="30%">
</a>
</div>
---
## Comunidad y soporte
- Únete a la comunidad en [Discord](https://discord.gg/8PjVCMu8Zw).
<details>
<summary><strong>Grupo de WeCom</strong></summary>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/main/images/wecom-group-cyberstrikeai-qr.png" alt="CyberStrikeAI WeCom group QR code" width="280">
</details>
## Licencia
CyberStrikeAI está licenciado bajo la Apache License 2.0.
Consulta el archivo [LICENSE](https://github.com/ed1s0nz/cyberstrikeai/blob/main/LICENSE) para más detalles.
---
## ⚠️ Aviso legal
**¡Esta herramienta es solo para fines educativos y de pruebas autorizadas!**
CyberStrikeAI es una plataforma profesional de pruebas de seguridad diseñada para ayudar a investigadores de seguridad, pentesters y profesionales de TI a realizar evaluaciones de seguridad e investigación de vulnerabilidades **con autorización explícita**.
**Al usar esta herramienta, aceptas:**
- Usar esta herramienta solo en sistemas para los que tengas autorización por escrito clara
- Cumplir con todas las leyes, regulaciones y estándares éticos aplicables
- Asumir toda la responsabilidad por cualquier uso no autorizado o mal uso
- No usar esta herramienta para ningún propósito ilegal o malicioso
**¡Los desarrolladores no son responsables de ningún mal uso!** Asegúrate de que tu uso cumpla con las leyes y regulaciones locales, y de que hayas obtenido autorización explícita del propietario del sistema objetivo.
Para el reporte de vulnerabilidades y guías de endurecimiento del despliegue, consulta [SECURITY.md](https://github.com/ed1s0nz/cyberstrikeai/blob/main/SECURITY.md).
---
¿Necesitas ayuda o quieres contribuir? Abre un issue o un PR—¡las contribuciones de herramientas de la comunidad son bienvenidas!