Estimado Usuario

Tu agente de IA trabaja para ti, pero ¿qué tan bien trabajáis juntos?

Dear User es una herramienta de código abierto que audita tu configuración de Claude Code y te dice exactamente qué corregir. Evalúa tu colaboración, encuentra secretos filtrados y conflictos de configuración, y verifica el estado del sistema; todo localmente, sin subir nada a menos que compartas explícitamente tu tarjeta Wrapped.

claude mcp add --scope user dearuser -- npx -y @poisedhq/dearuser-mcp@latest

Luego pregúntale a Claude: "Analiza mi colaboración con Claude"

Landing: dearuser.ai · Feedback: usa la herramienta feedback en Claude, o abre un issue

Qué hace

Dear User es un servidor MCP (Model Context Protocol, el sistema de plugins que usan Claude Code y Claude Desktop). Una vez instalado, aparece como un conjunto de herramientas que tu agente puede llamar. Sin interfaz gráfica, sin registro, sin cuenta en la nube.

Tres informes locales, una tarjeta Wrapped compartible, un canal de feedback:

Además de ayudantes: onboard (configuración guiada de 7 pasos), history (tendencia sin volver a escanear), help (menú), implement_recommendation, dismiss_recommendation, share_report (subida solo para Wrapped).

Aspectos destacados del lanzamiento

• Wrapped compartible — ejecuta wrapped, luego share_report para obtener una URL dearuser.ai/r/<token> para tu tarjeta de estadísticas. Anonimizado antes de subir (rutas reducidas a nombres base, correos electrónicos eliminados, secretos redactados). Los informes de colaboración/seguridad/salud permanecen locales; los hallazgos pueden contener contexto empresarial que no es seguro compartir automáticamente.

• Escáner de secretos de 12 categorías — OpenAI, Anthropic, GitHub, AWS, Stripe, Slack, Google, Supabase, Vercel, claves privadas, secretos de entorno genéricos, tokens de portador. Escanea CLAUDE.md / AGENTS.md, archivos de memoria, habilidades, hooks.

• Soporte nativo para AGENTS.md — entrada de primera clase junto a CLAUDE.md. Funciona de forma inmediata para Cursor, Codex, Aider, Cline, Zed y cualquiera que siga el estándar multiplataforma de la Linux Foundation. ¿Ambos archivos en el mismo directorio? Los fusionamos.

• Detección de conflictos semánticos (nuevo) — encuentra reglas que se contradicen entre sí incluso cuando no comparten palabras clave. "Confirmar a menudo" vs. "preguntar antes de confirmar" se marca.

• Puntuación calibrada con la realidad — dos estudios: 988 configuraciones públicas de Claude Code con sustrato confirmado (mediana 32/100, máx 63) y 2,895 archivos CLAUDE.md independientes (mediana 18, máx 60). El corpus de sustrato es el punto de referencia comparativo para las puntuaciones en vivo. Consulta research/calibration/ para ambos estudios.

Instalación

Un comando por cliente. Guía completa: docs/install.md.

Claude Code (CLI)

claude mcp add --scope user dearuser -- npx -y @poisedhq/dearuser-mcp@latest

Reinicia Claude Code después para que aparezcan las herramientas.

Claude Desktop — añade a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "dearuser": {
      "command": "npx",
      "args": ["@poisedhq/dearuser-mcp"]
    }
  }
}

Cursor, Windsurf, Cline, Zed — consulta docs/install.md.

Opcional: instala los comandos de barra (consulta Comandos para la lista completa) para que puedas escribir /dearuser-collab en lugar de preguntar en prosa:

npx -p @poisedhq/dearuser-mcp dearuser-install-skills

Tus primeros 5 minutos

Después de instalar, reinicia tu cliente y prueba estos en orden:

1. Escaneo base:

   Run Dear User collab on this project

   Obtendrás una persona (Vibe Coder / Desarrollador Senior / Indie Hacker / Venture Studio / Líder de Equipo), una puntuación de 0-100 en 7 categorías y de 3 a 10 recomendaciones concretas.

2. Barrido de seguridad:

   Run Dear User security

   Revisa tu contrato de agente (CLAUDE.md o AGENTS.md), memoria, habilidades y hooks en busca de tokens filtrados, superficies de inyección y conflictos de reglas.

3. Comparte el resultado (opcional):

   Share my collab report

   Devuelve un enlace dearuser.ai/r/<token>. Anonimizado antes de subir. Tú eliges si pegarlo en algún lugar.

Ejemplo de salida de collab:

Persona: Indie Hacker (87% confidence)
Score:   73 / 100

Top friction:
  • Quality Standards — no test-before-commit rule in CLAUDE.md
  • Memory Health    — 2 memory files haven't been touched in 90+ days
  • Communication    — no language preference stated (English vs Danish mixing)

Recommendations (3 shown, 5 total):
  1. Add a "Session start protocol" block to CLAUDE.md  (apply with: implement_recommendation)
  2. Rotate the OpenAI key leaked in ~/.claude/memory/api-notes.md
  3. Merge overlapping skills: deploy-check and ship-check share 80% of their rules

Comandos

