> **convex-monitor** — skill 23 of 33 in [get-convex/agent-skills](https://skillsdocs.com/get-convex/agent-skills).
>
> Book (all skills, one file): https://skillsdocs.com/get-convex/agent-skills.md
> Machine manifest: https://skillsdocs.com/get-convex/agent-skills/.well-known/agent-skills/index.json
> Install the book: `npx skills add get-convex/agent-skills`
> Upstream: https://github.com/get-convex/agent-skills/blob/main/skills/convex-monitor/SKILL.md @ `main`
> Raw bytes, no header: https://raw.githubusercontent.com/get-convex/agent-skills/main/skills/convex-monitor/SKILL.md
> Base for relative paths: https://raw.githubusercontent.com/get-convex/agent-skills/main/skills/convex-monitor/
> Licence: Apache-2.0 — https://spdx.org/licenses/Apache-2.0.html
>
> Content © its authors, served unmodified. Takedown: https://github.com/DreambaseAI/skillsdocs/issues/new?labels=takedown&title=Takedown+request

<!-- Verbatim upstream SKILL.md follows, YAML frontmatter included. -->

---
name: convex-monitor
description: "Watch for the next dev/prod error or request in a Convex app and react to it."
---

<!-- 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.