convex-sentinel

Capture production errors into a Convex deployment with write-time redaction.

9.4k|1.5k|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/openclaw/clawhub --skill convex-sentinel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-sentinel
Source: https://github.com/openclaw/clawhub/tree/main/.agents/skills/convex-sentinel
Command: npx skills add https://github.com/openclaw/clawhub --skill convex-sentinel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @convex-dev/sentinel.

What problem does it solve?

Production errors in Convex apps—server function failures, client JS/React crashes, OCC and scale signals—are hard to observe without sending data to third-party monitoring services. This Skill sets up Sentinel so errors are captured into a table in your own deployment, redacted at write time.

Core Features & Use Cases

  • Self-hosted error capture: Install @convex-dev/sentinel via app.use(sentinel) in convex/convex.config.ts so error data never leaves your own deployment.
  • Client SDK wiring: Add a React error boundary plus window.onerror/unhandledrejection handlers and breadcrumbs to capture client-side crashes.
  • Default-on redaction: Secret key names and value patterns are redacted at write time with a default-deny policy, so raw secrets are never stored.
  • Use Case: After deploying a Convex app to production, read recent errors with the Convex CLI (convex data, run-once-query), react to new ones via the monitor's prod_error event, and optionally enable a self-healing cron that triages recurring errors and hands them to ai-runner to open a fix PR.

Quick Start

Set up Sentinel error capture in my Convex deployment by installing the component, wiring the React client SDK, and showing me how to query recent production errors.

Frequently Asked Questions about convex-sentinel

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I capture production errors in a Convex app?

Install the @convex-dev/sentinel component with app.use(sentinel) in convex/convex.config.ts, then wire the client SDK with a React error boundary and window.onerror handlers. Errors are stored in a table in your own deployment and readable via the Convex CLI.

How to monitor React client crashes in Convex?

Wire the Sentinel client SDK by adding a React error boundary plus window.onerror and unhandledrejection listeners with breadcrumbs. Client crashes are captured into the same deployment table as server function failures.

Does Sentinel send error data to a third-party service?

No, all captured error data stays in your own Convex deployment and is never sent externally. Redaction runs at write time with default-deny rules on secret key names and value patterns.

Can Sentinel automatically fix recurring production errors?

Yes, an optional self-healing cron classifies each error via triage and, for recurring non-transient ones, hands it to ai-runner to open a fix PR. This is opt-in and disabled by default.

What are the limitations of capturing production errors with Sentinel?

Capturing production errors requires a deployed cloud app, though installation works anonymously. You should also sample and cap event volume to control storage and cost.