@uncaughtdev/core

Core engine for Uncaught error monitoring.

Install

npx uncaughtdev init

Or manually:

npm install @uncaughtdev/core

What's included

• Error capture with fingerprinting and deduplication
• Ring buffer breadcrumb store
• PII sanitization
• AI-ready fix prompt generation
• Transport layer (console, local file, remote)
• SQLite storage backend with web dashboard
• Source map resolution for production stack traces
• Node.js process-level error handlers (setupNodeHandlers)
• Express error middleware (expressErrorHandler)
• Fastify error handler plugin (fastifyErrorPlugin)
• Webhook notifications for new error fingerprints
• Release tracking and environment filtering
• User feedback API (submitFeedback)
• MCP server for AI coding assistants (Cursor, Claude Code, Windsurf)
• CLI viewer (npx uncaughtdev)
• Auto-setup command (npx uncaughtdev init)

MCP Server

Exposes error data to AI coding assistants via Model Context Protocol:

# Add to Cursor (~/.cursor/mcp.json):
{ "mcpServers": { "uncaught": { "command": "npx", "args": ["-y", "@uncaughtdev/core", "uncaught-mcp"] } } }

# Add to Claude Code:
claude mcp add uncaught -- npx -y @uncaughtdev/core uncaught-mcp

Tools: setup_uncaught, list_errors, get_error, get_fix_prompt, get_stats, resolve_error, search_errors

Server-Side Usage

import { initUncaught, setupNodeHandlers, expressErrorHandler } from '@uncaughtdev/core';

const client = initUncaught({
  projectKey: 'my-api',
  environment: 'production',
  release: '1.2.0',
});

// Capture uncaughtException and unhandledRejection
setupNodeHandlers(client);

// Express error middleware (register after all routes)
app.use(expressErrorHandler(client));

License

MIT