:```text
Scanning 118 file(s)...

── claude-code ──────────────────────────────────────────────
/home/ross/.claude/history.jsonl  (13 finding(s))
[CRITICAL] Anthropic API key (anthropic)
    /home/ross/.claude/history.jsonl:1005:13
    sk-ant-api03***...***
[CRITICAL] PyPI API token (pypi)
    /home/ross/.claude/history.jsonl:125:94
    pypi-AgEIc***...***
[CRITICAL] GitHub fine-grained PAT (github)
    /home/ross/.claude/history.jsonl:2306:13
    github_pat_11A***...***
[HIGH]     HuggingFace token (huggingface)
    /home/ross/.claude/history.jsonl:3387:13
    hf_JOi***...***
...

Total: 13 credentials across 1 file(s).
Report:  /home/ross/.medusa/secrets-scan/secrets-20260519-074452.json

Esta versión se centra principalmente en múltiples adiciones (como fuerza bruta no lineal, craqueo pasivo, descifrado, craqueo de múltiples claves, etc.), en nuevas características como APi y en la optimización de recursos.

Para obtener una descripción completa de todas las adiciones y cambios (y sus autores), visita el [archivo Changelog](https://github.com/pantheon-security/medusa/blob/HEAD/CHANGELOG.md)```text
[CRITICAL] PyPI API token  (pypi)
    /home/ross/.claude/history.jsonl:125:94
    pypi-AgEIc***...***
  redact?  [y/n/s/a/q/?]: y

[CRITICAL] Anthropic API key  (anthropic)
    /home/ross/.claude/history.jsonl:1005:13
    sk-ant-api03***...***
  redact?  [y/n/s/a/q/?]: y
...

✓ /home/ross/.claude/history.jsonl  (13 redacted)
    backup → /home/ross/.medusa/secrets-scan/backups/20260519-074452/home/ross/.claude/history.jsonl

### Lo que se detecta (21 emisores)

**Proveedores de IA**: Anthropic, OpenAI, HuggingFace, Replicate, Cohere
**Registros de paquetes**: PyPI, npm
**Forjas de código**: GitHub PAT (clásico + fine-grained + OAuth + App), GitLab PAT
**Nube**: claves de acceso AWS, JSON de cuenta de servicio GCP
**Pagos / comunicaciones**: claves live/restricted de Stripe, tokens de bot/usuario de Slack, SendGrid, Twilio, webhooks de Discord
**Criptografía**: claves privadas codificadas en PEM (RSA, DSA, EC, OpenSSH, PGP)

### Propiedades de seguridad

- **Solo local.** Informes en `~/.medusa/secrets-scan/` con modo `0o600`. Sin red, sin telemetría, nunca se escribe en los árboles del proyecto.
- **Copia de seguridad antes de escribir.** Toda redacción va precedida de una copia de seguridad idéntica byte a byte. `cp` la restaura.
- **Seguro para JSONL.** El marcador de redacción no contiene caracteres no seguros para JSON; las líneas afectadas se vuelven a analizar tras la escritura.
- **Rechazo ante cambios.** Si el archivo fuente cambió entre el escaneo y la purga, el purgador se niega en lugar de arriesgarse a sobrescribir una edición.
- **Escritura atómica.** Archivo temporal + intercambio con `os.replace`. O se aplica la reescritura o el original permanece.