Ocho comandos de barra vienen con Dear User. Pregúntale a tu agente por su nombre, o escribe el comando de barra si los instalaste con dearuser-install-skills.

Tres acciones en el chat que el agente puede llamar por ti: share_report (subir una tarjeta Wrapped a dearuser.ai/r/<token>), implement_recommendation (aplicar una recomendación pendiente), dismiss_recommendation (marcar una como irrelevante).

Privacidad

Dear User prioriza lo local. Tus escaneos permanecen en tu máquina:

• Tu contrato de agente (CLAUDE.md o AGENTS.md), memoria, habilidades, hooks y metadatos de sesión se leen pero nunca se suben

• Los resultados se almacenan en ~/.dearuser/dearuser.db (SQLite, modo WAL)

• El panel de control local opcional lee de esa base de datos; no se transmite nada

• Dear User lee solo metadatos de sesión (conteos, longitudes); nunca el contenido real de tu conversación

• No se requieren claves API, ni registro, ni telemetría

Las únicas excepciones son las cosas que activas explícitamente:

• share_report (solo Wrapped) — tu tarjeta Wrapped se anonimiza (rutas reducidas, correos electrónicos eliminados, cualquier cosa que coincida con nuestros patrones de secretos redactada) y se sube a dearuser.ai para que puedas compartir una URL. Tu base de datos local no se modifica. Puedes establecer un expires_at para que el enlace caduque automáticamente. Los informes de colaboración/seguridad/salud NO son compartibles; los hallazgos pueden contener contexto empresarial (nombres de proyectos, nombres de clientes, notas de arquitectura) que creemos que no deberían vivir en una URL pública.

• feedback — cuando llamas a la herramienta de feedback, tu mensaje va a nuestra bandeja de entrada de Supabase. Ese es el propósito de la herramienta. No adjuntamos tus escaneos ni archivos, solo el texto que escribes.

Ninguna otra herramienta transmite nada. Si share_report no está configurado con DEARUSER_SUPABASE_URL + DEARUSER_SUPABASE_SERVICE_KEY, da un error limpio y el resto de Dear User sigue funcionando.

Detalles completos de privacidad: docs/privacy.md.

Cómo funciona

Your files (CLAUDE.md or AGENTS.md, memory, hooks, skills, sessions)
        │
    Scanner ──► Parser ──► Engines (scoring, secrets, conflicts, health)
        │
 Persona detection → Scoring → Gap analysis → Recommendations
        │
    Feedback loop (tracks which recommendations you implemented)
        │
    ~/.dearuser/dearuser.db  ←  dashboard reads from here

• 5 personas detectadas desde tu configuración; cada una recibe recomendaciones personalizadas

• 7 categorías de puntuación: Claridad de Rol, Comunicación, Equilibrio de Autonomía, Estándares de Calidad, Salud de la Memoria, Madurez del Sistema, Cobertura

• Bucle de feedback: Dear User recuerda lo que recomendó. En la siguiente ejecución, verifica cuáles implementaste y muestra la diferencia de puntuación.

Para quién es

• "Vibe coders" — le das instrucciones a Claude y envías producto, pero nunca estás seguro de si tu configuración realmente funciona. Dear User te lo dice.

• Desarrolladores senior — quieres una auditoría rápida de secretos filtrados, deriva de configuración y conflictos de reglas sin configurar una tubería de linting personalizada.

• Indie hackers / fundadores solitarios — has acumulado hooks, habilidades y memoria en varios proyectos. Dear User saca a la luz lo que está huérfano o se contradice.

• Líderes de equipo — quieres una auditoría local de la configuración de agente compartida de tu equipo. Los informes de colaboración, seguridad y salud permanecen en tu máquina; solo tu tarjeta Wrapped personal puede compartirse públicamente.

Diseño del repositorio

• mcp/ — paquete npm @poisedhq/dearuser-mcp (el servidor MCP). Consulta mcp/README.md para notas de desarrollo.

• web/ — landing de dearuser.ai + páginas de share-report (Astro).

• docs/ — guía de instalación, documento de privacidad, configuración por plataforma (Supabase/GitHub/Vercel para los asesores de plataforma de security opcionales).

• research/ — datos de calibración + notas de arquitectura que estamos dispuestos a compartir.

Contribución

Consulta CONTRIBUTING.md. Los informes de errores y pequeñas correcciones son bienvenidos a través de issues y PRs de GitHub.

Comunidad y soporte

• GitHub Discussions — preguntas, ideas, "cómo hago...", mostrar y contar

• GitHub Issues — errores reproducibles y solicitudes de funciones

• Bandeja de entrada de feedback — notas privadas; o usa la herramienta MCP feedback desde dentro de Claude

Enlaces

• dearuser.ai — página de inicio

• Guía de instalación · Privacidad · Configuración para asesores de plataforma

Licencia

Dear User tiene licencia MIT. Consulta LICENSE.

Compromiso de núcleo abierto: todo en este repositorio es MIT y seguirá siendo MIT. Si alguna vez creamos funciones de equipo o alojadas (paneles de agencia, líneas de tendencia entre proyectos, puntos de referencia específicos de la industria), vivirán en repositorios separados con su propia licencia, nunca extrayendo piezas de este.