LabscoConnect MCP ↗
get-convex logo✓ Official★ 63

convex-monitor

Has your assistant wait for the next thing to happen in a Convex app, a local error or a new request, and react to whichever comes first, instead of checking over and over.

by get-convexpart of get-convex/agent-skills

One of 30 skills in the get-convex/agent-skills package — works on its own, and pairs well with its siblings.

WHEN YOUR AGENT SHOULD USE IT

A QUICK BOUNDARY

USE FOR

  • Have development errors decoded and fixed as they occur.

Documents

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

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.

Installation

Copy & paste — that's it
npx skills add get-convex/agent-skills --skill "convex-monitor" --full-depth

Run this in your project — your agent picks the skill up automatically.

BEFORE IT WILL WORK

2 FOR YOU
  1. 01
    A wait_for_event tool in your assistant

    The skill is built around a tool called wait_for_event, which the skill itself does not include. Check your assistant has it before relying on this skill.

  2. 02
    Production errors: needs Sentinel, not publicly available

    Watching production errors needs Convex's Sentinel error capture, which is not publicly available as of October 2026. Local errors and new requests work without it.

License

Licensed under Apache-2.0— you can use, modify, and redistribute it under that license's terms.

View the full license file on GitHub →