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 에이전트 및 워크플로 제어: 터미널에서 세 가지 에이전트 유형을 생성, 실행, 관리하며, Computer Use Agents를 위한 브라우저 인증 세션 캡처, 대기 작업 승인, 단계별 모니터링으로 에이전트를 AI 워크플로로 연결하세요.
• 리포지토리 및 환경 변수 관리: GitHub 리포지토리, 브랜치, 풀 리퀘스트, 환경 변수, 커스텀 도메인을 관리하며, 올바른 Cosmic API 키(Next.js 전용 변형 포함)로 로컬 환경 설정을 자동 구성하세요.
• 다양한 AI 모델 제공자: 여러 AI 제공자 중 선택하고 기본 모델을 설정하세요(예: Anthropic의 Claude, OpenAI의 GPT, Google의 Gemini).

Cosmic CLI 사용 방법

1. CLI 전역 설치 선호하는 방법으로 설치하세요(기사에서 npm과 bun 언급).
2. 인증 두 가지 지원 방법 중 하나 사용: 전체 대시보드 액세스를 위한 사용자 인증 또는 특정 버킷 빠른 액세스를 위한 버킷 키 인증.
3. 대화형 세션 시작 또는 직접 명령으로 Cosmic 워크스페이스에서 작업하세요.
4. 프로젝트 생성 또는 업데이트 앱 생성을 위한 자연어 명령 또는 AI 지원 코드 변경을 위해 기존 Git 리포지토리에 연결하세요.
5. CLI에서 Vercel 배포 프리뷰 배포와 프로덕션 릴리스 포함, 환경 변수와 도메인 구성을 CLI가 처리합니다.
6. 터미널에서 AI 에이전트 및 워크플로 실행 실행 진행 상황 모니터링 및 필요 시 대기 작업 승인.

사용 사례

• 아이디어에서 라이브 앱까지(콘텐츠 및 배포 포함): 단일 엔드투엔드 흐름으로 Cosmic 프로젝트에 연결된 프로덕션 준비 앱, GitHub 리포지토리, 라이브 Vercel 배포를 생성하세요.
• 콘텐츠 작업 유지 및 확장: AI 기반 콘텐츠 생성으로 Cosmic 버킷에 적절한 구조 객체를 만들고, 지속 콘텐츠 작업을 위한 대화형 콘텐츠 채팅 모드를 사용하세요.
• 검토 준비 변경으로 기존 코드베이스 수정: CLI를 리포지토리에 연결하여 Code Agent가 지시에 따라 기능 브랜치 생성 및 변경 커밋 후 풀 리퀘스트 열고 프리뷰 배포.
• 환경 구성 업데이트 및 안정 배포: 배포 중 환경 변수와 커스텀 도메인을 CLI로 관리하며 로그 스트리밍으로 진행 상황 추적.
• 터미널에서 다단계 AI 작업 조정: 지원 에이전트 유형 실행 및 AI 워크플로로 연결, 각 단계 진행 검토 및 필요 시 실행 취소.

자주 묻는 질문

• Cosmic CLI는 Cosmic 대시보드를 사용해야 하나요? 아니요. CLI는 콘텐츠 관리, 앱 생성, 배포, 에이전트 오케스트레이션을 포함해 Cosmic 기능을 터미널로 가져오기 위해 설계되었습니다.

• CLI는 인증을 어떻게 처리하나요? CLI는 두 가지 방법을 지원합니다: 사용자 인증(전체 대시보드 액세스)과 버킷 키 인증(로그인 없이 특정 버킷에 빠르게 액세스).

• CLI에서 어떤 AI 상호작용이 가능한가요? CLI는 콘텐츠 컨텍스트가 포함된 AI 채팅 모드를 제공하며, 터미널에서 제어할 수 있는 AI 에이전트와 AI 워크플로를 지원합니다.

• CLI로 Vercel에 배포할 수 있나요? 네. CLI는 환경 변수 관리, 프리뷰 배포, 프로덕션 릴리스, 커스텀 도메인, 실시간 로그 스트리밍을 위한 내장 Vercel 통합을 포함합니다.

• CLI 사용에 플랜 기반 제한이 있나요? 문서에 따르면 Cosmic CLI는 대시보드와 동일한 플랜 기반 제한을 따르며, AI 에이전트 제한도 포함됩니다.

대안

• API 기반 통합(자체 스크립트 작성): 완전한 제어를 원하시면 Cosmic API를 기반으로 콘텐츠 작업, 리포지토리 자동화, 배포를 위한 터미널 스크립트를 직접 빌드할 수 있습니다; 이는 편의성을 커스터마이징으로 바꾸는 선택입니다.
• IDE 내 범용 AI 코딩 어시스턴트: IDE 중심 코딩 어시스턴트는 코드 변경을 도울 수 있지만, Cosmic 특화 콘텐츠 구조화, 리포지토리 준비, Vercel 배포 워크플로를 직접 지원하지 않을 수 있습니다.
• 워크플로 자동화 도구(CI/CD 및 오케스트레이션 플랫폼): 작업과 배포를 오케스트레이션하는 도구는 워크플로 일부를 자동화할 수 있지만, 구조화된 Cosmic 콘텐츠 생성과 에이전트 상호작용 조정을 위한 추가 단계가 필요합니다.
• 대시보드 중심 콘텐츠 및 앱 관리: 시각적 도구를 원할 때 Cosmic 대시보드 내에서 머무르는 것이 대안이지만, 여기 설명된 터미널 기반 인터랙티브 쉘, 리포/배포 자동화, CLI 제어 에이전트 워크플로를 제공하지 않습니다.