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.