Opzero

---

快速开始

安装

# Install globally
npm install -g opzero

# Or use directly with npx
npx opzero deploy ./my-site --name my-project

身份验证

opzero login

从 opzero.sh/dashboard/api-keys 获取 API 密钥。

部署

# Deploy a directory
opzero deploy ./my-site --name my-project

# Deploy a React component
opzero deploy --artifact ./App.tsx --name my-app

# Deploy markdown as a styled page
opzero deploy --markdown ./README.md --name docs

# Deploy with OpZero theme
opzero deploy --themed ./content.html --name landing

就这么简单。你的网站已上线。

命令

身份验证

命令	描述
opzero login	进行身份验证（使用 API 密钥或浏览器 OAuth）
opzero logout	清除已存储的凭据
opzero whoami	显示当前用户和套餐信息

部署

命令	描述
opzero deploy [dir]	部署目录
opzero deploy --artifact <file>	部署 React 组件
opzero deploy --markdown <file>	将 Markdown 部署为页面
opzero deploy --themed <file>	使用 OpZero 品牌主题进行部署

项目

命令	描述
opzero projects	列出所有项目
opzero projects create <name>	创建新项目
opzero projects delete <name>	删除项目
opzero projects archive <name>	归档项目
opzero projects cleanup	查找过期或重复的项目

部署

命令	描述
opzero deployments [project]	列出部署历史记录
opzero rollback <deployment-id>	回滚到先前版本
opzero redeploy <project>	重新部署最新版本
opzero logs <id>	查看构建日志

其他

命令	描述
opzero domains set <project> <domain>	设置自定义域名
opzero init [dir]	根据模板搭建项目骨架
opzero templates	列出可用模板
opzero status	查看平台状态和用量
opzero open <project>	在浏览器中打开项目
opzero mcp	为 AI 工具启动 MCP 服务

全局标志

• --help, -h — 显示帮助信息
• --version, -v — 显示版本
• --json — 以 JSON 格式输出
• --target <provider> — cloudflare、netlify 或 vercel

MCP 服务

OpZero MCP 服务让 AI 助手（Claude Code、Cursor、Windsurf 等）能够直接部署网站。

Claude Code 设置

将以下内容添加到 MCP 设置中：

{
  "mcpServers": {
    "opzero": {
      "command": "opzero",
      "args": ["mcp"]
    }
  }
}

或者使用独立软件包：

{
  "mcpServers": {
    "opzero": {
      "command": "npx",
      "args": ["@opzero/mcp"]
    }
  }
}

可用工具（26 个）

部署： quick_deploy、deploy_website、deploy_artifact、deploy_themed、deploy_markdown、update_deployment

项目： list_projects、create_project、project_delete、project_archive、project_cleanup

部署： get_deployment、list_deployments、redeploy、rollback_deployment、get_build_logs、delete_deployment

模板与域名： get_template、set_custom_domain

系统： help、ask_agent、get_system_status

仅限本地： deploy_local_dir、init_project、open_project、whoami

API 客户端

使用 @opzero/core 构建自己的集成：

npm install @opzero/core

import { OpZeroClient } from '@opzero/core'

const client = new OpZeroClient({ apiKey: 'your-api-key' })

// Deploy a website
const result = await client.deploy({
  name: 'my-site',
  files: {
    'index.html': '<h1>Hello World</h1>',
  },
})

console.log(`Live at: ${result.url}`)

软件包

软件包	npm	描述
opzero		CLI 工具
@opzero/mcp		面向 AI 工具的 MCP 服务
@opzero/core		API 客户端库

Development

# Clone the repo
git clone https://github.com/opzero-sh/cli.git
cd cli

# Install dependencies
bun install

# Build all packages
bun run build

# Run the CLI locally
bun run packages/cli/src/index.tsx

License

MIT — see LICENSE

---