Supabase CLI

Официальный CLI Supabase: локальный стек, миграции базы, деплой Edge Functions и генерация типов из терминала

  • 2 446 ★ репозитория
  • Последний коммит
CLI

Широкий доступ

Почему такой уровень

  • db push меняет схему облачной базы
  • Деплоит код Edge Functions в облако
Все причины и проверки

supabase/cli

Установка

Ручная установка

npm install -D supabase

Установка в проект, запуск через npx supabase.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • db push меняет схему облачной базы
  • Деплоит код Edge Functions в облако

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

CLI поднимает на машине полный стек Supabase: Postgres, Auth, Realtime, Storage, Edge Functions и API. Через него создаются и применяются миграции, сравниваются схемы, сбрасывается локальная база и изменения отправляются в привязанный облачный проект. Edge Functions создаются, запускаются локально и деплоятся из той же папки проекта. Команда gen types генерирует типы TypeScript из локальной или облачной базы. Агенту CLI полезен тем, что все операции с проектом выполняются обычными командами оболочки, а локальный стек дает безопасную песочницу.

Для кого. Для разработчиков на Supabase, которые ведут схему в миграциях и хотят поручать эту работу агенту.

Подходит, если

  • Нужно, чтобы агент писал миграции и проверял их на локальной базе
  • Нужно обновить типы TypeScript после изменения схемы
  • Нужно задеплоить Edge Function без открытия дашборда

Не подходит, если

  • Проект не на Supabase
  • Нужен разговорный доступ к облачному проекту без терминала: для этого есть MCP-сервер Supabase

Пример запроса к агенту

Создай миграцию с таблицей profiles, примени ее к локальной базе и перегенерируй типы

Ограничения

Локальный стек работает в контейнерах, поэтому нужен Docker или совместимая среда. Команды link и db push работают с облачным аккаунтом Supabase, доступность которого из России без VPN не гарантирована. Образы контейнеров скачиваются из зарубежных реестров.

Как отключить. Остановите стек командой supabase stop и удалите CLI тем же менеджером пакетов, которым ставили: npm uninstall supabase, brew uninstall supabase или scoop uninstall supabase.

Частые вопросы

Как связать локальный проект с облачным?

Выполните supabase login, затем supabase link. После этого db push применит миграции к облачной базе.

Можно ли поставить без Node.js?

Да, есть Homebrew, Scoop, пакеты для Linux в релизах и установочный скрипт.

Обсуждение

Вопросов и отзывов пока нет.

Выбор редакции

Официальные скиллы Supabase: помогают агенту работать с базой, Auth, Edge Functions и лучшими практиками Postgres

СкиллМинимальный доступ2,9 тыс.Звезды репозитория
Официальный

Официальный MCP-сервер Supabase: агент управляет таблицами, читает конфигурацию и данные проектов после входа через OAuth

MCP-серверШирокий доступ3 тыс.Звезды репозитория
Официальный

Два официальных MCP-сервера Prisma: локальный для миграций и Prisma Studio и удаленный для управления базами Prisma Postgres

MCP-серверШирокий доступ49Звезды репозитория
Официальный

Мгновенный REST и MCP поверх PostgreSQL: агент читает данные существующей базы через MCP-эндпоинт без написания бэкенда

MCP-серверРасширенный доступ4,6 тыс.Звезды репозитория
Официальный

Плагин Claude Code для Butterbase: 39 скиллов и 34 команды ведут от идеи до запущенного приложения на облачном бэкенде

ПлагинШирокий доступ535Звезды репозитория

MCP-сервер для PostgreSQL с подбором индексов, планами EXPLAIN, проверкой здоровья базы и режимом только чтения

MCP-серверШирокий доступ3,4 тыс.Звезды репозитория

Коротко о README

README перечисляет способы установки: скрипт, npm, Homebrew, Scoop и пакеты для Linux. Далее по шагам показаны запуск локального стека, привязка облачного проекта, работа с миграциями, Edge Functions и генерация типов. Для разработчиков описана структура монорепозитория и правила участия. Лицензия MIT.

Бейдж для README

Сообщить о проблеме

Foxx AISupabase CLI
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.