Skip to main content
Glama

PocketLantern

npm version npm downloads CI License: MIT

Dein KI-Agent klingt überzeugt. Er hat die Blocker übersehen.

Preise ändern sich, Versionen brechen, Lizenzen werden angepasst. PocketLantern ist eine blocker-bewusste Entscheidungsebene für KI-Coding-Agenten, die auf quellverknüpften, zeitkritischen Fakten basiert.

Probiere diese Abfragen aus

Frage deinen KI-Agenten nach der Installation von PocketLantern:

"Welcher Auth-Anbieter – Clerk, Auth0 oder 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

"Sollte ich auf Next.js 16 aktualisieren?"

⚠️ 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

"Kann ich die OpenAI Realtime API verwenden?"

⚠️ 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

Drei Fragen. Drei Blocker-Typen. Dieselbe KI, andere Fakten.

PocketLantern Demo — Node.js 20→24 Upgrade-Blocker in Sekunden erkannt

Related MCP server: @4da/mcp-server

Schnellstart

Voraussetzungen: Node.js >= 22, ein MCP-Client (Claude Code, Cursor, etc.)

npm install -g pocketlantern

Claude Code

In deinem Projektverzeichnis:

cd your-project
pocketlantern init

init registriert den MCP-Server in ~/.claude.json und fügt eine einzeilige Regel zur CLAUDE.md deines Projekts hinzu. Starte Claude Code neu (Strg+C, dann claude erneut ausführen) und stelle dann deine erste Abfrage.

Cursor / Windsurf / andere MCP-Clients

Füge dies zu deiner MCP-Konfiguration hinzu (Cursor: ~/.cursor/mcp.json):

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

Füge dann diese Zeile zu deinen Projektregeln hinzu (.cursorrules, Kiro-Steuerungsdatei, 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.

Lade die MCP-Server neu: Cursor — Cmd+Shift+P -> "MCP: Restart Servers". Windsurf — starte den Editor neu.

Weitere Abfragen zum Ausprobieren

  1. "Wie hat sich die Vercel-Preisgestaltung mit Fluid Compute geändert?" Abrechnungsaufteilung in Active CPU + Memory, Shared-Process-Concurrency bricht die Isolation

  2. "Prisma oder Drizzle für Edge/Serverless?" Prisma v7 ESM + Treiber-Adapter brechend, Edge nur als Vorschau; Drizzle 0.30-1.0 ebenfalls brechend

Installation überprüfen

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

Funktionsweise

PocketLantern ist ein MCP-Server. Dein KI-Agent ruft search_cards auf – und erhält quellverknüpfte Entscheidungskarten sowie quellverknüpfte Blocker-Warnungen, sofern verfügbar.

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

Lokales Kartenset. Sofortige Suche. Keine Vektordatenbank. Keine Embeddings. Stichwortsuche, Kartenlinks und quellverknüpfte Blocker-Warnungen, wo verfügbar. Der Wert liegt in quellverknüpften Entscheidungskarten, nicht allein in cleverem Retrieval.

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

Was ist enthalten

Blocker-bewusste Entscheidungskarten in 27 Kategorien – plus quellverknüpfte Blocker-Warnungen aus dem gebündelten Graph-Index. Wird mit dem npm-Paket geliefert, funktioniert sofort, kein Netzwerk, kein Konto erforderlich:

Kategorie

Was es abdeckt

auth

Vendor Lock-in, Migrationsaufwand, SSO, RBAC, Passkeys

frontend

Next.js, React, Svelte, Vite, Angular Upgrade-Blocker

database

Prisma, Drizzle, Postgres, Aurora, Neon, Supabase

ai

OpenAI API-Migrationen, Modellpreise, Batch vs. Streaming

serverless

Vercel, Cloudflare Workers, Lambda-Kosten und Laufzeit

infra

Hosting-Plattformen, Terraform, Node.js LTS, Python EOL

backend

Supabase vs. Firebase, Express, Job-Queues, Realtime-Sync

+ 18 weitere

Deployment, Devtools, Testing, Sicherheit, Compliance, ...

Wie eine Karte aussieht

Jede Karte ist eine strukturierte YAML-Datei mit quellverknüpften Fakten und offiziellen Referenzlinks:

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

Siehe packages/schema/src/card.ts für die vollständige Schemadefinition.

Projektstruktur

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: pnpm Workspace. Build-Reihenfolge: schema -> knowledge (kein Build) -> mcp-server -> cli.

Entwicklung

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

Fehlt ein Thema? Fordere die Abdeckung in den Card Requests an.

Mitwirken

Beiträge zum Tool (Schema, MCP-Server, CLI, Suche) sind willkommen. Siehe CONTRIBUTING.md für Richtlinien.

Lizenz

MIT

Related MCP Connectors

Related MCP Servers