[**📖 Guía completa del escáner de secretos →**](https://github.com/pantheon-security/medusa/blob/HEAD/docs/SECRETS_SCANNER.md)

---

## 🚀 Inicio Rápido

### Instalación```bash
# Install MEDUSA (works on Windows, macOS, Linux)
pip install medusa-security

# Run your first scan - that's it!
medusa scan .

**Notas de plataforma:**
- **Windows**: Usa `py -m medusa` si el comando `medusa` no se encuentra
- **macOS/Linux**: Debería funcionar sin configuración adicional

### Escanear cualquier repositorio de GitHub```bash
# Scan a remote repo for AI supply chain attacks
medusa scan --git https://github.com/org/repo

# Shorthand - just user/repo
medusa scan --git org/repo

# Scan a specific branch
medusa scan --git https://github.com/org/repo/tree/main

### Opcional: Linters externos

MEDUSA detecta automáticamente linters externos si están instalados (bandit, eslint, shellcheck, etc.) y los utiliza automáticamente para mejorar la cobertura del escaneo.

**[Ver Guía de Instalación →](https://github.com/pantheon-security/medusa/blob/HEAD/docs/OPTIONAL_TOOLS.md)** para instrucciones específicas de la plataforma.

> **Nota:** Los linters externos son opcionales. Las 40,000+ reglas integradas de MEDUSA funcionan sin ellos. Para soporte de instalación, consulte la documentación de cada proveedor de herramientas.

### Demo

<div align="center">

![MEDUSA en acción](https://assets.kitploit.com/production/public/readmes/49181/80281d742fbec3c1bf5c3cb62999af22a9fcfb2bdb89ba79eec5d27b80716e7a.gif)

</div>

### 📊 Formatos de Informe

MEDUSA genera informes atractivos en múltiples formatos:

**JSON** - Legible por máquina para integración con CI/CD```bash
medusa scan . --format json

**Markdown** - Apto para documentación en GitHub/wikis```bash
medusa scan . --format markdown

---

## 📚 Soporte de Idiomas

MEDUSA admite **79 tipos de escáner** que cubren seguridad de IA/ML, todos los principales lenguajes de programación y formatos de archivo:

### Lenguajes Backend (9)
| Lenguaje | Escáner | Extensiones |
|----------|---------|------------|
| Python | Bandit | `.py` |
| JavaScript/TypeScript | ESLint | `.js`, `.jsx`, `.ts`, `.tsx` |
| Go | golangci-lint | `.go` |
| Ruby | RuboCop | `.rb`, `.rake`, `.gemspec` |
| PHP | Reglas nativas (+ PHPStan opcional) | `.php` |
| Rust | Reglas nativas (+ Clippy opcional) | `.rs` |
| Java | Checkstyle | `.java` |
| C/C++ | cppcheck | `.c`, `.cpp`, `.cc`, `.cxx`, `.h`, `.hpp` |
| C# | Roslynator | `.cs` |

### Lenguajes JVM (3)
| Lenguaje | Escáner | Extensiones |
|----------|---------|------------|
| Kotlin | ktlint | `.kt`, `.kts` |
| Scala | Scalastyle | `.scala` |
| Groovy | CodeNarc | `.groovy`, `.gradle` |

### Lenguajes Funcionales (5)
| Lenguaje | Escáner | Extensiones |
|----------|---------|------------|
| Haskell | HLint | `.hs`, `.lhs` |
| Elixir | Credo | `.ex`, `.exs` |
| Erlang | Elvis | `.erl`, `.hrl` |
| F# | FSharpLint | `.fs`, `.fsx` |
| Clojure | clj-kondo | `.clj`, `.cljs`, `.cljc` |

### Desarrollo Móvil (2)
| Lenguaje | Escáner | Extensiones |
|----------|---------|------------|
| Swift | SwiftLint | `.swift` |
| Objective-C | OCLint | `.m`, `.mm` |

### Frontend y Estilos (3)
| Lenguaje | Escáner | Extensiones |
|----------|---------|------------|
| CSS/SCSS/Sass/Less | Stylelint | `.css`, `.scss`, `.sass`, `.less` |
| HTML | HTMLHint | `.html`, `.htm` |
| Vue.js | ESLint | `.vue` |

### Infraestructura como Código (4)
| Lenguaje | Escáner | Extensiones |
|----------|---------|------------|
| Terraform | tflint | `.tf`, `.tfvars` |
| Ansible | ansible-lint | `.yml` (playbooks) |
| Kubernetes | kubeval | `.yml`, `.yaml` (manifiestos) |
| CloudFormation | cfn-lint | `.yml`, `.yaml`, `.json` (plantillas) |

### Archivos de Configuración (4)
| Lenguaje | Escáner | Extensiones |
|----------|---------|------------|
| JSON | integrado | `.json` |
| TOML | taplo | `.toml` |
| XML | xmllint | `.xml` |
| Protobuf | buf lint | `.proto` |

### Shell y Scripts (4)
| Lenguaje | Escáner | Extensiones |
|----------|---------|------------|
| Bash/Shell | ShellCheck | `.sh`, `.bash` |
| PowerShell | PSScriptAnalyzer | `.ps1`, `.psm1` |
| Lua | luacheck | `.lua` |
| Perl | perlcritic | `.pl`, `.pm` |

### Documentación (2)
| Lenguaje | Escáner | Extensiones |
|----------|---------|------------|
| Markdown | markdownlint | `.md` |
| reStructuredText | rst-lint | `.rst` |

### Otros Lenguajes (5)
| Lenguaje | Escáner | Extensiones |
|----------|---------|------------|
| SQL | SQLFluff | `.sql` |
| R | lintr | `.r`, `.R` |
| Dart | dart analyze | `.dart` |
| Solidity | solhint | `.sol` |
| Docker | hadolint | `Dockerfile*` |

**Total: 79 tipos de escáner — 41 escáneres de lenguaje/herramientas + 38 escáneres de seguridad de IA/ML — que cubren más de 100 extensiones de archivo**

---

## 🚨 Detección de CVE React2Shell (NUEVO en v2025.8)

MEDUSA ahora detecta **CVE-2025-55182 "React2Shell"** - una vulnerabilidad RCE con CVSS 10.0 que afecta a React Server Components y Next.js.```bash
# Check if your project is vulnerable
medusa scan .

# Vulnerable versions detected:
# - React 19.0.0 - 19.2.0 (Server Components)
# - Next.js 15.0.0 - 15.0.4 (App Router)
# - Various canary/rc releases

### Escaneo rápido de seguridad con IA```bash
# Scan AI configuration files
medusa scan . --ai-only

# Example output:
# 🔍 AI Security Scan Results
# ├── .cursorrules: 3 issues (1 CRITICAL, 2 HIGH)
# │   └── AIC001: Prompt injection - ignore previous instructions (line 15)
# │   └── AIC011: Tool shadowing - override default tools (line 23)
# ├── mcp-config.json: 2 issues (2 HIGH)
# │   └── MCP003: Dangerous path - home directory access (line 8)
# └── rag_config.json: 1 issue (1 CRITICAL)
#     └── AIR010: Knowledge base injection pattern detected (line 45)

### Comandos de instalación```bash
# Check tool status
medusa install --check

# Install AI tools (modelscan for ML model scanning)
medusa install --ai-tools

# Show detailed output
medusa install --ai-tools --debug

### Comandos adicionales```bash
# Uninstall modelscan
medusa uninstall modelscan

# Check for updates
medusa version --check-updates

# Show current configuration
medusa config

# Override scanner for specific file
medusa override path/to/file.yaml YAMLScanner

# List available scanners
medusa override --list

# Show current overrides
medusa override --show

# Remove override
medusa override path/to/file.yaml --remove

### Generar Configuración Predeterminada```bash
medusa init

### Claude Code

**Lo que crea:**
- `CLAUDE.md` - Archivo de contexto del proyecto
- `.claude/agents/medusa/agent.json` - Configuración del agente
- `.claude/commands/medusa-scan.md` - Comando de barra para el escaneo
- `.claude/commands/medusa-install.md` - Comando de barra para la instalación

**Uso:**```
Type: /medusa-scan
Claude: *runs security scan*
Results: Displayed in terminal + chat

### OpenAI Codex

**Qué crea:**
- `AGENTS.md` - Contexto del proyecto (nivel raíz)

**Uso:**```
Ask: "Run a security scan"
Codex: *executes medusa scan .*

### Caché Inteligente

El caché basado en hash omite archivos sin cambios:```bash
# First scan
📂 Files scanned: 145
⏱️  Total time: 47.28s

# Second scan (no changes)
📂 Files scanned: 0
⚡ Files cached: 145
⏱️  Total time: 2.15s  # 22× faster!

---

## 📊 Ejemplo de Flujo de Trabajo

### Configuración de Nuevo Proyecto```bash
# 1. Initialize
cd my-awesome-project
medusa init

🐍 MEDUSA Initialization Wizard

✅ Step 1: Project Analysis
   Found 15 language types
   Primary: PythonScanner (44 files)

✅ Step 2: Scanner Availability
   Available: 6/79 scanners
   Missing: 73 tools

✅ Step 3: Configuration
   Created .medusa.yml
   Auto-detected IDE: Claude Code

✅ Step 4: IDE Integration
   Created .claude/agents/medusa/agent.json
   Created .claude/commands/medusa-scan.md

✅ MEDUSA Initialized Successfully!

# 2. First scan
medusa scan .

🔍 Issues found: 23
   CRITICAL: 0
   HIGH: 2
   MEDIUM: 18
   LOW: 3

# 3. Fix issues and rescan
medusa scan . --quick

⚡ Files cached: 142
🔍 Issues found: 12  # Progress!

  - name: Set up Python
    uses: actions/setup-python@v4
    with:
      python-version: '3.11'

  - name: Install MEDUSA
    run: pip install medusa-security

  - name: Run security scan
    run: medusa scan . --fail-on high

> **Nota**: No se necesita ningún paso de instalación de herramientas - las 40,000+ reglas integradas de MEDUSA funcionan inmediatamente.

---

## 🏗️ Arquitectura

### Patrón del escáner

Todos los escáneres siguen un patrón consistente:```python
class PythonScanner(BaseScanner):
    """Scanner for Python files using Bandit"""

    def get_tool_name(self) -> str:
        return "bandit"

    def get_file_extensions(self) -> List[str]:
        return [".py"]

    def scan_file(self, file_path: Path) -> ScannerResult:
        # Run bandit on file
        # Parse JSON output
        # Map severity levels
        # Return structured issues
        return ScannerResult(...)

### Mapa de Severidad

Niveles de severidad unificados en todas las herramientas:

- **CRITICAL** - Vulnerabilidades de seguridad, errores fatales
- **HIGH** - Errores, advertencias de seguridad
- **MEDIUM** - Advertencias, problemas de calidad de código
- **LOW** - Problemas de estilo, convenciones
- **INFO** - Sugerencias, oportunidades de refactorización

---

## 🧪 Pruebas y Calidad

### Resultados de Dogfooding

MEDUSA se escanea a sí misma — y proyectos del mundo real:```
Self-scan (473 files):
  ✅ Issues found: 114 (pre-filter) → 0 (post-filter)
  ✅ FP reduction: 100% on own codebase
  ⏱️  Time: 8.2s

OpenClaw benchmark (4,124 files, 751K LOC):
  🔍 Issues found: 825 (post-filter)
  ✅ FPs filtered: 11,436 (93.9% reduction)
  ⏱️  Time: 3.3 hours (79 scanners)

### Añadir Nuevos Escáneres

Consulta `docs/development/adding-scanners.md` para una guía sobre cómo añadir soporte para nuevos lenguajes.

---

## 📜 Licencia

AGPL-3.0-or-later - Consulta el archivo [LICENSE](https://github.com/pantheon-security/medusa/blob/HEAD/LICENSE)

MEDUSA es software libre y de código abierto. Puedes usarlo, modificarlo y distribuirlo libremente, pero cualquier modificación u obra derivada (incluidos los despliegues SaaS) también debe publicarse bajo AGPL-3.0.

Para opciones de licencia comercial, contacta: [email protected]

---

## Próximamente

MEDUSA Professional añade **protección en tiempo de ejecución** para aplicaciones LLM en producción: bloquea la inyección de prompts, el jailbreaking y los intentos de exfiltración de datos en tiempo real antes de que lleguen a tus modelos.

| Característica | Open Source | Professional | Enterprise |
|---------|-------------|--------------|------------|
| Escaneo estático (más de 40 000 patrones) | Sí | Sí | Sí |
| Filtros de proxy en tiempo de ejecución (más de 1 100) | - | Sí | Sí |
| API REST y webhooks | - | Sí | Sí |
| Reglas personalizadas y SSO | - | - | Sí |
| **Precio** | Gratis | $99/dev/mes | $499/50 devs/mes |

El proxy de tiempo de ejecución está actualmente en beta privada. Si proteges aplicaciones LLM en producción y quieres acceso anticipado, contacta con **[email protected]**.

---

## 🙏 Créditos

**Desarrollo:**
- Pantheon Security
- Claude AI (Anthropic) - desarrollo asistido por IA

**Construido con:**
- Python 3.10+
- Click - framework de CLI
- Rich - formato de terminal
- Bandit, ESLint, ShellCheck y más de 39 otras herramientas de seguridad de código abierto

**Inspirado por:**
- Bandit (seguridad de Python)
- SonarQube (análisis multilingüe)
- Semgrep (seguridad basada en patrones)
- Mega-Linter (linting integral)

---

## 📖 Guías

- **[Inicio rápido](https://github.com/pantheon-security/medusa/blob/HEAD/docs/guides/quick-start.md)** - En funcionamiento en 5 minutos
- **[Escaneo de seguridad de IA](https://github.com/pantheon-security/medusa/blob/HEAD/docs/AI_SECURITY.md)** - Guía completa de seguridad IA/LLM (OWASP 2025, MCP, RAG)
- **[Gestión de falsos positivos](https://github.com/pantheon-security/medusa/blob/HEAD/docs/guides/handling-false-positives.md)** - Reduce el ruido, encuentra problemas reales
- **[Integración con IDE](https://github.com/pantheon-security/medusa/blob/HEAD/docs/guides/ide-integration.md)** - Configura Claude Code, Gemini, Copilot

---

## 📞 Soporte

- **GitHub Issues**: [Reporta errores o solicita funciones](https://github.com/Pantheon-Security/medusa/issues)
- **Correo electrónico**: [email protected]
- **Documentación**: https://docs.pantheonsecurity.io
- **Discord**: https://discord.gg/medusa (próximamente)

---

## 📈 Estadísticas

**Versión**: 2026.5.5
**Fecha de lanzamiento**: 2026-04-03
**Patrones de detección**: más de 40 000 reglas de seguridad de IA
**Analizadores**: 79 escáneres especializados
**Patrones de filtro de FP**: 514 filtros inteligentes (tasa de reducción del 96.8%)
**Cobertura CVE**: 200 vulnerabilidades críticas (más de 37 CVE de editores de IA)
**Envenenamiento de repositorios**: se detectan más de 28 tipos de archivos de configuración de editores de IA
**Cobertura de lenguajes**: más de 46 tipos de archivos
**Soporte de plataformas**: Linux, macOS, Windows
**Integración con IA**: Claude Code, Gemini CLI, GitHub Copilot, Cursor, OpenAI Codex
**Estándares**: OWASP Top 10 para LLM 2025, MITRE ATLAS
**Descargas**: más de 11 500 en PyPI

---

## 🌟 ¿Por qué MEDUSA?

### vs. Bandit
- ✅ Más de 40 000 patrones (no solo seguridad de Python)
- ✅ Cobertura de seguridad IA/ML
- ✅ Sin configuración previa necesaria
- ✅ Integración con IDE

### vs. SonarQube
- ✅ Configuración más sencilla (`pip install && scan`)
- ✅ Sin necesidad de servidor
- ✅ Enfoque de seguridad centrado en IA
- ✅ Gratis y de código abierto

### vs. Semgrep
- ✅ Reglas específicas de IA/ML integradas
- ✅ Seguridad de MCP, RAG y agentes
- ✅ Mejor integración con IDE
- ✅ Sin necesidad de configurar reglas

### vs. SAST tradicional
- ✅ Funciona de inmediato (sin instalación de herramientas)
- ✅ Patrones de seguridad de IA incluidos
- ✅ Procesamiento en paralelo
- ✅ Caché inteligente

---

**🐍🐍🐍 MEDUSA - Escáner de Seguridad Multilenguaje 🐍🐍🐍**

**Un solo comando. Seguridad completa.**```bash
medusa init && medusa scan .