Agente AppSec

Agenti di sicurezza basati su AI per revisione del codice, scansione PR, modellazione delle minacce, generazione di correzioni e altro.

Puoi usare AppSec Agent in tre modi:

Installa da npm: npm install appsec-agent

Cosa ti serve prima

1. Node.js 18+ — nodejs.org
2. Una chiave API — per impostazione predefinita il provider Claude utilizza ANTHROPIC_API_KEY (Console Anthropic). Il provider opzionale Codex utilizza CODEX_API_KEY — consulta Configurazione.
3. Un terminale — i comandi seguenti usano npx; se hai installato globalmente, ometti il prefisso npx.

Avvio rapido (5 minuti)

1. Installa

npm install appsec-agent

Oppure installa globalmente così agent-run è nel tuo PATH:

npm install -g appsec-agent

2. Imposta la tua chiave API

Aggiungi al tuo profilo shell (.zshrc, .bashrc, ecc.), poi apri un nuovo terminale:

export ANTHROPIC_API_KEY="your-key-here"

3. Esegui il tuo primo agente

# Domande e risposte interattive sulla sicurezza (ruolo predefinito)
npx agent-run

# Elenca ogni ruolo disponibile
npx agent-run -l

# Revisiona il codice nel progetto corrente
npx agent-run -r code_reviewer -s ./src

Questo è tutto. Per una configurazione passo-passo, risoluzione dei problemi ed esecuzione da un clone git, consulta Per iniziare.

Scegli un agente

Ogni ruolo è un flusso di lavoro specializzato. Passalo con -r / --role.

Descrizioni complete: Guida agli agenti
Comandi copia-incolla e formati di file JSON: Esempi

Comandi comuni

# Revisione sicurezza PR (report JSON)
npx agent-run -r pr_reviewer --diff-context pr-diff.json -s ./repo -f json -o report.json

# Modello di minaccia (JSON)
npx agent-run -r threat_modeler -s ./src -f json -o threat_model_report.json

# Usa OpenAI Codex invece di Claude (opt-in)
npx agent-run -r threat_modeler -s ./src -f json --provider codex -m gpt-4.1

# Aggiungi contesto di deployment (aiuta a prioritizzare i risultati)
npx agent-run -r code_reviewer -s ./src -c "API di produzione su AWS, gestisce PII"

# Versione e aiuto
npx agent-run -v
npx agent-run --help

Documentazione

Caratteristiche in sintesi

• Agenti specializzati multipli (revisione, scansione PR, modellazione minacce, correzione, QA, passaggi avversari)
• Backend Claude (predefinito) o Codex (--provider codex)
• Output JSON strutturati con schemi per l'integrazione con l'app principale
• Modalità diff PR e suddivisione automatica per PR grandi
• Strumenti MCP opzionali per cronologia risultati in tempo reale, grafici di import e grafici del codebase
• Progettazione della libreria thread-safe per server web

Progetti correlati

AI Threat Modeler raggruppa questo pacchetto in un'app Next.js containerizzata con autenticazione, canvas per modelli di minaccia, esportazione PDF/CSV e chat — il percorso più semplice se non vuoi scrivere codice di integrazione.

git clone https://github.com/yangsec888/ai-threat-modeler.git
cd ai-threat-modeler
docker-compose up -d --build
# Apri http://localhost:3000  (default: admin / admin)

Licenza e autore

Concesso in licenza Apache 2.0.

Sam Li — [email protected]

Riferimenti: Claude Agent SDK · Anthropic API