wellread
Uma base de conhecimento compartilhada para agentes de IA
Documentação
wellread — Outro dev já pesquisou isso.
A próxima tarefa de pesquisa do seu agente provavelmente já foi resolvida. O wellread encontra antes do seu agente queimar tokens redescobrindo — e quando não encontra, garante que o próximo dev não pague esse custo também.
Estudos de cache semântico mostram que 60–68% das consultas de pesquisa de agentes se sobrepõem a consultas anteriores (fonte). E buscas web ao vivo impulsionadas por IA cresceram 15x em 2025 (Cloudflare). O wellread é o cache que essa camada estava precisando.
O efeito composto
| Sem wellread | Com wellread | |
|---|---|---|
| Turno 1 (sessão nova) | 200K tokens · 10 turnos · 67s | 647 tokens · 1 turno · 28s |
| Turno 30 (~40K de contexto) | 1.2M tokens | 647 tokens |
| Turno 100 (~150K de contexto) | 3.5M tokens | 647 tokens |
| Turno 250 (~480K de contexto) | 11M tokens | 647 tokens |
Quanto mais profunda a sua sessão, mais cara fica a pesquisa — e mais o wellread economiza.
O problema
- Seu agente pesquisa toda questão técnica do zero. Quando não pesquisa, ele alucina — APIs desatualizadas, exemplos errados, código quebrado.
- Cada turno reenvia a conversa inteira. No turno 100, você já pagou pelo mesmo contexto cem vezes.
A solução
Antes do seu agente acessar a web, o wellread verifica o que outros devs já encontraram.
- Acerto → resposta instantânea de fontes verificadas. Zero buscas web. Um turno.
- Parcial → começa do que já existe, pesquisa apenas as lacunas.
- Erro → pesquisa normal e salva o resumo para quem vier depois.
Seu agente não gasta apenas menos tokens. Ele é mais preciso — toda resposta é uma fonte real, verificada, não um palpite de dados de treinamento desatualizados.
Instalação
npx wellread
Reinicie seu editor. Só isso.
Atualização: npx wellread@latest — Desinstalação: npx wellread uninstall
Singleplayer desde o primeiro dia
Você não precisa de uma multidão para o wellread valer a pena.
Singleplayer — sua própria pesquisa volta para você. Sem buscas repetidas entre sessões, sem alucinações de dados de treinamento desatualizados.
Multiplayer — quando outro dev já resolveu aquela migração de Auth.js, ou aquela interação estranha de Bun + Drizzle, você pula direto para a resposta. Uma pessoa pesquisa, todos se beneficiam.
Os primeiros usuários constroem a rede. Suas contribuições são creditadas — e permanentes.
Atualização
Cada entrada sabe o quão rápido seu tópico muda:
| Tipo | Fresco | Re-verificação | Re-pesquisa |
|---|---|---|---|
| Atemporal (TCP, fundamentos de SQL) | 1 ano | - | depois |
| Estável (React, PostgreSQL) | 6 meses | 1 ano | depois |
| Em evolução (Next.js, Bun) | 30 dias | 90 dias | depois |
| Volátil (betas, pré-lançamentos) | 7 dias | 30 dias | depois |
Quando um agente re-verifica, o relógio reinicia para todos.
Privacidade
Seis camadas entre seu contexto privado e a rede compartilhada:
- Instrução do hook — antes de qualquer coisa sair da sua máquina, o hook diz ao seu agente para sanitizar a consulta: remover nomes de projetos, chaves de API, caminhos de arquivos, credenciais. Apenas o conceito técnico genérico é enviado.
- Esquema de busca — a descrição do parâmetro da ferramenta de busca reforça: "Remova nomes de projetos, chaves de API, caminhos de arquivos, credenciais."
- Esquema de salvamento — a ferramenta de salvamento diz explicitamente: "NUNCA inclua nomes de projetos/repositórios/empresas, URLs internas, caminhos de arquivos, credenciais, lógica de negócios. O conteúdo é PÚBLICO."
- Portão de URL (servidor, rejeição rígida) — toda fonte deve começar com
https://ouhttp://. Caminhos de arquivos, identificadores de bibliotecas, URLs internas → rejeitados. A contribuição não é salva. - Detecção de caminhos (servidor, rejeição rígida) — o servidor verifica o conteúdo e a superfície de busca por caminhos locais (
/Users/...,/home/...,file://,C:\...). Se encontrado → rejeitado. - Por design — seu agente não encaminha sua entrada. Ele sintetiza a partir de fontes públicas. O que é salvo é um resumo destilado de documentações públicas, não seu código ou conversa.
Para algo privado realmente chegar a outro usuário, o agente teria que burlar suas próprias instruções, o portão de URL, o regex de caminhos, e transformar tudo em um resumo genérico — e então alguém precisaria buscar algo parecido o suficiente para encontrá-lo.
Estatísticas
Pergunte ao seu agente:
"mostre minhas estatísticas do wellread"
Veja sua economia de tokens, suas principais contribuições e quantos devs usaram pesquisas que você salvou.
Ferramentas suportadas
Funciona com qualquer cliente MCP. Melhor experiência com Claude Code. Também suporta Cursor, Windsurf, Gemini CLI, VS Code, OpenCode.