Performance
flowchart TD
Schedule([Once per hour]) --> Inspect[get_advisors and execute_sql]
Inspect --> Signals["Query regressions, blockers, advisor findings"]
Signals --> Review{Anything new to report?}
Review -->|Yes| Report[Finding and next step]
Review -->|No| Silent[Stay silent]
Inspect -->|Missing data or access| Gap[Report new or changed gaps]What it watches
- Long-running sessions and the PIDs blocking other sessions
- Query execution-time regressions across saved hourly measurements
- Performance Advisor findings at warning and error level
It uses get_advisors and read-only execute_sql on project-scoped Supabase MCP. It does not create indexes, rewrite queries, or cancel sessions.
When it watches
Interactive on supabase.com
This part of the page is a schedule configurator (AgentWatchSchedule), which supabase.com draws live. See it on the original page.
What it will output
This prompt reports new or changed findings with the affected query, session, or object, plus an investigation and verification step. It does not infer a regression without comparable measurements or recommend cancellation based only on query age. See what triggers a performance report.
If a check cannot run, the agent tells you what is missing. Clear checks and unchanged findings stay quiet.
When the agent finds an issue, it reports in the harness. Send that report wherever you already triage work. Use the connections your harness already has. For example, Codex can open a Linear issue.
Keep the Supabase project read-only. Filing a ticket is work in the harness, not a change to the project.
If you want that routing on every scheduled run, add it to the prompt.
Set up the agent
Allow the agent to read the documentation linked in its prompt. Configure your harness to save measurements and alert state, then reload them on each run. Query comparisons need three hourly snapshots; the first runs can still report current blockers and advisor findings.
Interactive on supabase.com
This part of the page is an agent set-up guide (AgentSetup), which supabase.com draws live. See it on the original page.