s0c — это официальный интерфейс командной строки для Sb0rka. Он оборачивает API Sb0rka в набор целенаправленных команд, позволяя вам управлять проектами, базами данных и подключениями, не покидая терминал. Каждая команда спроектирована так, чтобы ее можно было комбинировать: JSON выводится в stdout, ошибки — в stderr с префиксом s0c:, а любая неудача завершается ненулевым кодом. Это делает s0c безопасным для встраивания в скрипты, CI-пайплайны и инструментальные цепочки AI-агентов.

Что можно делать с помощью s0c

• Аутентификация — один раз введите имя пользователя/email и пароль; s0c проверит их и сохранит учетные данные локально в ~/.s0c/auth.json.
• Управление проектами — просмотр списка всех проектов в вашем аккаунте.
• Управление базами данных — просмотр списка баз данных, создание новых и получение URI для подключения.
• Открытие psql-сессий — быстрый переход в интерактивную сессию psql с использованием ваших реквизитов подключения Sb0rka.
• Установка значений по умолчанию — сохраните идентификаторы проекта и базы данных по умолчанию, чтобы не указывать их в каждой команде.

Разработано для скриптов и агентов

s0c следует соглашениям, упрощающим интеграцию в автоматизированные рабочие процессы:

• Ответы API по умолчанию выводятся в виде однострочного JSON; добавьте --pretty для человекочитаемого форматирования.
• Все ошибки предваряются префиксом s0c: и выводятся в stderr, поэтому они никогда не загрязняют ваш конвейер stdout.
• Ненулевые коды выхода при сбоях означают, что любая оболочка или агент может надежно обнаружить и обработать ошибки.
• s0c api dbs uri выводит только чистую строку URI подключения — и ничего больше — поэтому ее можно напрямую захватить с помощью $(...).

Быстрый старт