AppSec Agent

Agent de sécurité propulsé par l'IA pour la revue de code, l'analyse des PR, la modélisation des menaces, la génération de correctifs, et plus encore.

Vous pouvez utiliser AppSec Agent de trois manières :

Installer depuis npm : npm install appsec-agent

Prérequis

1. Node.js 18+ — nodejs.org
2. Une clé API — par défaut, le fournisseur Claude utilise ANTHROPIC_API_KEY (console Anthropic). Le fournisseur optionnel Codex utilise CODEX_API_KEY — voir Configuration.
3. Un terminal — les commandes ci-dessous utilisent npx ; si vous avez installé globalement, supprimez le préfixe npx.

Démarrage rapide (5 minutes)

1. Installer

npm install appsec-agent

Ou installez globalement pour que agent-run soit dans votre PATH :

npm install -g appsec-agent

2. Définir votre clé API

Ajoutez-la à votre profil shell (.zshrc, .bashrc, etc.), puis ouvrez un nouveau terminal :

export ANTHROPIC_API_KEY="your-key-here"

3. Lancer votre premier agent

# Interactive security Q&A (default role)
npx agent-run

# List every available role
npx agent-run -l

# Review code in the current project
npx agent-run -r code_reviewer -s ./src

C'est tout. Pour une installation pas à pas, le dépannage et l'exécution depuis un clone git, voir Démarrage rapide.

Choisir un agent

Chaque rôle est un workflow spécialisé. Passez-le avec -r / --role.

Descriptions complètes : Guide des agents
Commandes copiables et formats de fichiers JSON : Exemples

Commandes courantes

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

# Threat model (JSON)
npx agent-run -r threat_modeler -s ./src -f json -o threat_model_report.json

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

# Add deployment context (helps prioritize findings)
npx agent-run -r code_reviewer -s ./src -c "Production API on AWS, handles PII"

# Version and help
npx agent-run -v
npx agent-run --help

Documentation

Fonctionnalités en un coup d'œil

• Plusieurs agents spécialisés (revue, analyse de PR, modèle de menaces, correctif, QA, passes adverses)
• Backends Claude (par défaut) ou Codex (--provider codex)
• Sorties JSON structurées avec schémas pour l'intégration avec l'application parente
• Mode diff de PR et découpage automatique pour les grandes PR
• Outils MCP optionnels pour l'historique des constats en direct, les graphes d'import et les graphes de codebase
• Conception de bibliothèque thread-safe pour les serveurs web

Projets liés

AI Threat Modeler regroupe ce package dans une application Next.js dockerisée avec authentification, canevas de modélisation des menaces, export PDF/CSV et chat — le chemin le plus simple si vous ne voulez pas écrire de code d'intégration.

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

Licence et auteur

Sous licence Apache 2.0.

Sam Li — [email protected]

Références : Claude Agent SDK · Anthropic API