Pensar Apex

Pruebas de penetración impulsadas por IA mediante agentes autónomos, directamente en tu terminal. Ejecuta pentests de caja negra y caja blanca que exploran, razonan y revelan vulnerabilidades reales.

¿Quieres ejecutarlo desde la nube o integrarlo con tu CI/CD? Consulta Pensar Console.

Casos de uso

Desarrolladores

• Ejecuta /pentest antes de fusionar un PR: detecta vulnerabilidades con la misma naturalidad con la que ejecutas pruebas
• Obtén hallazgos procesables con puntuaciones de severidad, evidencia y correcciones sugeridas, sin necesidad de conocimientos de seguridad
• Integra en CI/CD mediante comandos CLI headless o Pensar Console

Ingenieros de seguridad

• Despliega pruebas de enjambre impulsadas por agentes en grandes superficies de ataque
• Usa el modo /operator para investigación manual, encadenamiento de exploits y validación
• Automatiza flujos de trabajo de pruebas repetitivas con memoria persistente que se acumula entre proyectos
• Escala entre equipos y proyectos mediante Pensar Console

Instalación

Uso

Abre la TUI de Apex:

pensar

CLI sin interfaz (headless)

Ejecuta pentests sin la TUI para scripting, CI o integración con evalgate:

# Basic pentest
pensar pentest --target https://example.com

# With extended thinking and task-driven mode
pensar pentest --target https://example.com --extended-thinking --task-driven

# Whitebox (with source code access)
pensar pentest --target https://example.com --cwd ./my-app

# Targeted pentest with specific objectives
pensar targeted-pentest --target https://example.com --objective "Test authentication bypass"

Registro

Apex enruta el registro de diagnóstico/operaciones a través de un registrador estructurado centralizado (src/core/logger). Escribe JSON de una línea a stderr cuando la salida no es una TTY — manteniéndolo separado del stdout del programa y fácil de enviar a un pipeline de logs (por ejemplo, CloudWatch) — y una salida bonita y coloreada en una terminal interactiva. La salida CLI/TUI orientada al usuario permanece en stdout.

Establece el nivel (de más a menos verboso: debug < info < warn < error, por defecto info):

pensar pentest --target https://example.com --log-level debug   # or --verbose / --quiet
PENSAR_LOG_LEVEL=debug pensar ...                                # via environment
PENSAR_DEBUG=1 pensar ...                                        # back-compat alias for debug

Orden de resolución: flag CLI → PENSAR_LOG_LEVEL → PENSAR_DEBUG → info por defecto. PENSAR_LOG_FORMAT=json|pretty fuerza el formato de salida. Cuando Apex se ejecuta como agente gestionado, PENSAR_LOG_LEVEL lo proporciona el entorno host.

Trazado con W&B Weave

Transmite trazas de agentes a nivel de paso a Weights & Biases Weave para análisis y ajuste fino:

export WANDB_API_KEY=your-key
export WANDB_ENTITY=your-entity
# WANDB_PROJECT defaults to "apex-traces"
pensar pentest --target https://example.com

Las trazas incluyen pasos de razonamiento, llamadas a herramientas, uso de tokens y puntos de control de estado. Cuando no se establecen credenciales, el trazado se desactiva silenciosamente.

OpenTelemetry (Observabilidad)

Apex emite spans de OpenTelemetry para las ejecuciones de agentes, las llamadas a LLM y las ejecuciones de herramientas a través de @opentelemetry/api. Los spans son no-ops a menos que tu proceso registre un SDK de OpenTelemetry como proveedor global de trazado; Apex no incluye ningún SDK.

Registra un SDK antes de importar el código de Apex:

• Sentry: instala @sentry/node ≥ 9.27 y añade Sentry.vercelAIIntegration() a las integraciones de tu Sentry.init.
• Cualquier backend OTel (Honeycomb, Tempo, Datadog, etc.): registra @opentelemetry/sdk-node con un exportador OTLP.

Los spans siguen las convenciones semánticas de GenAI de OTel. De forma predeterminada solo se captura la forma del span (modelo, recuentos de tokens, latencia, nombres de herramientas); establece AI_TRACE_RECORD_PAYLOADS=true para registrar también prompts, E/S de herramientas y salidas.

Contenedor Kali Linux (Opcional)

Para obtener el mejor rendimiento, ejecuta Apex en el contenedor Kali Linux incluido con herramientas de pentest preconfiguradas:

cd container
cp env.example .env  # add your API keys
docker compose up --build -d
docker compose exec kali-apex bash

Dentro del contenedor, ejecuta:

pensar

⚠️ Uso Responsable

Este repositorio contiene herramientas exclusivamente para pruebas de seguridad autorizadas. Antes de usarlo, lee y acepta la Divulgación de Uso Responsable.