sistema avanzado seguridadterminalagentesappsecpentest

numasec: agente de terminal para auditorías con evidencias

Coordina herramientas de seguridad, alcance, hallazgos y evidencias desde una operación persistente. Puedes retomar una revisión y generar su informe desde lo registrado, con el modelo que hayas configurado.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en

Claude

ChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Dificultad: avanzado
Proyecto: https://github.com/FrancescoStabile/numasec (licencia AGPL-3.0)
Guía completa: https://lab.wisd.ai/hub/numasec

Para el agente: cómo acompañar al usuario

Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: elige un laboratorio y un proveedor

Comprueba que Node.js y npm están disponibles en la terminal. Define el objetivo autorizado y prepara acceso al modelo conforme al README. No incluyas claves en el informe ni en el historial que vayas a compartir.

Paso 2: instala la CLI

La vía npm del README es:

npm install -g numasec
numasec

Sigue la configuración de modelos que muestra la aplicación.

Paso 3: inspecciona el entorno

Dentro de numasec, los comandos documentados incluyen:

/doctor
/models
/mode appsec
/runbook list

Comprueba qué herramientas existen antes de elegir un runbook. Revisa alcance y autonomía en la operación antes de ejecutar acciones sobre el objetivo.

Comprobación

Usa una revisión pequeña de laboratorio. Comprueba que las observaciones enlazan evidencia y que el reporte distingue lo observado de las hipótesis. Verifica que puedes retomar la operación desde /operations, comando documentado en el README.

Si algo falla

Vuelve a /doctor para identificar dependencias faltantes y revisa /models si falla el proveedor. No amplíes el alcance para conseguir un resultado. Si una herramienta devuelve un error, consérvalo como tal y consulta su documentación antes de tratarlo como una vulnerabilidad.

Qué es

numasec es un agente de terminal para trabajo de seguridad autorizado. Integra herramientas locales con una operación que conserva objetivos, alcance, observaciones, hallazgos y evidencias. Está orientado a revisión de aplicaciones, pruebas de intrusión y entornos de práctica.

Para qué te sirve

Cuando debes retomar una auditoría sin reconstruir notas dispersas de varias sesiones.
Cuando quieres vincular cada hallazgo con lo que una herramienta observó y con su evidencia.
Cuando necesitas generar un entregable desde la operación revisada, en lugar de redactarlo desde el recuerdo.

Cómo funciona

La operación mantiene el contexto de trabajo. El agente usa superficies de terminal, archivos, navegador y HTTP, y enlaza resultados con evidencias y reportes. Los runbooks organizan procedimientos; los modos seleccionan el tipo de trabajo. El diagnóstico /doctor informa qué herramientas locales están listas o faltan.

El README distingue una posible vulnerabilidad de un hallazgo aplicable al objetivo. La consulta de inteligencia sobre una versión de software no demuestra que tu aplicación sea vulnerable. Revisa los resultados y su relación con el alcance antes de exportarlos.

Antes de empezar

Necesitas una terminal y Node.js con npm para la ruta descrita, además de acceso a un proveedor de modelos. El lanzador npm inicia un binario específico de tu plataforma; la ruta de desarrollo con Bun tiene requisitos propios. Las herramientas locales se preparan por separado según tu sistema. El código usa AGPL-3.0; las llamadas a modelos y servicios pueden tener costes propios. Practica con un laboratorio o un objetivo para el que tengas autorización.

Límites y alternativas

El agente puede ejecutar herramientas con los permisos del entorno. Define el alcance y revisa la autonomía antes de empezar una operación. Mantener evidencia mejora la revisión, pero no garantiza que el informe sea correcto. Para una comprobación puntual, ejecutar una herramienta conocida manualmente puede ser más sencillo que organizar una operación completa.

Recursos

Repo en GitHub - 822 estrellas, licencia AGPL-3.0.
Licencia - condiciones del código.
README - instalación, modos y operaciones.

Datos comprobados con GitHub el 26 oct 2026. Último commit en la rama predeterminada: 2026-05-08.