Cosmic CLI

Cosmic CLIとは？

Cosmic CLIは、Cosmicプラットフォームの機能をターミナルワークフローに取り込むAI搭載のコマンドラインインターフェースです。コマンドラインを離れずにアプリケーションの構築、コンテンツ管理、本番デプロイ、AIエージェントの実行・オーケストレーションを支援するよう設計されています。

Cosmicダッシュボードだけに頼るのではなく、CLIはインタラクティブでAI支援のコマンドモードを提供し、自然言語コマンドと構造化されたワークフローで多段階タスクを実行します—たとえば、リポジトリ設定とデプロイを含む本番対応アプリの生成などです。

主な機能

• ワンコマンドインストールとグローバルCLI利用: npmまたはbunでCLIをグローバルインストールし、ターミナルからCosmic機能を実行。
• インタラクティブシェルワークスペースナビゲーション: コマンド履歴、ワークスペース認識プロンプト、ファイルシステム風ナビゲーション、設定されたプレフィックスでシステムコマンド実行が可能なインタラクティブセッションを開始。
• コンテンツコンテキスト付きAIチャットモード: コンテンツの完全なコンテキスト認識を持つ会話モードを使用。AI操作用の追加コンテキストをフラグで指定可能。
• リポジトリ設定付き自然言語アプリ生成: 作りたいものを記述すると、CLIがCosmicプロジェクトに接続された本番対応アプリケーションを生成し、GitHubリポジトリをデプロイ用に準備。
• リポジトリからのAI駆動コード更新: 既存リポジトリに接続し、Code Agentがコードベースを解析、フィーチャーブランチを作成、指示に基づき変更をコミット。
• Vercelデプロイ自動化: 環境変数管理、カスタムドメイン対応、プレビューデプロイ、本番リリースをVercelに直接デプロイ。リアルタイムログストリーミング付き。
• CLIによるAIエージェントとワークフロー制御: ターミナルから3種類のエージェントタイプを作成・実行・管理。Computer Use Agents用のブラウザ認証セッションキャプチャ、保留操作の承認、エージェントをAIワークフローにチェーンしステップごとの監視。
• リポジトリと環境変数管理: GitHubリポジトリ、ブランチ、プルリクエスト、環境変数、カスタムドメインを管理。Cosmic APIキー（Next.js専用バリエーション含む）を自動でローカル環境に設定。
• 複数AIモデルプロバイダ: 複数のAIプロバイダから選択し、デフォルトモデルを設定（例: Anthropic経由のClaude、OpenAI経由のGPT、Google経由のGemini）。

Cosmic CLIの使い方

1. CLIをグローバルインストール 好みの方法で（記事ではnpmとbunを記載）。
2. 認証 2つのサポート方法から選択: フルダッシュボードアクセス用のユーザー認証、特定バケットへのクイックアクセス用のバケットキー認証。
3. インタラクティブセッションを開始 または直接コマンドでCosmicワークスペース内で作業。
4. プロジェクトの作成・更新 自然言語コマンドでアプリ生成、または既存Gitリポジトリに接続してAI支援コード変更。
5. CLIからVercelへデプロイ プレビューデプロイと本番リリース含む。環境変数とドメイン設定をCLIが処理。
6. AIエージェントとワークフローをターミナルから実行 実行進捗を監視し、必要な保留操作を承認。

ユースケース

• アイデアからライブアプリへ（コンテンツとデプロイ含む）: Cosmicプロジェクトに接続された本番対応アプリケーションを生成。GitHubリポジトリとVercelライブデプロイをエンドツーエンドフローで作成。
• コンテンツ運用を維持・スケール: AI駆動コンテンツ作成でCosmicバケットに適切な構造のオブジェクトを生成。インタラクティブコンテンツチャットモードで継続タスクを実行。
• レビュー準備済み変更で既存コードベースを修正: CLIをリポジトリに向け、Code Agentがフィーチャーブランチを作成・指示に基づき変更コミット、プルリクエスト作成、プレビューデプロイ。
• 環境設定を更新し確実にデプロイ: デプロイ時に環境変数とカスタムドメインをCLIで管理。ログストリーミングで進捗追跡。
• ターミナルから多段階AIタスクを調整: サポートエージェントタイプを実行しAIワークフローにチェーン。各ステップの進捗を確認し、必要に応じて実行キャンセル。

FAQ

• Cosmic CLIはCosmicダッシュボードの使用を必要としますか？ いいえ。CLIはCosmicの機能をターミナルに持ち込むことを目的としており、コンテンツ管理、アプリ作成、デプロイ、エージェントオーケストレーションを含みます。

• CLIは認証をどのように扱いますか？ CLIは2つの方法をサポートします：ユーザー認証（ダッシュボードへのフルアクセス）とバケットキー認証（ログインなしで特定バケットへのクイックアクセス）。

• CLIから利用可能なAIインタラクションの種類は何ですか？ CLIにはコンテンツコンテキスト付きのAIチャットモードが含まれており、ターミナルから制御可能なAIエージェントとAI Workflowsをサポートします。

• CLIはVercelへのデプロイができますか？ はい。CLIには環境変数管理、プレビューデプロイ、本番リリース、カスタムドメイン、リアルタイムログストリーミングのためのVercel統合が組み込まれています。

• CLI使用にプラン別の制限はありますか？ 本記事では、Cosmic CLIがダッシュボードと同じプラン別制限を遵守し、AI Agentsの制限を含むと述べられています。

代替案

• API駆動の統合（独自スクリプトの作成）: 完全な制御を好む場合、CosmicのAPIを基にした独自のターミナルスクリプトを構築できます。これによりコンテンツ操作、リポジトリ自動化、デプロイが可能ですが、利便性をカスタマイズ性と交換します。
• IDE内の汎用AIコーディングアシスタント: IDE中心のコーディングアシスタントはコード変更を支援しますが、Cosmic特有のコンテンツ構造化、リポジトリ準備、Vercelデプロイフローを直接カバーしない場合があります。
• ワークフロー自動化ツール（CI/CDおよびオーケストレーションプラットフォーム）: ジョブとデプロイをオーケストレーションするツールはワークフローの一部を自動化できますが、構造化されたCosmicコンテンツ生成やエージェントインタラクションの調整に追加ステップが必要です。
• ダッシュボード中心のコンテンツおよびアプリ管理: 視覚的なツールを求める場合、Cosmicダッシュボード内に留まるのが代替案ですが、ここで説明したターミナル駆動のインタラクティブシェル、リポ/デプロイ自動化、CLI制御のエージェントワークフローは提供されません。