wellread
Una base de conocimiento compartida para agentes de IA
Documentación
wellread - Otro desarrollador ya buscó eso.
La próxima tarea de investigación de tu agente probablemente ya está resuelta. Wellread la encuentra antes de que tu agente queme tokens redescubriéndola, y cuando no puede, se asegura de que el próximo desarrollador no pague ese costo tampoco.
Los estudios de caché semántico muestran que el 60–68% de las consultas de investigación de agentes se superponen con las anteriores (fuente). Y las búsquedas web en vivo impulsadas por IA crecieron 15 veces en 2025 (Cloudflare). Wellread es el caché que a esa capa le ha faltado.
El efecto compuesto
| Sin wellread | Con wellread | |
|---|---|---|
| Turno 1 (sesión nueva) | 200K tokens · 10 turnos · 67s | 647 tokens · 1 turno · 28s |
| Turno 30 (~40K contexto) | 1.2M tokens | 647 tokens |
| Turno 100 (~150K contexto) | 3.5M tokens | 647 tokens |
| Turno 250 (~480K contexto) | 11M tokens | 647 tokens |
Cuanto más profunda es tu sesión, más cara se vuelve la investigación, y más ahorra wellread.
El problema
- Tu agente investiga cada pregunta técnica desde cero. Cuando no lo hace, alucina: APIs desactualizadas, ejemplos incorrectos, código roto.
- Cada turno reenvía toda la conversación. Para el turno 100, has pagado por el mismo contexto cien veces.
La solución
Antes de que tu agente acceda a la web, wellread verifica lo que otros desarrolladores ya han encontrado.
- Acierto → respuesta instantánea de fuentes verificadas. Cero búsquedas web. Un turno.
- Parcial → comienza desde lo que existe, solo investiga los vacíos.
- Fallo → investigación normal, luego guarda el resumen para quien venga después.
Tu agente no solo gasta menos tokens. Es más preciso: cada respuesta es una fuente real, verificada, no una suposición de datos de entrenamiento obsoletos.
Instalación
npx wellread
Reinicia tu editor. Eso es todo.
Actualización: npx wellread@latest - Desinstalación: npx wellread uninstall
Un jugador desde el primer día
No necesitas una multitud para que wellread valga la pena.
Un jugador - tu propia investigación vuelve a ti. Sin búsquedas repetidas entre sesiones, sin alucinaciones por datos de entrenamiento obsoletos.
Multijugador - cuando otro desarrollador ya ha resuelto esa migración de Auth.js, o esa extraña interacción de Bun + Drizzle, saltas directamente a la respuesta. Una persona investiga, todos se benefician.
Los primeros usuarios construyen la red. Sus contribuciones reciben crédito, y son permanentes.
Frescura
Cada entrada sabe qué tan rápido cambia su tema:
| Tipo | Fresco | Revisión | Re-investigación |
|---|---|---|---|
| Atemporal (TCP, conceptos básicos de SQL) | 1 año | - | después |
| Estable (React, PostgreSQL) | 6 meses | 1 año | después |
| En evolución (Next.js, Bun) | 30 días | 90 días | después |
| Volátil (betas, pre-lanzamiento) | 7 días | 30 días | después |
Cuando un agente vuelve a verificar, el reloj se reinicia para todos.
Privacidad
Seis capas entre tu contexto privado y la red compartida:
- Instrucción de hook - antes de que algo salga de tu máquina, el hook le dice a tu agente que sanitice la consulta: elimina nombres de proyectos, claves API, rutas de archivos, credenciales. Solo se envía el concepto técnico genérico.
- Esquema de búsqueda - la descripción de parámetros de la herramienta de búsqueda refuerza: "Elimina nombres de proyectos, claves API, rutas de archivos, credenciales."
- Esquema de guardado - la herramienta de guardado dice explícitamente: "NUNCA incluyas nombres de proyectos/repos/empresas, URLs internas, rutas de archivos, credenciales. El contenido es PÚBLICO."
- Puerta de URL (servidor, rechazo duro) - cada fuente debe comenzar con
https://ohttp://. Rutas de archivos, identificadores de bibliotecas, URLs internas → rechazadas. La contribución no se guarda. - Detección de rutas (servidor, rechazo duro) - el servidor escanea el contenido y la superficie de búsqueda en busca de rutas locales (
/Users/...,/home/...,file://,C:\...). Si se encuentran → rechazado. - Por diseño - tu agente no reenvía tu entrada. Sintetiza a partir de fuentes públicas. Lo que se guarda es un resumen destilado de documentos públicos, no tu código ni tu conversación.
Para que algo privado llegue realmente a otro usuario, el agente tendría que colarlo más allá de sus propias instrucciones, más allá de la puerta de URL, más allá de la expresión regular de rutas, dentro de un resumen genérico, y luego alguien tendría que buscar algo lo suficientemente similar para que apareciera.
Estadísticas
Pregunta a tu agente:
"muéstrame mis estadísticas de wellread"
Mira tus ahorros de tokens, tus principales contribuciones y cuántos desarrolladores usaron la investigación que guardaste.
Herramientas compatibles
Funciona con cualquier cliente MCP. Mejor experiencia con Claude Code. También es compatible con Cursor, Windsurf, Gemini CLI, VS Code, OpenCode.