Документация Supabase по SSH

Supabase запускает supabase.sh — публичный SSH-сервер, который даёт ИИ-агентам для написания кода прямой доступ к документации через bash. Бесплатно и уже доступно.

Это AI-перевод статьи, сделанный каналом Про AI: Лучшие Статьи и Исследования.

Документация Supabase по SSH

Supabase docs over SSH Автор: Greg Richardson Оригинальный текст:

Мы запускаем supabase.sh — публичный SSH-сервер, который даёт ИИ-агентам для написания кода прямой bash-доступ к документации Supabase. Это бесплатно и уже доступно в качестве публичного эксперимента:

ssh supabase.sh

Агенты для написания кода не знают того, чего они не знают. Без доступа к актуальной документации они начинают угадывать — и часто рекомендуют несуществующие API, запускают некорректные CLI-команды или пропускают важные шаги, например включение RLS. Как лучше всего предоставить им актуальную документацию?

Если понаблюдать за тем, как агент работает с кодовой базой, вы будете видеть одни и те же инструменты снова и снова: grep, find, ls, cat. Эти модели интенсивно обучены на bash, и они используют файловую систему как основной интерфейс для исследования.

supabase.sh даёт им тот же интерфейс для нашей документации. Каждая страница документации — это markdown-файл в виртуальной файловой системе по пути /supabase/docs. Агенты могут искать по темам, просматривать списки страниц и читать любую страницу по мере необходимости. Тот же рабочий процесс, который они используют для кода, применяется и к документации.

Настройка агента

Добавьте рекомендуемые инструкции Supabase в файл AGENTS.md или CLAUDE.md вашего проекта:

ssh supabase.sh agents >> AGENTS.md

Или позвольте агенту настроить всё за вас:

ssh supabase.sh setup | claude

Этот фрагмент указывает вашему агенту проверять документацию перед работой с Supabase, удерживая его в рамках актуальных данных и не давая галлюцинировать.

Как это устроено

supabase.sh работает на just-bash — эмуляторе Bash с открытым исходным кодом от Vercel, написанном на TypeScript. Команды выполняются внутри изолированной JavaScript-среды выполнения поверх виртуальной файловой системы, а значит, сервер можно держать публичным и без аутентификации, не запуская при этом настоящий shell на сервере.

Это не первый раз, когда кто-то создаёт публичное приложение поверх SSH. Команда Charm исследовала эту идею с помощью своей библиотеки Wish, и существует ряд известных SSH-экспериментов, которые стоит попробовать (ssh terminal.shop — хороший пример).

Мы применили тот же паттерн к документации — файлы, передаваемые по SSH, представляют собой тот же markdown-исходник, на котором построен supabase.com/docs. Тот же контент, только через bash-оболочку, а не через браузер.

Почему bash, а не поиск?

MCP-сервер Supabase уже включает инструмент search_docs — гибридный поиск по ключевым словам и семантический поиск по нашей документации. Он работает, но агент должен заранее знать, что именно ему искать. Он не может просматривать, бегло изучать или случайно наткнуться на что-то полезное самостоятельно.

Bash даёт агентам возможность исследовать без заранее определённого запроса. Они могут просмотреть все страницы по теме, выполнить поиск сразу по нескольким файлам и прочитать фрагмент страницы, прежде чем решать, релевантна ли она. Поиск более непрозрачен — агент задаёт вопрос и получает результаты без возможности исследовать или перемещаться по ним. С bash он может выполнить grep по документации, вывести конкретные файлы через cat и использовать head и tail для беглого просмотра, не раздувая своё контекстное окно.

Начало работы

supabase.sh уже работает. Попробуйте из любого терминала:

ssh supabase.sh

Чтобы добавить контекст Supabase в ваш проект:

ssh supabase.sh agents >> AGENTS.md

Проект имеет открытый исходный код — исходники доступны на github.com/supabase-community/supabase-ssh.

Это ранний эксперимент — будем рады узнать ваше мнение. Если вы столкнётесь с проблемой или чего-то не хватает, создайте issue на GitHub или найдите нас в X.

Подпишитесь на канал и каждый день читайте лучшие материалы про AI переведенные на русский!

Нашли интересную статью для перевода? Пришлите нашему боту: @ailongreadsbot