Skip to content

novanoticia/email-triage

v3.28.5Apache-2.0

Epistemic email triage with 30 Bayesian rationality criteria (LessWrong Sequences). Multi-axis scoring, 4-tier routing with color indicators (🔴🟡🔵⚪) and explanations, prompt-injection defense, dry-run and undo, and a calibration feedback loop. Works with Mail.app on macOS (iCloud, via AppleScript) or a Gmail connector. Includes routine mode for scheduled runs and an opt-in low-token fast mode.

Email Triage

Icono de Email Triage

Email Triage ayuda a clasificar correo electrónico con 30 criterios de racionalidad bayesiana. Evalúa el valor decisional, la calidad epistémica, el riesgo de manipulación, el coste cognitivo y la presión de acción, y propone cuatro destinos: REPLY_NEEDED, REVIEW, READING_LATER y ARCHIVE.

Qué hace

  • Lee metadatos y, cuando hace falta, cuerpos de mensajes mediante las capacidades de correo que ya tenga configuradas el cliente: Mail.app en macOS, un conector de Gmail u otro proveedor compatible.
  • Sanitiza el contenido antes de analizarlo para reducir el riesgo de inyección de instrucciones desde un correo.
  • Calcula puntuaciones reproducibles con scripts locales de Python y explica cada clasificación.
  • Puede mover mensajes solo cuando el usuario lo autoriza; el modo simulación no mueve mensajes.
  • Puede guardar, de forma local y configurable, registros de sesión, puntuaciones, explicaciones y correcciones para calibrar decisiones futuras.

Datos que utiliza y dónde van

El plugin puede acceder al remitente, asunto, fecha, identificador y contenido de los correos necesarios para realizar el triaje. También puede usar las carpetas de origen y destino y las correcciones que aporte el usuario.

El plugin no incluye un servidor remoto, no incorpora analítica remota y no envía telemetría a su autor. Sus scripts deterministas procesan los datos localmente; para realizar el juicio epistémico, el modelo del cliente recibe los metadatos y el texto del correo después de la sanitización, como parte de la conversación del usuario. Ese procesamiento queda sujeto a los términos y controles de datos del plan y conexión con los que se ejecute el plugin. Los registros opcionales se guardan en el equipo del usuario, bajo ~/.email-triage/ (o en EMAIL_TRIAGE_HOME cuando se configura), y pueden contener metadatos, puntuaciones, explicaciones, destinos y correcciones. Los cuerpos crudos temporales se eliminan después de su lectura.

Si el usuario elige Mail.app, el acceso y los movimientos ocurren mediante AppleScript en su Mac. Si elige Gmail u otro conector externo, los datos necesarios pasan por ese conector y quedan sujetos a la política de privacidad del proveedor que el usuario haya configurado. El plugin no empaqueta ni selecciona ese servicio: su archivo .mcp.json no declara servidores.

Política de privacidad completa: Privacy.

Requisitos

  • macOS para la integración con Mail.app mediante AppleScript, o un conector de correo compatible configurado por el usuario.
  • Python 3.9 o posterior para los scripts deterministas. El núcleo usa la biblioteca estándar; PyYAML es opcional para validar la configuración.

El plugin no usa lanzadores npx ni uvx y no instala paquetes al ejecutarse.

Seguridad y control

Modelos nativos opcionales

Por defecto se conserva el modelo actual. La capa personal config-modelos.yaml permite comparar (simulación sin movimientos) e hibrido (delegación de criterios con validación local y revisión del principal). La plantilla vive en skills/email-triage/; cópiala al directorio de estado solo si deseas activarla. También puedes pedir la comparación para una sola sesión.

Solo se usan capacidades nativas verificadas del mismo proveedor y conexión. Claude Code incluye un agente evaluador-criterios sin herramientas; la selección de modelo depende del host. Otros clientes aplican el mismo contrato cuando lo permiten. Sin capacidades suficientes se conserva el principal. Esta capa nativa no requiere APIs ni claves nuevas.

Jev opcional

Proveedor externo desactivado por defecto. comparar no mueve correos; hibrido explícito integra veredictos revisados en el triaje real, manteniendo las autorizaciones de movimiento existentes. Requiere consentimiento para enviar extractos sanitizados y perfil mínimo a TypeSafe y TYPESAFE_API_KEY propia; genera consumo adicional. Conserva el principal y el scoring existente ante errores o incertidumbre. Activación, privacidad, costes y pruebas.

OpenAI Decisions opcional

Segundo proveedor externo con las mismas garantías que Jev: desactivado por defecto, comparar sin movimientos e hibrido solo explícito. Requiere consentimiento para enviar extractos sanitizados y perfil mínimo a OpenAI y OPENAI_API_KEY propia (distinta de la de Jev); genera consumo adicional. No se combina con Jev ni con la delegación nativa en la misma sesión. Activación, privacidad, costes y pruebas · Cómo guardar las claves de API en el Mac.

El cliente puede crear contexto adicional de subagente bajo sus condiciones actuales de privacidad; el plugin no modifica esos controles. No se ha medido ahorro ni probado esta opción en una plataforma real.

Movimientos

El contenido del correo se trata como datos, nunca como instrucciones. Los message IDs se escapan antes de interpolarlos en AppleScript, los movimientos se construyen mediante el pipeline seguro del plugin y cada sesión puede verificarse contra su registro. Antes de usarlo sobre una bandeja real, se recomienda empezar con «simula el triaje».

Licencia y código fuente

Apache-2.0. Código fuente, documentación completa e incidencias: novanoticia/email-triage-plugin.

Autor: Pablo Rodríguez López. Esta versión se preparó con asistencia de ChatGPT (OpenAI); el historial completo de contribuciones está documentado en el repositorio de código fuente.

El icono del plugin ha sido creado con ChatGPT (OpenAI).