Privacidad y seguridad

Corre en tu máquina y te dice qué envía

pinright es un proceso local que habla con tu agente por stdio. Sin cuenta, sin telemetría. Esta página resume SECURITY.md y el modelo de amenazas del hook, los dos en inglés.

En tu máquina

  • Sin scripts preinstall, install ni postinstall. Instalarlo no ejecuta código.
  • Cuatro dependencias de ejecución, fijadas en versiones exactas. Las versiones se publican desde GitHub Actions con npm provenance.
  • Nunca ejecuta lo que descarga. Los archivos comprimidos, los README y la documentación se procesan como texto y le llegan al agente como datos.
  • Lee los archivos de dependencias de tu proyecto y solo escribe en su directorio de caché y, cuando ejecutas init, en los archivos de configuración del agente que nombra.

Qué envía y a quién

Cada solicitud va de tu máquina a un servicio público, por el paquete que consultaste. pinright nunca envía tu código fuente, el contenido de tus archivos ni tu entorno. Los nombres que revisas sí llegan a esos servicios, y eso incluye el nombre de un paquete privado.

ServicioQué recibeCuándo
api.deps.dev, api.osv.devecosistema, nombre del paquete, versiónen cada revisión
Registros: npm, PyPI, pypistats, crates.io, RubyGems, Packagistnombre del paquete, versiónrevisiones, señales de riesgo, documentación
cdn.jsdelivr.net, data.jsdelivr.comnombre del paquete, versión, ruta del archivodocumentación del paquete publicado
api.github.com, raw.githubusercontent.comrepositorio, tag, ruta del archivodocumentación del repositorio, guías de actualización, auditoría de Actions
El sitio de documentación del propio paqueteuna solicitud de /llms.txt y de las páginas que listacuando los metadatos del paquete nombran un sitio

La única credencial, un GITHUB_TOKEN opcional, va solo a api.github.com. Las URL que vienen de los metadatos de un paquete pasan por un filtro: solo https, ninguna dirección privada, de loopback ni de metadatos de la nube (se vuelve a revisar después del DNS y en cada una de 3 redirecciones como máximo), y un tope de 10 MB para el cuerpo.

El hook es una barrera de protección y no aísla procesos

Lee líneas de comando y contenidos de archivos antes de que corra la herramienta. Ayuda a un agente honesto que se equivoca y frena a uno que una inyección de prompts convence de instalar algo. No vigila el proceso ni la red.

Lo que frena o consulta

  • Las instalaciones que puede leer, a través de bash -c, eval, $(…), cmd /c, powershell -Command, sudo, xargs y scripts ejecutados por nombre.
  • Las escrituras en manifiestos y workflows: solo cuentan las dependencias nuevas o cambiadas.
  • Lo que no puede leer (un nombre en una variable, una fuente git o URL, otro registro) pregunta por defecto.
  • Los cambios en .pinright.json o en la entrada del propio hook siempre pasan por una persona.
  • Más de 40 dependencias en un mismo cambio hacen que pregunte, así el relleno no puede esconder una mala.

Lo que se le escapa

  • Código que instala desde dentro de un programa: python -c "subprocess.run(['pip', ...])".
  • Scripts remotos como curl … | sh: los registra pero no los lee.
  • Ofuscación más allá de lo que resuelve un lector de shell, y variables definidas en una llamada a herramienta anterior.
  • Herramientas a las que el hook no está conectado, y todo lo que pase después de que dijo que sí: una persona que escribe npm install, un job de CI.
  • Lo que hace un paquete permitido después de instalarse.

El modelo de amenazas lista 57 vectores para saltarse el hook, cada uno reproducido en test/hookBypass.test.ts. Combina el hook con un registro proxy, npm ci o pip install --require-hashes en CI, y un sandbox para el agente sin credenciales de larga duración.

Cuando deps.dev u OSV no responden, el veredicto es unknown y no ok. El .pinright.json inicial hace que en ese caso te pregunte; sin archivo de política, el hook permite el cambio y le avisa al agente que no se pudo verificar.

Inyección de prompts en el texto de los paquetes

pinright pone frente a tu agente texto escrito por los autores de los paquetes. Quita los caracteres ocultos y el markup, descarta los pasajes que le dan órdenes al agente y envuelve cada bloque de terceros en un delimitador <untrusted-data> con un id aleatorio.

El detector compara formulaciones. Con frases de ataque escritas después de congelar sus reglas, detectó de 20% a 40%. Úsalo como alarma; el delimitador depende de que el agente lo respete.

Dos revisiones de seguridad antes de la 1.0.0

Las dos las hicieron sesiones separadas de agentes de IA que no escribieron el código revisado, y el autor comprobó cada hallazgo. Los atacantes modelados: un repositorio que abres, quien publica un paquete, un usuario local en una máquina compartida y, para el hook, el propio agente.

11 hallazgos
Ronda 1, 2026-10-29: 5 altos, 5 medios, 1 bajo, todos arreglados. 759 literales de regex cronometrados con unas 900 entradas.
13 hallazgos
Ronda 2, 2026-11-01, sobre la versión candidata: 1 alto, 9 medios, 3 bajos, todos arreglados. Unos 120 casos de red team sobre el hook.

Los puntos abiertos después de las dos rondas, como el runner de releases autoalojado y los huecos del lector del hook, están en docs/SECURITY-REVIEW.md.

Reportar una vulnerabilidad

Repórtala en privado a través de GitHub, no en un issue público. Incluye la versión (pinright --version), el comando o la llamada a herramienta y lo que esperabas. Buscamos confirmar la recepción en 3 días hábiles y darte el crédito en el aviso, salvo que nos pidas que no.