mcpField
C
convex-sentinel

convex-sentinel

github.com/convexCloud & DevOps6936.8k installsUpdated 1d ago
Repository

About convex-sentinel

convex-sentinel is a skill for capturing and triaging production errors in a Convex deployment. It stores redacted error data in that deployment and can optionally route recurring, non-transient issues to ai-runner for a fix PR.

Key features

  1. 01Captures server and client errors
  2. 02Records OCC and scale signals
  3. 03Redacts data before writes
  4. 04Monitors new production errors
  5. 05Optional triage and fix PR handoff

Use cases

  1. 01Reviewing production function failures
  2. 02Tracking client-side crashes
  3. 03Reacting to recurring error patterns

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/convex/agent-skills --skill convex-sentinel

After installing, type/convex-sentinelin Claude Code to confirm it loaded.

Details

From the project README

Capture production errors in your own deployment

Install @convex-dev/sentinel to capture production errors (server function failures, client JS/React crashes, OCC and scale signals) into a table in the user's OWN deployment, redacted at write time, then react to new ones. Data never leaves the user's deployment.

Workflow

  1. Install the component: app.use(sentinel) in convex/convex.config.ts.
  2. Wire the client SDK: a React error boundary plus window.onerror/unhandledrejection and breadcrumbs.
  3. Redaction runs at write time and is on by default (default-deny on secret key names and value patterns).
  4. Read recent errors with the Convex CLI (convex data, run-once-query); react to new ones via the monitor's prod_error event.
  5. Optionally enable the self-healing cron: triage classifies each error and, for recurring non-transient ones, hands it to ai-runner to open a fix PR.

Rules

  • Redaction is mandatory and on by default — never store raw secrets; the agent's reads reach the model provider.
  • Data stays in the user's deployment; never send it to a third party.
  • Sample and cap to control volume and cost.
  • Capturing PROD errors needs a deployed cloud app; install works anonymously.

Comments

Markdown supported