# supabase-realtime-optimizer

This subagent reviews Supabase Realtime subscriptions, WebSocket connections, latency, and message flow. Use it when realtime behavior needs diagnosis or tuning.

- subagent · `type=agent` · Claude Code · 1346 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/realtime/supabase-realtime-optimizer.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/agents/supabase-realtime-optimizer

## What it does

The subagent examines Supabase Realtime subscriptions, message size, connection load, and delivery delays. It can investigate unstable WebSocket connections, authentication and RLS checks, subscription filters, and client-side bottlenecks. Its available tools are `Read`, `Edit`, `Bash`, and `Grep`.

Its workflow covers usage analysis, connection-log review, subscription and query changes, retry handling, and metric collection. It can suggest batching, channel multiplexing, fallback polling, state-management changes, and connection-health monitoring. The subagent depends on access to `Read`, `Edit`, `Bash`, and `Grep`, so those tools must be available in Claude Code.

## Requirements
- Works with: Supabase

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --agent realtime/supabase-realtime-optimizer
```

2. **Manually: put the files in place**
- File: `.claude/agents/supabase-realtime-optimizer.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/supabase-realtime-optimizer.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/supabase-realtime-optimizer.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/realtime/supabase-realtime-optimizer.md

## When to use it
- trace unstable WebSocket connections
- reduce unnecessary subscription traffic
- tune retry and reconnect handling
- review subscription filters and RLS checks
- measure latency and connection health

## Example prompts
- Review our Supabase Realtime subscriptions and identify unnecessary data transfer.
- Inspect the WebSocket connection logs, find the failure pattern, and suggest fixes.
- Evaluate the subscription filters and reconnect flow, then edit the affected files.

## Similar
- [fullstack-developer](https://affpapa.org/en/nevibecode/agents/fullstack-developer.md) — subagent · 18117 installs
- [python-pro](https://affpapa.org/en/nevibecode/agents/voltagent-community-python-pro.md) — subagent · 11689 installs
- [python-pro](https://affpapa.org/en/nevibecode/agents/python-pro.md) — subagent · 11689 installs
- [typescript-pro](https://affpapa.org/en/nevibecode/agents/voltagent-community-typescript-pro.md) — subagent · 9602 installs
- [ai-engineer](https://affpapa.org/en/nevibecode/agents/ai-engineer.md) — subagent · 7687 installs
- [code-explorer](https://affpapa.org/en/nevibecode/agents/code-explorer.md) — subagent · 1172 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 495 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md