Decepticon — Agente Red Team Autonomo

"Un altro hacker AI? Lasciateci indovinare — esegue nmap e scrive un report."

---

Installazione

Prerequisiti: Docker e Docker Compose v2. Supportato su macOS (Apple Silicon + Intel), Linux (amd64 + arm64) e Windows (amd64 + arm64) — nativamente tramite PowerShell o tramite WSL2 (Ubuntu / Kali).

macOS / Linux / WSL2

curl -fsSL https://decepticon.red/install | bash
decepticon onboard   # Interactive setup wizard (provider, API key, model profile)
decepticon           # Start the core stack and drop into the terminal CLI

L'avvio predefinito attiva il piano di gestione principale (LiteLLM, PostgreSQL, Neo4j, Skillogy, LangGraph, sandbox) e lancia la CLI del terminale. I carichi di lavoro specialistici (BloodHound CE, Sliver C2, REA/Ghidra, …) e la dashboard web vengono avviati su richiesta — l'orchestratore genera gli specialisti tramite ops_start("ad") ecc., e la dashboard viene avviata dall'interno della CLI con /web (vedi Web Dashboard).

Windows (PowerShell, nativo)

irm https://decepticon.red/install.ps1 | iex
decepticon onboard
decepticon

→ Avvio rapido · Procedura guidata completa

All'interno della CLI interattiva

Digita / per sfogliare i comandi, seleziona con Su/Giù, poi premi Invio. Tab completa il comando selezionato; gli alias compaiono anche nella guida e nell'autocompletamento.

Comando	Utilizzo
/help, /shortcuts	Scopri comandi o scorciatoie da tastiera
/model, /status	Scegli un modello configurato o ispeziona le connessioni della sessione
/plan	Entra nella modalità Plan opzionale, poi invia il tuo messaggio di pianificazione
/mode red, /mode blue	Torna a Red o seleziona l'indagine Blue
/new	Avvia una nuova conversazione nello stesso engagement e modalità quando inattivo
/sessions, /resume	Sfoglia le conversazioni salvate o continua il lavoro in pausa
/version (/about), /pwd (/cwd)	Controlla la versione in esecuzione e i percorsi del workspace
/quit, /exit	Esci dalla chat; i servizi e il lavoro del server continuano a funzionare

Invio invia; Shift+Invio, Alt+Invio o Ctrl+J aggiunge una riga. Su/Giù richiama la cronologia dell'input nella prima/ultima riga di input; Ctrl+R la cerca. Esc chiude prima l'interfaccia in focus, poi mette in pausa il lavoro attivo; /resume lo continua. Ctrl+A sposta all'inizio della riga corrente. Usa /queue per rivedere i messaggi in attesa prima di /new.

/new preserva le conversazioni salvate e lo scrollback del terminale; non crea un altro engagement né modifica l'autorizzazione del target. /plan e /new non accettano argomenti. Nel terminale web, usa i controlli di modalità della dashboard.

Le nuove scorciatoie e le comodità slash sopra descritte si riferiscono all'attuale main, incluse le modifiche non rilasciate. Un merge del sorgente non aggiorna le immagini installate. Vedi cronologia delle versioni, il riferimento completo della CLI e il comportamento di aggiornamento.

Utilizzo da Claude Code o Codex

Dopo aver avviato Decepticon, registra il suo server MCP nel tuo agente di coding:

claude mcp add --scope user decepticon -- decepticon mcp serve
codex mcp add decepticon -- decepticon mcp serve

Usa il comando per l'agente di coding che hai installato, poi esegui decepticon skill install per aggiungere la guida per l'operatore a entrambi gli agenti. Consulta la guida per agenti esterni per l'Agent Skill, il flusso di lavoro degli strumenti e il percorso di installazione dai sorgenti.

Uso come libreria (pip)

Vuoi costruire sopra gli agenti — un prodotto, un'integrazione di ricerca o un orchestratore personalizzato? Installa l'SDK da PyPI: