convex-insights
Query a running Convex app's logs + health in natural language
by get-convexFree
Description
convex-insights is an agent skill that lets you ask questions about a running Convex app in plain language and get answers backed by its logs and health data. It wraps the read tools of the official Convex MCP, namely logs, insights, functionSpec and status, and turns operational questions into narrow queries that return evidence. Questions can cover failures, slow or expensive functions, and whether a deploy caused a change in behaviour. The skill follows a few rules. It first identifies and announces which deployment is being read, using the deploy guard. It discovers the real function names before querying, so it does not guess identifiers. It notes the tool's limits up front, for example that the logs command takes a count of entries rather than a time window, and it keeps the output short. Every answer comes with a link to the dashboard, so a person can check it with one click. Reading logs and insights is read-only, and the skill says never to turn on production mutation flags for an insights pass. It is part of the get-convex agent-skills repository and is added to a compatible agent with the skills command. It suits developers who want quick answers about what their app did without opening the dashboard for each question.…
Highlights
- Answers questions about logs and health in plain language
- Discovers function names before querying
- Read-only, with the deployment announced first
- Dashboard link on every answer
Ratings & Reviews
No ratings yet
Be the first to rate convex-insights.
People also visit
convex-insights FAQ
What does convex-insights do?
It answers questions about a running Convex app's logs and health, such as failures, slow functions and deploy effects.
Can it change the production app?
No. Reading logs and insights is read-only, and the skill says not to enable production mutation flags for an insights pass.
Does it guess function names?
No. It uses functionSpec to discover the real names before it queries.
How are answers shown?
With the evidence and a dashboard link so you can verify them.
How do I install it?
Run: npx skills add https://github.com/get-convex/agent-skills --skill convex-insights
What are the best convex-insights alternatives?
Popular alternatives to convex-insights include dashboard-builder, convex-advisor and convex-optimize. See all convex-insights alternatives