PocketLantern
About
Blocker-aware decision layer for AI coding agents. Adds source-linked, time-sensitive blockers to AI technical choices — breaking changes, EOLs, lock-in, pricing shifts, and migration risk.
Details
- Author
- pocketlantern
- Categories
- Developer Tools, AI, Other
Jump to
Setup
Install PocketLantern in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/pocketlantern/pocketlantern
Follow the installation instructions in the repository README, then restart your MCP client.
Your AI agent sounds confident. It missed the blockers.
Prices shift, versions break, licenses change. PocketLantern is a blocker-aware decision layer for AI coding agents, grounded in source-linked, time-sensitive facts.
Ask your AI agent after installing PocketLantern:
"Which auth provider — Clerk, Auth0, or 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
"Should I upgrade to 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
"Can I use the OpenAI Realtime API?"
⚠️ 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
Three questions. Three blocker types. Same AI, different facts.
Prerequisites: Node.js >= 22, an MCP client (Claude Code,Cursor, etc.)
initregisters the MCP server in~/.claude.jsonand adds a one-line rule to your project'sCLAUDE.md. Restart Claude Code (Ctrl+C, then runclaudeagain), then ask your first query.
Add to your MCP config (Cursor:~/.cursor/mcp.json):
{ "mcpServers": { "pocketlantern": { "command": "pocketlantern-mcp" } } }
Then add this line to your project rules (.cursorrules, Kiro steering file, 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.
Reload MCP servers: Cursor —Cmd+Shift+P-> "MCP: Restart Servers". Windsurf — restart the editor.
-
"How did Vercel pricing change with Fluid Compute?"Billing split to Active CPU + Memory, shared-process concurrency breaks isolation
"Prisma or Drizzle for Edge/serverless?"Prisma v7 ESM + driver adapter breaking, Edge preview-only; Drizzle 0.30-1.0 also breaking
pocketlantern doctor # check installation status pocketlantern search "auth pricing" # search cards from CLI
PocketLantern is an MCP server. Your AI agent callssearch_cards— and gets source-linked decision cardsplus source-linked blocker warningswhere available.
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
Local cardset. Instant lookup. No vector database. No embeddings. Keyword search, card links, and source-linked blocker warnings where available. The value is insource-linked decision cards, not clever retrieval alone.
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
Blocker-aware decision cards across 27 categories — plus source-linked blocker warnings from the bundled graph index. Ships with the npm package, works immediately, no network, no account:
Each card is a structured YAML file with source-linked facts and official reference links:
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
Seepackages/schema/src/card.tsfor the full schema definition.
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 order:schema -> knowledge (no build) -> mcp-server -> cli.
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
Missing a topic? Request coverage inCard Requests.
Contributions to the tool (schema, MCP server, CLI, search) are welcome. SeeCONTRIBUTING.mdfor guidelines.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
A multi-agent AI-powered research and code assistant. Requires external API keys for LLM providers, web search, and secure code execution.
An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .
Instead of direct calling MCP tools, mcpcode server transforms MCP tool calls into TypeScript programs, enabling smarter, lower-latency orchestration by LLMs.
Search and evaluate MCP servers from your AI agent: quality grades, live verification status, install commands and client compatibility for 5,000+ servers.
Supercharge your Agent with Semantic Code Intelligence and save 💰 in the process!
AI-to-AI code review platform — Claude, Codex, and Gemini cross-check each other via MCP, REST API, and CLI for consensus-based results.
A code sandbox for AI assistants to safely execute arbitrary code. Requires a 302AI API key for authentication.
Agent-native developer Q&A API with MCP + A2A endpoints for citations, job pickup, and answer submission.
MCP server to dynamically load Claude Code skills into AI agents
MCP bridge that lets Claude Code delegate heavy tasks to the Antigravity CLI (agy) — purpose-built tools, model routing with fallback, session continuity, and output truncation to save Claude's context and tokens.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





