AutoGineer
Generated banner for Convex Monitor
Generated logo for Convex Monitor

Convex Monitor

ConvexOfficialPublished by Convex

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

From the author

Watch for the next dev/prod error or request in a Convex app and react to it.
— the description by Convex

AutoGineer summary

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

The convex-monitor skill provides a structured approach to observing and responding to events within a Convex application. It is designed to detect errors or feature requests by monitoring local logs, deployment subscriptions, and production error data. The skill utilizes a blocking mechanism to wait for events, falling back to a polling loop when necessary, ensuring consistent event handling across different environments.

What it does

  • Monitors for development and production errors or feature requests.
  • Uses a blocking wait mechanism to detect events without constant polling.
  • Supports a fallback polling loop for environments where blocking is not supported.
  • Standardizes event handling through a fixed and versioned event schema.
  • Facilitates triage and remediation workflows for identified errors.

When to use it

  • When you need to automate responses to errors in your Convex development or production environment.
  • When you want to integrate feature request tracking directly into your development workflow.
  • When working with Sentinel to triage production errors.
  • When you require a consistent event contract across different deployment environments.

Advantages

  • Reduces manual monitoring by automating event detection.
  • Provides a unified interface for handling both local and production-level issues.
  • Ensures consistent behavior regardless of the underlying monitoring mechanism.
  • Simplifies the triage and fix process for application errors.

Usage examples

“Monitor my project for the next error.”
The agent initiates a wait_for_event call to listen for the next convex_error or prod_error event, allowing it to trigger a fix or triage process once an event occurs.
“Check for new feature requests in the app.”
The agent uses the monitor to watch for feature_request events, enabling it to notify the team or begin planning the implementation.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/convex/convex-monitor/download

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

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

Documentation by Convex

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

Watch for the next thing to react to

Block on the next typed event instead of polling. Races local error logs, deployment subscriptions, and Sentinel prod-error rows; returns the first to fire (or a quiet heartbeat).

Workflow

  1. Call wait_for_event with {project_dir, event_kinds, timeout_ms}.

  2. On kind=convex_error/next_error: decode and fix it. On kind=prod_error: triage (see sentinel) and fix. On kind=feature_request: build it. On kind=quiet: loop.

  3. Where a harness has no blocking MCP (e.g. Copilot cloud), the pack runs a poll loop with the SAME event contract — same behavior, different mechanism.

Rules

  • Prefer the blocking tool; fall back to a poll loop only where blocking MCP is weak.

  • The event schema is fixed and versioned — the same trigger yields the same typed event.

  • Prod events (kind=prod_error) require a deployed cloud app plus Sentinel.

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-monitor · 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.

Download ZIP

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