Cosmic CLI

Что такое Cosmic CLI?

Cosmic CLI — это AI-командная строка, которая переносит возможности платформы Cosmic в рабочий процесс терминала. Она предназначена для помощи в сборке приложений, управлении контентом, деплое в продакшн и запуске или оркестрации AI-агентов без выхода из командной строки.

Вместо использования только дашборда Cosmic CLI предлагает интерактивные и AI-поддерживаемые режимы команд для выполнения многоэтапных задач — например, генерации готового к продакшену приложения с настройкой репозитория и деплоем — с помощью команд на естественном языке и структурированных рабочих процессов.

Ключевые возможности

• Установка одной командой и глобальное использование CLI: Установите CLI глобально (через npm или bun), чтобы запускать возможности Cosmic из терминала.
• Интерактивная оболочка с навигацией по рабочему пространству: Запустите интерактивную сессию с историей команд, подсказками, учитывающими рабочее пространство, навигацией в стиле файловой системы и возможностью выполнения системных команд с настроенным префиксом.
• AI-чат-режимы с контекстом контента: Используйте разговорные режимы с полным учетом контекста вашего контента и флагами для добавления дополнительного контекста для AI-операций.
• Генерация приложений на естественном языке с настройкой репозитория: Опишите, что хотите создать; CLI сгенерирует готовое к продакшену приложение, подключенное к вашему проекту Cosmic, и подготовит репозиторий GitHub для деплоя.
• AI-обновления кода из вашего репозитория: Подключитесь к существующему репозиторию, чтобы Code Agent проанализировал кодовую базу, создал ветку с фичей и закоммитил изменения по вашим инструкциям.
• Автоматизация деплоя в Vercel: Деплойте напрямую в Vercel с управлением переменными окружения, обработкой кастомных доменов, preview-деплоями и релизами в продакшн, включая стриминг логов в реальном времени.
• Управление AI-агентами и рабочими процессами из CLI: Создавайте, запускайте и управляйте тремя типами агентов из терминала, включая захват сессий браузерной аутентификации для Computer Use Agents, одобрение ожидающих операций и цепочки агентов в AI Workflows с пошаговым мониторингом.
• Управление репозиториями и переменными окружения: Управляйте репозиториями GitHub, ветками, pull request'ами, переменными окружения и кастомными доменами, автоматически настраивая локальные переменные окружения с правильными API-ключами Cosmic (включая варианты для Next.js).
• Поддержка нескольких провайдеров AI-моделей: Выбирайте из нескольких провайдеров AI и устанавливайте модель по умолчанию (примеры: Claude через Anthropic, GPT через OpenAI и Gemini через Google).

Как использовать Cosmic CLI

1. Установите CLI глобально предпочитаемым способом (в статье упоминаются npm и bun).
2. Аутентифицируйтесь одним из двух поддерживаемых методов: пользовательская аутентификация для полного доступа к дашборду или аутентификация по bucket key для быстрого доступа к конкретному бакету.
3. Запустите интерактивную сессию или используйте прямые команды для работы в вашем рабочем пространстве Cosmic.
4. Создавайте или обновляйте проекты с помощью команд на естественном языке для генерации приложений или подключайтесь к существующему Git-репозиторию для AI-поддерживаемых изменений кода.
5. Деплойте в Vercel из CLI, включая preview-деплой и релизы в продакшн, с обработкой переменных окружения и доменов CLI.
6. Запускайте AI-агентов и рабочие процессы из терминала, отслеживая прогресс выполнения и одобряя ожидающие операции при необходимости.

Сценарии использования

• От идеи до живого приложения (включая контент и деплой): Сгенерируйте готовое к продакшену приложение, подключенное к вашему проекту Cosmic, с репозиторием GitHub и живым деплоем в Vercel через единый end-to-end поток.
• Поддержка и масштабирование операций с контентом: Используйте AI для создания правильно структурированных объектов в вашем бакете Cosmic и интерактивный чат-режим для текущих задач с контентом.
• Изменение существующей кодовой базы с готовыми к ревью изменениями: Укажите CLI на ваш репозиторий, чтобы Code Agent создал ветку с фичей, закоммитил изменения по инструкциям, открыл pull request и задеплоил preview.
• Обновление конфигурации окружения и надежный деплой: Используйте CLI для управления переменными окружения и кастомными доменами во время деплоя, с стримингом логов для отслеживания прогресса.
• Координация многоэтапных AI-задач из терминала: Запускайте поддерживаемые типы агентов и цепляйте их в AI Workflows, просматривая прогресс каждого шага и отменяя запуски при необходимости.

FAQ

• Требует ли Cosmic CLI использования панели Cosmic? Нет. CLI предназначен для переноса возможностей Cosmic в терминал, включая управление контентом, создание приложений, деплой и оркестрацию агентов.

• Как CLI обрабатывает аутентификацию? CLI поддерживает два метода: аутентификация пользователя (полный доступ к панели) и аутентификация по ключу бакета (быстрый доступ к конкретному бакету без входа).

• Какие AI-взаимодействия доступны из CLI? CLI включает AI-чат с контекстом контента и поддерживает AI-агентов и AI Workflows, управляемые из терминала.

• Может ли CLI деплоить в Vercel? Да. CLI включает встроенную интеграцию с Vercel для управления переменными окружения, preview-деплоев, production-релизов, кастомных доменов и стриминга логов в реальном времени.

• Есть ли ограничения по планам для использования CLI? В статье указано, что Cosmic CLI соблюдает те же ограничения по планам, что и панель, включая лимиты для AI Agents.

Альтернативы

• Интеграция через API (собственные скрипты): Если нужен полный контроль, можно создать свои терминал-скрипты на базе API Cosmic для операций с контентом, автоматизации репозиториев и деплоев; это меняет удобство на кастомизацию.
• Универсальные AI-ассистенты для кодирования в IDE: Ассистенты в IDE помогают с изменениями кода, но могут не охватывать структуру Cosmic-контента, подготовку репозиториев и workflows деплоя в Vercel.
• Инструменты автоматизации workflow (CI/CD и платформы оркестрации): Инструменты для оркестрации задач и деплоев автоматизируют части workflow, но потребуют доп. шагов для генерации структурированного Cosmic-контента и координации взаимодействий агентов.
• Управление контентом и приложениями через панель: Оставаясь в панели Cosmic, вы получаете визуальные инструменты, но без интерактивной терминальной оболочки, автоматизации repo/деплоя или workflows агентов под CLI, описанных здесь.