Skip to main content
Glama

PocketLantern

npm version npm downloads CI License: MIT

Tu agente de IA suena seguro. Pero pasó por alto los bloqueos.

Los precios cambian, las versiones se rompen, las licencias se modifican. PocketLantern es una capa de decisión consciente de bloqueos para agentes de programación de IA, basada en hechos vinculados a fuentes y sensibles al tiempo.

Prueba estas consultas

Pregúntale a tu agente de IA después de instalar PocketLantern:

"¿Qué proveedor de autenticación elegir: Clerk, Auth0 o Cognito?"

⚠️ Cognito password hashes are permanently non-exportable
⚠️ Auth0 password export requires support ticket — Free tier excluded
⚠️ Auth0 Rules/Hooks EOL 2026-11-18 — Actions not portable
✅ Clerk has the most flexible migration path

"¿Debería actualizar a Next.js 16?"

⚠️ Sync API access fully removed — all dynamic calls must be awaited
⚠️ Custom webpack config breaks next build
⚠️ next lint removed — switch to Biome or ESLint CLI
⚠️ Requires Node.js 20.9.0+, TypeScript 5.1.0+, React 19.0+
✅ Plan phased migration — codemod doesn't cover webpack or middleware

"¿Puedo usar la API de OpenAI Realtime?"

⚠️ gpt-4o-realtime-preview removed 2026-05-07
⚠️ Beta interface (realtime=v1 header) removed same date
⚠️ GA event schema incompatible — 4 event renames
✅ Start on GA from day one — or plan dual-stack migration

Tres preguntas. Tres tipos de bloqueos. La misma IA, diferentes hechos.

Demostración de PocketLantern: bloqueos de actualización de Node.js 20→24 detectados en segundos

Related MCP server: @4da/mcp-server

Inicio rápido

Requisitos previos: Node.js >= 22, un cliente MCP (Claude Code, Cursor, etc.)

npm install -g pocketlantern

Claude Code

En el directorio de tu proyecto:

cd your-project
pocketlantern init

init registra el servidor MCP en ~/.claude.json y añade una regla de una línea al archivo CLAUDE.md de tu proyecto. Reinicia Claude Code (Ctrl+C, luego ejecuta claude de nuevo) y realiza tu primera consulta.

Cursor / Windsurf / otros clientes MCP

Añade esto a tu configuración de MCP (Cursor: ~/.cursor/mcp.json):

{
  "mcpServers": {
    "pocketlantern": {
      "command": "pocketlantern-mcp"
    }
  }
}

Luego añade esta línea a las reglas de tu proyecto (.cursorrules, archivo de configuración de Kiro, etc.):

For technology decisions, upgrades, migrations, or licensing questions: before finalizing your answer, check the PocketLantern MCP server's search_cards tool for blockers in these bundled decision cards — your training data may be stale.

Recarga los servidores MCP: Cursor — Cmd+Shift+P -> "MCP: Restart Servers". Windsurf — reinicia el editor.

Más consultas para probar

  1. "¿Cómo cambió el precio de Vercel con Fluid Compute?" La facturación se divide en CPU activa + Memoria, la concurrencia de procesos compartidos rompe el aislamiento

  2. "¿Prisma o Drizzle para Edge/serverless?" Prisma v7 ESM + adaptador de controlador con cambios disruptivos, solo vista previa en Edge; Drizzle 0.30-1.0 también con cambios disruptivos

Verificar la instalación

pocketlantern doctor               # check installation status
pocketlantern search "auth pricing" # search cards from CLI

Cómo funciona

PocketLantern es un servidor MCP. Tu agente de IA llama a search_cards y obtiene tarjetas de decisión vinculadas a fuentes además de advertencias de bloqueo vinculadas a fuentes cuando están disponibles.

Agent asks question
  -> search_cards("clerk vs auth0 authentication")
  -> 3 cards + 5 blocker warnings (lock-in, EOL, export restrictions)
  -> Agent answers with source-linked constraints

