ed1s0nz/cyberstrikeaiIl sistema d'azione per la cybersecurity nativa AI—dove l'intento diventa esecuzione governata, le evidenze diventano memoria operativa, e ogni operazione migliora la successiva.
<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)
**Il sistema d'azione per la cybersecurity AI-native—dove l'intento diventa esecuzione governata, l'evidenza diventa memoria operativa e ogni operazione migliora la successiva.**
CyberStrikeAI connette pianificazione, esecuzione, supervisione umana, evidenza e replay in un unico workspace verificabile. Costruito in Go, combina agenti basati su Eino, strumenti MCP-native, conoscenza RAG, workflow visuali e modellazione e analisi della catena di attacco per operazioni di sicurezza autorizzate.
**Inizia qui:** [Avvio rapido](#quick-start-one-command-deployment) · [Documentazione](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/README.md) · [Hardening di sicurezza](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md)
> [!IMPORTANT]
> Usa CyberStrikeAI solo su sistemi di tua proprietà o che sei esplicitamente autorizzato a testare. Per ambienti condivisi o di produzione, consulta il [modello di sicurezza](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-model.md) e la [guida all'hardening](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md) prima di abilitare strumenti ad alto rischio, WebShell o funzionalità C2.
## Anteprima dell'interfaccia e delle integrazioni
<div align="center">
### Panoramica della dashboard di sistema
<table>
<tr>
<td width="50%" align="center">
<strong>Modalità chiara</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>Modalità scura</strong><br/>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/HEAD/images/dark.png" alt="System Dashboard (Dark)" width="100%">
</td>
</tr>
</table>
*La dashboard fornisce una panoramica completa dello stato di runtime del sistema, delle vulnerabilità di sicurezza, dell'utilizzo degli strumenti e della knowledge base, aiutando gli utenti a comprendere rapidamente le funzionalità principali della piattaforma e il suo stato attuale.*
<details>
<summary><strong>Altre schermate dell'interfaccia</strong></summary>
### Panoramica delle funzionalità principali
<table>
<tr>
<td width="33.33%" align="center">
<strong>Console 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>Gestione delle attività</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>Gestione delle vulnerabilità</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>Gestione 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>Gestione 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>Knowledge Base</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>Gestione delle 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>Gestione degli agenti</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>Gestione dei ruoli</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>Impostazioni di 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>Modalità 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 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>
## Punti salienti
### Agenti e orchestrazione
- 🤖 **Esecuzione agentica** traduce l'intento in linguaggio naturale in azioni di sicurezza governate e verificabili.
- 🧩 **Orchestrazione Eino** supporta l'esecuzione con singolo agente più le modalità multi-agente Deep, Plan-Execute e Supervisor.
- 🔀 **Workflow a grafo** combinano agenti, strumenti, condizioni, approvazioni e output in flussi riutilizzabili.
- 🎭 **Testing basato sui ruoli** fornisce prompt mirati e policy degli strumenti per scenari di sicurezza comuni.
### Strumenti e conoscenza
- 🧰 **Strumenti di sicurezza** includono oltre 100 ricette YAML curate con estensioni personalizzate e accesso con ambito di ruolo.
- 🔌 **Integrazione MCP** supporta HTTP, stdio, SSE, federazione esterna e scoperta dinamica degli strumenti.
- ⏱️ **Esecuzione resiliente degli strumenti** esegue chiamate MCP/strumenti bloccanti in worker con attese dell'agente limitate, polling ripristinabile tramite `execution_id`, cancellazione, circuit breaker per server, limiti di concorrenza e limiti di output unificati.
- 🎯 **Agent Skills** seguono il layout standard delle Skill e supportano il caricamento progressivo e on-demand.
- 📚 **Knowledge base** combina riscrittura delle query, retrieval vettoriale, reranking e post-elaborazione dei risultati.
- 🖼️ **Analisi visiva** utilizza un modello di visione separato per screenshot, captcha e UI, mantenendo solo i riepiloghi testuali.
### Governance e audit
- 🧑⚖️ **Human in the loop** fornisce modalità di approvazione, allowlist degli strumenti, revisione tramite audit-agent e decisioni tracciabili.
- 🛡️ **Blocco delle chiamate** in Sicurezza aggiunge controlli regex configurabili prima dell'esecuzione MCP, template di promemoria e dry run, con la protezione del dominio governativo abilitata per impostazione predefinita. Vedi [Blocco delle chiamate agli strumenti](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/tool-call-guard.md).
- 🔐 **RBAC della piattaforma** supporta più utenti, ruoli di sistema e personalizzati, permessi con ambito, ownership e assegnazioni esplicite.
- 🔒 **Sicurezza e audit** forniscono accesso autenticato, log di audit, persistenza SQLite e conservazione delle evidenze operative.
- 📄 **Governance dei risultati** memorizza lo stesso risultato limitato dello strumento visto dall'agente, protegge i percorsi di ripresa da output storici sovradimensionati e aggiunge salvaguardie UI per le viste di dettaglio di grandi dimensioni. Vedi [Governance dell'esecuzione degli strumenti](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/tool-execution-governance.md).
### Operazioni di sicurezza
- 📁 **Gestione delle conversazioni** fornisce fissaggio, rinomina e organizzazione in batch.
- 📂 **Progetti e catene di attacco** collegano fatti tra sessioni, scoring del rischio, viste a grafo e replay passo-passo.
- 🗂️ **Gestione degli asset** normalizza e deduplica domini, indirizzi IP, porte e servizi; supporta importazione ed esportazione XLSX/CSV, filtri avanzati e viste salvate, ownership e metadati di business, manutenzione in blocco tra pagine e unione dei duplicati; e traccia la copertura delle scansioni, le vulnerabilità collegate e lo stato di rischio. Vedi la [guida alla gestione degli asset](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/asset-management.md).
- 🛡️ **Gestione delle vulnerabilità** fornisce classificazione della severità, tracciamento del ciclo di vita, filtri e statistiche.
- 📋 **Attività in batch** forniscono esecuzione in coda, modifica, tracciamento dello stato e conservazione dei risultati.
- 📱 **Chatbot** collegano WeChat Personale, WeCom, DingTalk, Lark, Telegram, Slack, Discord e QQ Bot.
### Operazioni di sicurezza autorizzate
- 🐚 **Gestione WebShell** fornisce gestione delle connessioni, terminale virtuale, operazioni sui file e workflow assistiti dall'AI.
- 📡 **C2 integrato** fornisce listener, beacon cifrati, sessioni, code di attività, helper per payload ed eventi live.
> WebShell, C2 e altre funzionalità ad alto rischio sono destinate a sistemi di tua proprietà o che sei esplicitamente autorizzato a testare. Vedi il [modello di sicurezza](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-model.md) e la [guida all'hardening](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md).
## Plugin
CyberStrikeAI include integrazioni opzionali sotto `plugins/`.
- **Estensione Burp Suite**: `plugins/burp-suite/cyberstrikeai-burp-extension/`
Output di build: `plugins/burp-suite/cyberstrikeai-burp-extension/dist/cyberstrikeai-burp-extension.jar`
Documentazione: `plugins/burp-suite/cyberstrikeai-burp-extension/README.md`
- **Estensione browser (Chrome / Edge)**: `plugins/browser-extension/cyberstrikeai-browser-extension/`
Cattura il traffico di rete nei DevTools e invialo a CyberStrikeAI per test di sicurezza assistiti dall'AI—in linea con il plugin Burp.
Installazione: `chrome://extensions/` → Load unpacked → F12 → scheda **CyberStrikeAI**
Output del pacchetto: `plugins/browser-extension/cyberstrikeai-browser-extension/dist/cyberstrikeai-browser-extension.zip`
Documentazione: `plugins/browser-extension/cyberstrikeai-browser-extension/README.md` / `README.zh-CN.md`
## Panoramica degli strumenti
CyberStrikeAI viene fornito con oltre 100 strumenti curati che coprono l'intera kill chain:
<details>
<summary><strong>Visualizza le categorie complete di strumenti</strong></summary>
- **Scanner di rete** – nmap, masscan, rustscan, arp-scan, nbtscan
- **Scanner Web e applicativi** – sqlmap, nikto, dirb, gobuster, feroxbuster, ffuf, httpx
- **Scanner di vulnerabilità** – nuclei, wpscan, wafw00f, dalfox, xsser
- **Enumerazione dei sottodomini** – subfinder, amass, findomain, dnsenum, fierce
- **Motori di ricerca dello spazio di rete** – fofa_search, zoomeye_search, quake_search, shodan_search
- **Sicurezza API** – graphql-scanner, arjun, api-fuzzer, api-schema-analyzer
- **Sicurezza dei container** – trivy, clair, docker-bench-security, kube-bench, kube-hunter
- **Sicurezza cloud** – prowler, scout-suite, cloudmapper, pacu, terrascan, checkov
- **Analisi binaria** – gdb, radare2, ghidra, objdump, strings, binwalk
- **Exploitation** – metasploit, msfvenom, pwntools, ropper, ropgadget
- **Password cracking** – hashcat, john, hashpump
- **Forense** – volatility, volatility3, foremost, steghide, exiftool
- **Post-exploitation** – linpeas, winpeas, mimikatz, bloodhound, impacket, responder
- **Utility CTF** – stegsolve, zsteg, hash-identifier, fcrackzip, pdfcrack, cyberchef
- **Helper di sistema** – exec, create-file, delete-file, list-files, modify-file
</details>
Vedi [tools/README_EN.md](https://github.com/ed1s0nz/cyberstrikeai/blob/main/tools/README_EN.md) per le definizioni degli strumenti, la personalizzazione e le note d'uso.
## Utilizzo di base
### Avvio rapido (deployment con un solo comando)
**Prerequisiti:**
- Go 1.25+ ([Installa](https://go.dev/dl/); richiesto da `go.mod`)
- Python 3.10+ ([Installa](https://www.python.org/downloads/))
**Deployment con un solo comando:**
```bash
git clone https://github.com/Ed1s0nZ/CyberStrikeAI.git
cd CyberStrikeAI
chmod +x run.sh && ./run.sh
```
Lo script `run.sh` eseguirà automaticamente:
- ✅ Controllo e validazione degli ambienti Go e Python
- ✅ Creazione dell'ambiente virtuale Python
- ✅ Installazione delle dipendenze Python
- ✅ Download delle dipendenze Go
- ✅ Compilazione del progetto
- ✅ Avvio del server
**Verifica dell'avvio:**
1. Conferma che il terminale mostri `● ONLINE` seguito dall'URL effettivo della Web UI.
2. Apri quell'URL; la modalità HTTPS predefinita utilizza un certificato locale self-signed, quindi accetta l'avviso del browser una volta.
3. Su una nuova installazione, memorizza la password `admin` monouso mostrata sotto `ADMIN SETUP REQUIRED`, accedi e cambiala immediatamente.
**Impostazioni di rete predefinite:** `run.sh` avvia il server con **`--https`** e il file **`config.yaml`** del repository (TLS locale self-signed; preferibile per molti stream concorrenti). Usa **`./run.sh --http`** per HTTP semplice. In produzione, imposta **`server.tls_cert_path`** / **`server.tls_key_path`** in **`config.yaml`** (vedi i commenti lì). Per esecuzioni manuali, aggiungi **`--https`** o **`CYBERSTRIKE_HTTPS=1`**; se **`-config`** è errato, il binario stampa un breve suggerimento d'uso su stderr.
**Configurazione iniziale:**
1. **Configura i canali AI** (obbligatorio prima del primo utilizzo)
- Dopo l'avvio, apri **`https://127.0.0.1:8080/`** (o **`https://localhost:8080/`**; sostituisci **8080** con `server.port` in `config.yaml`) e accetta l'avviso del certificato self-signed una volta. Se hai usato `./run.sh --http`, usa **`http://`** invece.
- Vai su `System Settings` → `Basic Settings` → `AI Channel Configuration`, aggiungi o modifica un canale, quindi inserisci provider, Base URL, API key, modello e limiti di token. Clicca **Save changes**. La lista dei canali a sinistra supporta l'impostazione di un default, copia, eliminazione e probe in blocco.
```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
```
- Oppure modifica direttamente `config.yaml` prima dell'avvio. `ai.default_channel` viene utilizzato per nuove conversazioni e attività che non selezionano esplicitamente un canale; la pagina di chat può anche selezionare qualsiasi canale salvato per sessione.
2. **Login** - Al primo avvio la console stampa una password `admin` iniziale generata automaticamente; crea account da **Platform permissions → User management**
3. **Installa gli strumenti di sicurezza (opzionale)** - Installa gli strumenti da `tools/` secondo necessità; gli strumenti mancanti vengono saltati o sostituiti a runtime. Esempi comuni:
**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 la directory `tools/` per l'elenco completo; fai riferimento alla documentazione ufficiale di ciascuno strumento per i dettagli di installazione.
**Metodi di avvio alternativi:**
```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
```
Se i log del server mostrano `client sent an HTTP request to an HTTPS server`, un client sta ancora usando **`http://`** su una porta solo TLS—cambia l'URL in **`https://`**.
**Nota:** L'ambiente virtuale Python (`venv/`) viene creato e gestito automaticamente da `run.sh`. Gli strumenti che richiedono Python (come `api-fuzzer`, `http-framework-test`, ecc.) utilizzeranno automaticamente questo ambiente.
### Aggiornamento e compatibilità
**Preferisci l'aggiornamento one-click della piattaforma stessa** (console Impostazioni di sistema -> Aggiornamento one-click, oppure
`./cyberstrike-ai -update` / `-check-update` / `-update-rollback`): scarica il commit più recente del
branch predefinito del **repository sorgente di aggiornamento** (il repository ufficiale per impostazione predefinita; un'impostazione lo punta al tuo fork o a un mirror), esegue il fast-forward, ricompila e scambia il binario in modo atomico, mantiene intatti i tuoi
`roles/skills/tools/agents/data/config.yaml` (il risultato elenca ogni file mantenuto; solo il campo `version` di
`config.yaml` viene sincronizzato con il nuovo codice, così il badge nell'header corrisponde), e
rifiuta - anziché sovrascrivere - quando il sorgente è modificato localmente o la cronologia locale è divergente.
Consulta la [guida al deployment](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/deployment.md).
`upgrade.sh` funziona ancora: quando questa directory è un work tree git è un sottile wrapper attorno al comando
sopra; solo un'installazione non-git (tarball) ricade nel vecchio percorso "scarica una GitHub Release e rsyncala", dove il repository sorgente proviene da `--repo owner/name` o `GITHUB_REPO` e il
default integrato si applica solo quando nessuno dei due è specificato (con un avviso che nomina il repository).
La sorgente di aggiornamento è un'unica impostazione, un indirizzo di repository nella sezione `update` di `config.yaml` o
direttamente nella pagina della console - il repository ufficiale, il tuo fork, o il fork di qualcun altro. Un'installazione scompattata da un archivio Release (senza git) può essere visualizzata in anteprima e collegata dalla stessa
pagina e da quel momento si aggiorna con un click.
**Script di aggiornamento di CyberStrikeAI:**
1. (Prima volta) abilita lo script: `chmod +x upgrade.sh`
2. Aggiorna con: `./upgrade.sh` (flag opzionali: `--check`, `--tag vX.Y.Z`, `--repo owner/name`, `--no-venv`, `--yes`). Le directory locali `tools/`, `roles/`, `skills/` e `agents/` vengono sempre preservate.
3. Lo script eseguirà il backup del tuo `config.yaml` e di `data/`, aggiornerà il codice, aggiornerà il campo `version` di `config.yaml`, quindi riavvierà il server.
One-liner consigliato:
`chmod +x upgrade.sh && ./upgrade.sh --yes`
Se qualcosa va storto: all'interno di un work tree git esegui semplicemente `./cyberstrike-ai -update-rollback` (torna al
commit e al binario mantenuti prima di quell'aggiornamento); per un'installazione da tarball ripristina da
`.upgrade-backup/` (oppure copia manualmente `data/` e `config.yaml` indietro) ed esegui di nuovo `./run.sh`.
Requisiti / suggerimenti (solo percorso tarball):
* Ti serve `curl` o `wget` per scaricare i pacchetti Release.
* `rsync` è consigliato/richiesto per la sincronizzazione sicura del codice.
* Se GitHub API ti applica rate-limit, imposta `export GITHUB_TOKEN="..."` prima di eseguire `./upgrade.sh`.
⚠️ **Prima di aggiornare:** consulta le note di rilascio di destinazione per modifiche a configurazione, database e API. I backup sono obbligatori anche per aggiornamenti patch; un numero di versione da solo non è una garanzia di compatibilità.
## Configurazione
Usa [`config.example.yaml`](https://github.com/ed1s0nz/cyberstrikeai/blob/main/config.example.yaml) come modello di configurazione autorevole e copia solo i valori richiesti per il tuo ambiente. Come minimo, configura il server e un canale AI:
```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` è un campo runtime retrocompatibile; mantieni le nuove impostazioni del modello in `ai.channels`. Non eseguire il commit di credenziali reali. Consulta il [riferimento alla configurazione](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration.md), i [profili consigliati](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration-profiles.md) e la [guida al rafforzamento della sicurezza](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md) prima di esporre il servizio al di fuori di localhost.
## Documentazione correlata
- **Nuovi utenti:** [Distribuzione](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/deployment.md) → [Configurazione](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration.md) → [Risoluzione dei problemi](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/troubleshooting.md)
- **Operatori:** [Profili di configurazione](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration-profiles.md) → [Rafforzamento della sicurezza](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md) → [Runbook](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/runbooks.md)
- **Integratori:** [Riferimento API](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/api-reference.md) → [Ricette API](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/api-recipes.md) → [Federazione MCP](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/mcp-federation.md)
- **Collaboratori:** [Guida per sviluppatori](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/developer-guide.md) → [Test](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/testing.md) → [Contribuire](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/contributing-guide.md)
- **Tutti gli argomenti:** [Documentazione in inglese](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/README.md) · [Indice della documentazione bilingue](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/README.md)
## Struttura del progetto
```
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
```
## Esempi di utilizzo di base
```
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
```
## Playbook avanzati
```
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 è entrato a far parte di [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>
---
## Community e Supporto
- Unisciti alla community su [Discord](https://discord.gg/8PjVCMu8Zw).
<details>
<summary><strong>Gruppo WeCom</strong></summary>
<img src="https://raw.githubusercontent.com/ed1s0nz/cyberstrikeai/main/images/wecom-group-cyberstrikeai-qr.png" alt="Codice QR del gruppo WeCom di CyberStrikeAI" width="280">
</details>
## Licenza
CyberStrikeAI è distribuito con licenza Apache License 2.0.
Consulta il file [LICENSE](https://github.com/ed1s0nz/cyberstrikeai/blob/main/LICENSE) per i dettagli.
---
## ⚠️ Disclaimer
**Questo strumento è destinato esclusivamente a scopi educativi e di test autorizzati!**
CyberStrikeAI è una piattaforma professionale di security testing progettata per assistere ricercatori di sicurezza, penetration tester e professionisti IT nello svolgimento di valutazioni di sicurezza e ricerche sulle vulnerabilità **con esplicita autorizzazione**.
**Utilizzando questo strumento, accetti di:**
- Utilizzare questo strumento solo su sistemi per cui disponi di chiara autorizzazione scritta
- Rispettare tutte le leggi, i regolamenti e gli standard etici applicabili
- Assumerti la piena responsabilità per qualsiasi uso non autorizzato o abuso
- Non utilizzare questo strumento per scopi illegali o malevoli
**Gli sviluppatori non sono responsabili per qualsiasi uso improprio!** Assicurati che il tuo utilizzo sia conforme alle leggi e ai regolamenti locali e che tu abbia ottenuto l'esplicita autorizzazione dal proprietario del sistema target.
Per la segnalazione di vulnerabilità e le linee guida sul rafforzamento del deployment, consulta [SECURITY.md](https://github.com/ed1s0nz/cyberstrikeai/blob/main/SECURITY.md).
---
Hai bisogno di aiuto o vuoi contribuire? Apri una issue o una PR—i contributi di strumenti della community sono benvenuti!