🛡️ GuardScan

100% gratuito e open source • CLI per la scansione della sicurezza e la revisione del codice con AI, con la privacy al primo posto

  ____ _   _   _    ____  ____    ____   ____    _    _   _            ____ _     ___ 
 / ___| | | | / \  |  _ \|  _ \  / ___| / ___|  / \  | \ | |          / ___| |   |_ _|
| |  _| | | |/ _ \ | |_) | | | | \___ \| |     / _ \ |  \| |  _____  | |   | |    | |
| |_| | |_| / ___ \|  _ <| |_| |  ___) | |___ / ___ \| |\  | |_____| | |___| |___ | | 
 \____|\___/_/   \_\_| \_\____/  |____/ \____/_/   \_\_| \_|          \____|_____|___|

 Privacy-First AI Code Review & Security Scanning

---

🎉 Completamente gratuito - Nessun abbonamento, nessun limite

GuardScan è 100% gratuito e open source! Nessun sistema di crediti, nessun paywall, nessun abbonamento.

Cosa ottieni (tutto GRATUITO)

• ✅ Analisi statica illimitata - 9 scanner di sicurezza + strumenti per la qualità del codice
• ✅ Revisione del codice potenziata dall'AI - Usa la tua chiave API (OpenAI, Claude, Gemini, Ollama)
• ✅ Funziona completamente offline - Nessuna connessione internet necessaria per l'analisi statica
• ✅ Privacy al primo posto - Non carica mai il tuo codice sorgente
• ✅ Nessun limite di utilizzo - Analizza LOC illimitate, repository illimitati

---

🚀 Avvio rapido

# Install globally via npm
npm install -g guardscan

# Initialize GuardScan
guardscan init

# Run comprehensive security scan (100% FREE, offline)
guardscan security

# Configure AI provider for enhanced review (optional, BYOK)
guardscan config

# Run AI-enhanced code review
guardscan run

# Check status
guardscan status

🐳 Docker / Alpine Linux

Per ambienti Docker, in particolare Alpine Linux:

# Install dependencies first
apk add --no-cache python3 make g++ pkgconfig cairo-dev pango-dev \
  libjpeg-turbo-dev giflib-dev pixman-dev freetype-dev build-base git

# Install GuardScan
npm install -g guardscan

# Set home directory (important for Docker)
export GUARDSCAN_HOME=/app/.guardscan

# Initialize
guardscan init

Documentazione:

• 📖 Guida completa a Docker - Guida completa per Linux, macOS e Windows
• 🐧 Riferimento rapido Docker e Alpine - Riferimento rapido specifico per Alpine Linux

---

📋 Funzionalità principali

🔒 Scansione di sicurezza (GRATUITA, offline)

GuardScan include scanner di sicurezza completi:

1. Rilevamento dei segreti - Trova chiavi API, password e token codificati nel codice (oltre 20 pattern)
2. Vulnerabilità delle dipendenze - Scansiona le dipendenze npm, pip, Maven, Cargo
3. OWASP Top 10 - SQL injection, XSS, configurazioni non sicure, CSRF, XXE
4. Sicurezza Docker - Scansione di Dockerfile e container
5. Infrastructure as Code - Sicurezza di Terraform, CloudFormation, Kubernetes
6. Sicurezza delle API - Analisi degli endpoint REST e GraphQL

📊 Qualità e analisi del codice (GRATUITA, offline)

7. Metriche del codice - Complessità ciclomatica, metriche di Halstead, indice di manutenibilità
8. Code smell - Oltre 30 anti-pattern (god class, metodi lunghi, numeri magici)
9. Conformità delle licenze - Verifica delle licenze delle dipendenze (MIT, GPL, Apache, ecc.)
10. Verifiche di conformità - Scansione di conformità GDPR, HIPAA, PCI-DSS
11. Integrazione con i linter - ESLint, Pylint, RuboCop, ecc.
12. Contatore LOC - Conteggio delle righe consapevole del linguaggio (oltre 20 linguaggi)

🧪 Test e prestazioni (GRATUITI, offline)

13. Test runner - Esegue e analizza i test Jest, pytest, JUnit
14. Mutation testing - Verifica l'efficacia della suite di test (richiede Stryker - opzionale)
15. Test delle prestazioni - Load testing e benchmarking (richiede k6 - opzionale)
16. Generazione SBOM - Software Bill of Materials (CycloneDX, SPDX)

Nota: i test delle prestazioni e di mutazione richiedono strumenti esterni opzionali.

🤖 Funzionalità potenziate dall'IA (BYOK - Bring Your Own Key)

9 funzionalità avanzate basate sull'IA:

1. Spiegazione del codice (guardscan explain) - Comprendi codice complesso
2. Revisione del codice (guardscan review) - Revisione completa del codice con IA
3. Generatore di commit (guardscan commit) - Genera messaggi di commit
4. Generatore di documentazione (guardscan docs) - Genera automaticamente la documentazione
5. Generatore di test (guardscan test-gen) - Genera unit test
6. Suggerimenti di refactoring (guardscan refactor) - Migliora la qualità del codice
7. Threat modeling (guardscan threat-model) - Analisi dell'architettura di sicurezza
8. Assistente alla migrazione (guardscan migrate) - Migrazioni di framework/linguaggi
9. Chat interattiva (guardscan chat) - Domande e risposte sul codebase basate su RAG

🌍 Supporto multilingua

Parser AST per oltre 7 linguaggi:

• TypeScript/JavaScript
• Python
• Java
• Go
• Rust
• Ruby
• PHP
• C#

🔌 Integrazioni con provider di IA

Configura il provider di IA che preferisci:

• OpenAI (GPT-4, GPT-4 Turbo, GPT-3.5)
• Anthropic Claude (Claude 3 Opus, Sonnet, Haiku)
• Google Gemini (Gemini Pro)
• Ollama (locale, incentrato sulla privacy - llama2, codellama, mistral)
• LM Studio (modelli locali)
• OpenRouter (accesso a più modelli)

Paghi direttamente il provider di IA - GuardScan non addebita nulla!

---

🛠️ Comandi

Tutti i comandi sono 100% GRATUITI e senza limiti!

Comandi di configurazione

Comando	Descrizione
guardscan init	Inizializza la configurazione, genera client_id
guardscan config	Configura il provider di IA e le impostazioni
guardscan status	Mostra la configurazione e le informazioni sul repository
guardscan reset	Cancella la cache e la configurazione locali

Comandi di sicurezza e analisi

Comando	Descrizione
guardscan security	Esegue una scansione di sicurezza completa (offline)
guardscan scan	Scansione di sicurezza rapida
guardscan run	Revisione completa del codice potenziata dall'IA (BYOK)

Comandi di test e qualità

Comando	Descrizione
guardscan test	Esegue test e analisi della qualità del codice
guardscan perf	Test delle prestazioni e test di carico (richiede k6 - opzionale)
guardscan mutation	Mutation testing per la qualità dei test (richiede Stryker - opzionale)

Nota: i comandi perf e mutation richiedono strumenti esterni opzionali. Consulta la Guida agli strumenti di testing per dettagli su installazione e utilizzo.

Comandi di utilità

Comando	Descrizione
guardscan sbom	Genera un Software Bill of Materials
guardscan rules	Motore di regole personalizzate basato su YAML

Comandi basati sull'AI (BYOK)