Conjunto de tarjetas local. Búsqueda instantánea. Sin base de datos vectorial. Sin embeddings. Búsqueda por palabras clave, enlaces de tarjetas y advertencias de bloqueo vinculadas a fuentes cuando están disponibles. El valor reside en las tarjetas de decisión vinculadas a fuentes, no solo en una recuperación inteligente.

search_cards("auth", constraints:["serverless"]) -> cards + blockers
get_card("auth/clerk-vs-auth0-vs-cognito-2026")  -> full card with facts
get_related_cards(...)                           -> connected topics

Qué incluye

Tarjetas de decisión conscientes de bloqueos en 27 categorías, además de advertencias de bloqueo vinculadas a fuentes desde el índice de grafos incluido. Se envía con el paquete npm, funciona inmediatamente, sin red, sin cuenta:

Categoría

Qué cubre

auth

Bloqueo de proveedor, problemas de migración, SSO, RBAC, passkeys

frontend

Bloqueos de actualización de Next.js, React, Svelte, Vite, Angular

database

Prisma, Drizzle, Postgres, Aurora, Neon, Supabase

ai

Migraciones de API de OpenAI, precios de modelos, batch vs streaming

serverless

Costos y tiempo de ejecución de Vercel, Cloudflare Workers, Lambda

infra

Plataformas de alojamiento, Terraform, Node.js LTS, Python EOL

backend

Supabase vs Firebase, Express, colas de trabajo, sincronización en tiempo real

+ 18 más

despliegue, herramientas de desarrollo, pruebas, seguridad, cumplimiento, ...

Cómo se ve una tarjeta

Cada tarjeta es un archivo YAML estructurado con hechos vinculados a fuentes y enlaces de referencia oficiales:

id: auth/clerk-vs-auth0-vs-cognito-2026
title: Clerk vs Auth0 vs Cognito Under Current Pricing and Feature Changes
problem: Select an auth vendor given recent pricing shifts, MAU economics, ...
constraints: [cost-sensitive, low-ops, enterprise, compliance, serverless]
candidates:
  - name: Clerk
    summary: "Pro starts at $20/mo, includes 50,000 MRUs per app..."
    when_to_use: "Choose for small-team + low-ops + cost-sensitive SaaS..."
    tradeoffs: "Best DX and fastest implementation..."
    cautions: "Be precise about org-member limits..."
    links:
      - https://clerk.com/pricing
      - https://clerk.com/docs/guides/organizations/configure
  - name: Auth0
    # ...
  - name: Amazon Cognito
    # ...
tags: [auth, clerk, auth0, pricing, passkeys, b2b, compliance]
related_cards: [auth/sso-for-b2b-saas, auth/rbac-vs-abac-vs-rebac]
updated: 2026-03-14

Consulta packages/schema/src/card.ts para ver la definición completa del esquema.

Estructura del proyecto

pocketlantern/
  packages/schema/       <- Card schema (zod + TypeScript types)
  apps/mcp-server/       <- MCP server (search, retrieval, tool handlers)
  apps/cli/              <- CLI (validate, search, init, doctor)
  packages/knowledge/    <- Decision cards + graph index (data package)
  docs/                  <- User guides & roadmap

Monorepo: espacio de trabajo pnpm. Orden de compilación: schema -> knowledge (sin compilación) -> mcp-server -> cli.

Desarrollo

pnpm build              # Build all packages
pnpm test               # Run tests (299 tests)
pnpm test:coverage      # Run with coverage report
pnpm lint               # ESLint
pnpm format:check       # Prettier check

¿Falta algún tema? Solicita cobertura en Card Requests.

Contribución

Las contribuciones a la herramienta (esquema, servidor MCP, CLI, búsqueda) son bienvenidas. Consulta CONTRIBUTING.md para ver las directrices.

Licencia

MIT

Related MCP Connectors

Related MCP Servers