@kepo/cli

Kepo CLI - A tool for building TypeScript code into platform-specific plugins.

Installation

npm install -g @kepo/cli
# or
yarn global add @kepo/cli

Usage

You can use the CLI in the following ways:

# After global installation
kp [command] [options]

# Or using npx
npx @kepo/cli [command] [options]

System Requirements

• Node.js >= 14.0.0
• Supported OS: macOS, Windows, Linux
• Supported architectures: x86_64 (Intel/AMD), arm64 (Apple Silicon/ARM)

Auto-Download

The CLI binary will be automatically downloaded from our release server during installation or first use, matching your system's architecture.

Publish Flow

npm publish 会自动触发 prepublishOnly：

1. 构建多平台二进制到 ../dist
2. 同步上传二进制到 R1/R2（使用 Wrangler）

发布前请设置：

• R1_BUCKET（或 R2_BUCKET）
• CLOUDFLARE_API_TOKEN
• （可选）R1_PREFIX（默认 kepo-cli）

如需仅发布 npm、跳过上传，可临时设置 SKIP_R1_UPLOAD=1。

One-Shot Release

仓库根目录提供了一键发布脚本 release.sh，会串行执行：

1. 可选写入 npm/package.json 版本号
2. 可选执行 go test ./...
3. 执行 npm publish（自动触发 prepublish 构建与上传）
4. 发布后校验 npm 最新版本

常用命令：

# 正式发布（会执行测试）
./release.sh --version 0.0.12

# 正式发布但跳过 R1 上传
./release.sh --version 0.0.12 --skip-upload

# 仅演练，不实际发布
./release.sh --dry-run --skip-upload