Cosmic CLI

什么是 Cosmic CLI？

Cosmic CLI 是一个 AI 驱动的命令行界面，将 Cosmic 平台功能引入终端工作流。它旨在帮助您构建应用、管理内容、部署到生产环境，并在命令行中运行或编排 AI 代理，而无需离开终端。

CLI 提供交互式和 AI 辅助的命令模式来执行多步骤任务（如生成带有仓库设置和部署的生产就绪应用），而非仅依赖 Cosmic 仪表板，通过自然语言命令和结构化工作流实现。

主要功能

• 一键安装和全局 CLI 使用：使用 npm 或 bun 全局安装 CLI，从终端运行 Cosmic 功能。
• 交互式 shell 工作区导航：启动交互式会话，支持命令历史、工作区感知提示、文件系统式导航，并能使用配置前缀运行系统命令。
• 带内容上下文的 AI 聊天模式：使用包含完整内容上下文感知的对话模式，并通过标志为 AI 操作提供额外上下文。
• 自然语言应用生成与仓库设置：描述您想构建的内容；CLI 生成连接到您的 Cosmic 项目、生产就绪的应用，并准备 GitHub 仓库以供部署。
• 从仓库的 AI 驱动代码更新：连接现有仓库，让 Code Agent 分析代码库、创建功能分支，并根据您的指令提交更改。
• Vercel 部署自动化：直接部署到 Vercel，支持环境变量管理、自定义域名处理、预览部署和生产发布，包括实时日志流。
• CLI 控制 AI 代理和工作流：从终端创建、运行和管理三种代理类型，包括捕获浏览器认证会话以用于 Computer Use Agents、批准待处理操作，以及将代理链式连接成 AI Workflows 并逐步监控。
• 仓库和环境变量管理：管理 GitHub 仓库、分支、拉取请求、环境变量和自定义域名，同时自动配置本地环境设置，使用正确的 Cosmic API 密钥（包括 Next.js 特定变体）。
• 多种 AI 模型提供商：从多个 AI 提供商中选择并设置默认模型（示例包括 Anthropic 的 Claude、OpenAI 的 GPT 和 Google 的 Gemini）。

如何使用 Cosmic CLI

1. 全局安装 CLI，使用您偏好的方法（文章提及 npm 和 bun）。
2. 认证，使用两种支持方法之一：用户认证以获得完整仪表板访问，或存储桶密钥认证以快速访问特定存储桶。
3. 启动交互式会话 或使用直接命令在您的 Cosmic 工作区中操作。
4. 创建或更新项目，使用自然语言命令生成应用，或连接现有 Git 仓库进行 AI 辅助代码更改。
5. 从 CLI 部署到 Vercel，包括预览部署和生产发布，CLI 处理环境变量和域名配置。
6. 从终端运行 AI 代理和工作流，监控执行进度并在需要时批准待处理操作。

使用场景

• 从想法到上线应用（包括内容和部署）：通过单一端到端流程生成连接到 Cosmic 项目的生产就绪应用，创建 GitHub 仓库和 Vercel 实时部署。
• 维护和扩展内容操作：使用 AI 驱动的内容创建生成 Cosmic 存储桶中结构正确的对象，并使用交互式内容聊天模式处理持续内容任务。
• 使用审阅就绪更改修改现有代码库：将 CLI 指向您的仓库，让 Code Agent 根据指令创建功能分支、提交更改，然后打开拉取请求并部署预览。
• 更新环境配置并可靠部署：使用 CLI 在部署期间管理环境变量和自定义域名，同时流式传输日志跟踪部署进度。
• 从终端协调多步骤 AI 任务：运行支持的代理类型并将它们链式连接成 AI Workflows，审阅每个步骤进度，并在需要时取消运行。

常见问题

• 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 仪表板内是一种替代方案，尽管它无法提供此处描述的终端驱动交互 shell、仓库/部署自动化或 CLI 控制的代理工作流。