AutoGineer
Generated banner for Convex Sentinel
Generated logo for Convex Sentinel

Convex Sentinel

ConvexOfficialPublished by Convex

  • Skill
  • Workflow
  • Software development
  • Apache-2.0
  • No issues found
Download ZIP

From the author

Set up Sentinel production error capture in your own Convex deployment.
— the description by Convex

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

Convex-sentinel provides a workflow for capturing production errors directly within a user's Convex deployment. By installing the component, developers can monitor server function failures, client-side crashes, and scaling signals while ensuring data privacy through built-in, mandatory redaction. The system allows for manual error inspection via CLI and includes an optional self-healing cron job that can automatically triage recurring errors and initiate fix pull requests.

What it does

  • Captures server function failures and client-side JavaScript crashes.
  • Redacts sensitive information at write time to prevent secret leakage.
  • Stores all error data locally within the user's own deployment.
  • Provides tools to read and monitor error logs via CLI.
  • Automates error triage and fix PR generation using AI runners.

When to use it

  • When you need to monitor production errors without sending data to third-party services.
  • When you want to implement automated error triage and self-healing workflows.
  • When you need to capture client-side and server-side errors in a unified Convex table.

Advantages

  • Ensures data privacy by keeping all error logs within your own infrastructure.
  • Reduces manual debugging effort through automated triage and PR generation.
  • Includes default-deny redaction to protect sensitive data automatically.

Usage examples

“Set up error tracking for my production Convex app.”
The agent guides you through installing the sentinel component in your config file and wiring the client SDK to capture errors.
“How can I automate fixing recurring production errors?”
The agent explains how to enable the self-healing cron job to classify errors and trigger fix PRs via the ai-runner.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/convex/convex-sentinel/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip convex-sentinel.zip -d .agents/skills

Documentation by Convex

<!-- GENERATED from convex-agents content/capabilities/sentinel.json — do not edit by hand. -->

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.

Files

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Convex
Publisher
Convex (Official)
Source
convex/agent-skills · skills/convex-sentinel · commit f60629d
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Convex or Convex.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download convex-sentinel.zip