maintenance

Toggle MAINTENANCE_MODE on Supabase login edge functions via CLI.

412|67|Updated Aug 12, 2025
One-click install
npx skills add https://github.com/pipecat-ai/gradient-bang --skill maintenance-pipecat-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maintenance
Source: https://github.com/pipecat-ai/gradient-bang/tree/main/.claude/skills/maintenance
Command: npx skills add https://github.com/pipecat-ai/gradient-bang --skill maintenance-pipecat-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The server-side login killswitch toggles access to a Supabase environment to prevent new user sign-ins during maintenance windows, while preserving existing sessions.

Core Features & Use Cases

  • Toggle MAINTENANCE_MODE on or off for a given environment (dev or prod) to control new logins.
  • Read environment configuration, derive the project ref, and apply secret changes via the Supabase CLI.
  • Use in incident response or downtime windows to gracefully disable new sign-ins without redeploying clients.

Quick Start

Run /maintenance <env> <on|off> to toggle the login maintenance mode for the selected environment.

Frequently Asked Questions about maintenance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I block new Supabase logins during maintenance without redeploying my client app?▼

To block new Supabase logins during maintenance, you can toggle a server-side MAINTENANCE_MODE killswitch on your login edge function. This prevents new user sign-ins while preserving existing active sessions, all without requiring a client redeployment.

How do I toggle the login killswitch for a specific Supabase environment?▼

You can toggle the login killswitch for a specific Supabase environment by running a single command that takes the environment name and on/off status. The tool reads your environment configuration, derives the project ref, and applies the secret changes via the Supabase CLI.

Can I enable maintenance mode on both dev and prod Supabase environments?▼

Yes, you can enable maintenance mode on both dev and prod Supabase environments. The toggle applies the MAINTENANCE_MODE secret to the login edge function for whichever environment you specify in the command.

What is the best way to disable new user sign-ins during an incident response?▼

The best way to disable new user sign-ins during an incident response is to activate a server-side login killswitch. By setting MAINTENANCE_MODE on your Supabase edge function, you gracefully block new logins while keeping existing sessions intact.

Does toggling MAINTENANCE_MODE affect currently logged-in Supabase users?▼

Toggling MAINTENANCE_MODE does not affect currently logged-in Supabase users. The killswitch is designed to block new sign-ins during maintenance windows while preserving existing active sessions.

What Supabase CLI commands are needed to set environment secrets for maintenance mode?▼

Setting environment secrets for maintenance mode requires Supabase CLI commands that apply the MAINTENANCE_MODE variable to the login edge function. The process reads your environment file, derives the project ref, and executes the appropriate commands to set or unset the secret.