@seacloudai/seacloud-cli 0.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VtrixAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,228 @@
+<div align="center">
+  <p>
+    <img src="./assets/seacloud-cli-image-en.png" alt="SeaCloud CLI banner">
+  </p>
+  <h1>SeaCloud CLI</h1>
+  <h3>The official CLI for the SeaCloud AI Platform</h3>
+  <p>
+    Built for AI agents. Authenticate, browse models, submit multimodal tasks,
+    track task status, and manage SkillHub skills from any agent or terminal.
+  </p>
+  <p>
+    <a href="https://www.npmjs.com/package/@seacloudai/seacloud-cli">
+      <img src="https://img.shields.io/npm/v/@seacloudai/seacloud-cli" alt="npm version">
+    </a>
+    <img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License">
+    <img src="https://img.shields.io/badge/node-%3E%3D18-339933" alt="Node.js >= 18">
+    <img src="https://img.shields.io/badge/go-%3E%3D1.26-00ADD8" alt="Go >= 1.26">
+  </p>
+  <p>
+    <a href="./README.zh.md">中文文档</a>
+    ·
+    <a href="https://vtrix.ai/">Official Website</a>
+  </p>
+</div>
+
+## Features
+
+- **Authentication**: Sign in with the browser-based device flow and store credentials locally.
+- **Model discovery**: List available models and inspect full parameter specs in human-readable or JSON form.
+- **Task execution**: Submit multimodal generation tasks from the CLI with parameter validation and structured output options.
+- **Task tracking**: Poll task status and print result URLs or full JSON responses.
+- **SkillHub integration**: Search, install, and configure agent skills from SeaCloud SkillHub.
+- **Agent-friendly UX**: Supports `--dry-run`, JSON output, stable command shapes, and copy-pasteable examples.
+
+## Install
+
+### Install with npm
+
+```bash
+npm install -g @seacloudai/seacloud-cli
+```
+
+> Requires Node.js 18+
+
+### Install from source
+
+Default install:
+
+```bash
+git clone https://github.com/SeaCloudAI/seacloud-cli.git
+cd seacloud-cli
+make install
+```
+
+> Requires Go 1.26+
+> The installed binary uses the default service endpoints for the public CLI. You can override them with `SEACLOUD_BASE_URL`, `SEACLOUD_MODELS_URL`, `SEACLOUD_GENERATION_URL`, and `SEACLOUD_SKILLHUB_URL`.
+
+If `/usr/local/bin` requires elevated permissions:
+
+```bash
+sudo make install
+```
+
+If you prefer a user-local install without `sudo`:
+
+```bash
+make install PREFIX=$HOME/.local
+export PATH="$HOME/.local/bin:$PATH"
+```
+
+### Download binaries
+
+Prebuilt binaries are published on the [Releases](https://github.com/SeaCloudAI/seacloud-cli/releases) page for:
+
+- macOS `amd64`
+- macOS `arm64`
+- Linux `amd64`
+- Linux `arm64`
+- Windows `amd64`
+
+## Quick Start
+
+### Authenticate
+
+```bash
+seacloud auth login
+seacloud auth status
+```
+
+### Browse models
+
+```bash
+seacloud models list
+seacloud models list --type video
+seacloud models spec kirin_v2_6_i2v
+seacloud models spec kirin_v2_6_i2v --output json
+```
+
+### Run a task
+
+```bash
+seacloud run kirin_v2_6_i2v --param image=https://example.com/cat.jpg
+seacloud run kirin_v2_6_i2v --param prompt="a cat running" --param duration=5
+seacloud run kirin_v2_6_i2v --param mode=pro --output url
+```
+
+### Check task status
+
+```bash
+seacloud task status <task_id>
+seacloud task status <task_id> --output url
+seacloud task status <task_id> --output json
+```
+
+### Manage skills
+
+```bash
+seacloud skills list
+seacloud skills find prompt
+seacloud skills add some-skill
+seacloud skills config --show
+```
+
+## Commands
+
+### `seacloud auth`
+
+```bash
+seacloud auth login
+seacloud auth status
+seacloud auth logout
+seacloud auth set-key <api-key>
+```
+
+### `seacloud models`
+
+```bash
+seacloud models list
+seacloud models list --keywords kirin
+seacloud models list --output id
+seacloud models spec <model_id>
+seacloud models spec <model_id> --output json
+```
+
+### `seacloud run`
+
+```bash
+seacloud run <model_id> --param key=value
+seacloud run <model_id> --param prompt="hello" --param duration=5
+seacloud run <model_id> --output json
+```
+
+Nested fields use dot notation:
+
+```bash
+seacloud run some_model \
+  --param camera_control.type=simple \
+  --param camera_control.speed=2
+```
+
+### `seacloud task`
+
+```bash
+seacloud task status <task_id>
+```
+
+### `seacloud skills`
+
+```bash
+seacloud skills list
+seacloud skills find [query]
+seacloud skills add <slug>
+seacloud skills config --show
+```
+
+### `seacloud version`
+
+```bash
+seacloud version
+```
+
+## Output and Automation
+
+- Use `--output json` where supported for machine-readable responses.
+- Use `--output url` on task commands to print only result URLs.
+- Use global `--dry-run` to inspect execution without sending requests.
+
+Example:
+
+```bash
+seacloud --dry-run run kirin_v2_6_i2v --param prompt=test
+```
+
+## Release
+
+Release assets are built from source and published to GitHub Releases.  
+The npm package downloads the matching prebuilt binary for the user platform during installation.
+
+If you maintain releases manually, the repository includes:
+
+- `scripts/build.sh`
+- `.goreleaser.yml`
+- `scripts/set-release-version.js`
+
+## Repository Layout
+
+```text
+seacloud-cli/
+├── cmd/                # CLI command definitions
+├── internal/auth/      # Auth client and login flow
+├── internal/models/    # Model list and spec APIs
+├── internal/generation/# Task submit and polling
+├── internal/skillhub/  # SkillHub client and install logic
+├── package.json        # npm package manifest
+├── scripts/            # Build, release, and npm wrapper scripts
+└── skills/             # Built-in skill definitions
+```
+
+## Contributing
+
+Issues and pull requests are welcome. Before sending larger changes, it is best to open an issue first so the scope can be discussed.
+
+For local verification:
+
+```bash
+go test ./...
+go run . --help
+```

package/README.zh.md

@@ -0,0 +1,228 @@
+<div align="center">
+  <p>
+    <img src="./assets/seacloud-cli-image-zh.png" alt="SeaCloud CLI banner">
+  </p>
+  <h1>SeaCloud CLI</h1>
+  <h3>SeaCloud AI 平台的官方命令行界面</h3>
+  <p>
+    专为人工智能代理而设计。可从任何代理或终端完成认证、模型查询、
+    多模态任务执行、任务状态追踪和 SkillHub 技能管理。
+  </p>
+  <p>
+    <a href="https://www.npmjs.com/package/@seacloudai/seacloud-cli">
+      <img src="https://img.shields.io/npm/v/@seacloudai/seacloud-cli" alt="npm version">
+    </a>
+    <img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License">
+    <img src="https://img.shields.io/badge/node-%3E%3D18-339933" alt="Node.js >= 18">
+    <img src="https://img.shields.io/badge/go-%3E%3D1.26-00ADD8" alt="Go >= 1.26">
+  </p>
+  <p>
+    <a href="./README.md">English</a>
+    ·
+    <a href="https://vtrix.ai/">SeaCloud官网</a>
+  </p>
+</div>
+
+## 功能特性
+
+- **认证登录**：支持浏览器设备码登录，并将凭证安全保存在本地。
+- **模型发现**：列出可用模型，并以可读文本或 JSON 查看完整参数规格。
+- **任务执行**：通过 CLI 提交多模态生成任务，支持参数校验和结构化输出。
+- **任务追踪**：轮询任务状态，输出结果 URL 或完整 JSON。
+- **SkillHub 集成**：搜索、安装和配置 SeaCloud SkillHub 技能。
+- **Agent 友好**：支持 `--dry-run`、JSON 输出、稳定命令结构和可直接复制的示例。
+
+## 安装
+
+### 使用 npm 安装
+
+```bash
+npm install -g @seacloudai/seacloud-cli
+```
+
+> 需要 Node.js 18+
+
+### 从源码安装
+
+默认安装方式：
+
+```bash
+git clone https://github.com/SeaCloudAI/seacloud-cli.git
+cd seacloud-cli
+make install
+```
+
+> 需要 Go 1.26+
+> 安装后的二进制会注入公开版本使用的默认服务地址。你也可以通过 `SEACLOUD_BASE_URL`、`SEACLOUD_MODELS_URL`、`SEACLOUD_GENERATION_URL`、`SEACLOUD_SKILLHUB_URL` 覆盖这些地址。
+
+如果 `/usr/local/bin` 需要更高权限：
+
+```bash
+sudo make install
+```
+
+如果你想在无 `sudo` 的情况下安装到用户目录：
+
+```bash
+make install PREFIX=$HOME/.local
+export PATH="$HOME/.local/bin:$PATH"
+```
+
+### 下载预编译二进制
+
+预编译二进制发布在 [Releases](https://github.com/SeaCloudAI/seacloud-cli/releases) 页面，当前支持：
+
+- macOS `amd64`
+- macOS `arm64`
+- Linux `amd64`
+- Linux `arm64`
+- Windows `amd64`
+
+## 快速开始
+
+### 登录认证
+
+```bash
+seacloud auth login
+seacloud auth status
+```
+
+### 查询模型
+
+```bash
+seacloud models list
+seacloud models list --type video
+seacloud models spec kirin_v2_6_i2v
+seacloud models spec kirin_v2_6_i2v --output json
+```
+
+### 执行任务
+
+```bash
+seacloud run kirin_v2_6_i2v --param image=https://example.com/cat.jpg
+seacloud run kirin_v2_6_i2v --param prompt="a cat running" --param duration=5
+seacloud run kirin_v2_6_i2v --param mode=pro --output url
+```
+
+### 查询任务状态
+
+```bash
+seacloud task status <task_id>
+seacloud task status <task_id> --output url
+seacloud task status <task_id> --output json
+```
+
+### 管理技能
+
+```bash
+seacloud skills list
+seacloud skills find prompt
+seacloud skills add some-skill
+seacloud skills config --show
+```
+
+## 命令概览
+
+### `seacloud auth`
+
+```bash
+seacloud auth login
+seacloud auth status
+seacloud auth logout
+seacloud auth set-key <api-key>
+```
+
+### `seacloud models`
+
+```bash
+seacloud models list
+seacloud models list --keywords kirin
+seacloud models list --output id
+seacloud models spec <model_id>
+seacloud models spec <model_id> --output json
+```
+
+### `seacloud run`
+
+```bash
+seacloud run <model_id> --param key=value
+seacloud run <model_id> --param prompt="hello" --param duration=5
+seacloud run <model_id> --output json
+```
+
+嵌套字段支持 dot notation：
+
+```bash
+seacloud run some_model \
+  --param camera_control.type=simple \
+  --param camera_control.speed=2
+```
+
+### `seacloud task`
+
+```bash
+seacloud task status <task_id>
+```
+
+### `seacloud skills`
+
+```bash
+seacloud skills list
+seacloud skills find [query]
+seacloud skills add <slug>
+seacloud skills config --show
+```
+
+### `seacloud version`
+
+```bash
+seacloud version
+```
+
+## 自动化与输出
+
+- 在支持的命令上使用 `--output json` 获取机器可读输出。
+- 在任务命令上使用 `--output url` 只打印结果 URL。
+- 使用全局 `--dry-run` 在不发请求的前提下检查执行内容。
+
+示例：
+
+```bash
+seacloud --dry-run run kirin_v2_6_i2v --param prompt=test
+```
+
+## 发布说明
+
+发布产物由源码构建后上传到 GitHub Releases。  
+npm 包在安装时会自动下载当前平台对应的预编译二进制。
+
+如果你需要手动维护发布流程，仓库中保留了这些文件：
+
+- `scripts/build.sh`
+- `.goreleaser.yml`
+- `scripts/set-release-version.js`
+
+## 仓库结构
+
+```text
+seacloud-cli/
+├── cmd/                 # CLI 命令定义
+├── internal/auth/       # 认证客户端与登录流程
+├── internal/models/     # 模型列表与模型规格接口
+├── internal/generation/ # 任务提交与轮询
+├── internal/skillhub/   # SkillHub 客户端与安装逻辑
+├── package.json         # npm 包清单
+├── scripts/             # 构建、发版与 npm 包装脚本
+└── skills/              # 内置技能定义
+```
+
+## 参与贡献
+
+欢迎提交 Issue 和 Pull Request。对于较大的改动，建议先开一个 Issue 讨论范围。
+
+本地验证可使用：
+
+```bash
+go test ./...
+go run . --help
+```

package/npm-bundles/SHA256SUMS

@@ -0,0 +1,5 @@
+0526a5a3d950218a9f170521d194f70fbd592d1a878eb143ad04b4c9a9e3041e  seacloud_0.0.3_darwin_amd64.tar.gz
+8c42e932084982adde59795bb9a12494688e0394142c04721179a171b6381b88  seacloud_0.0.3_darwin_arm64.tar.gz
+1cfb46f6d0c0c972749dae083ad32b8e5690c97b22bd47639d03a1af48514867  seacloud_0.0.3_linux_amd64.tar.gz
+bdcd4a2a82375c2800cd657be46702e1b32a8abf0034997cca55b0c09f3dfc33  seacloud_0.0.3_linux_arm64.tar.gz
+75a7787446c1c86ce7005b5657913f77144b9ccb03ed6c3420d66adfe8e44207  seacloud_0.0.3_windows_amd64.zip

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@seacloudai/seacloud-cli",
+  "version": "0.0.3",
+  "description": "npm installer wrapper for the SeaCloud CLI binary",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "seacloud": "scripts/seacloud.js",
+    "seacloud-skills": "scripts/seacloud-skills.js"
+  },
+  "files": [
+    "assets",
+    "npm-bundles",
+    "scripts/postinstall.js",
+    "scripts/seacloud.js",
+    "scripts/seacloud-skills.js",
+    "vendor"
+  ],
+  "scripts": {
+    "prepare:npm-bundles": "node ./scripts/prepare-npm-bundles.js",
+    "postinstall": "node ./scripts/postinstall.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "adm-zip": "^0.5.16",
+    "tar": "^7.4.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SeaCloudAI/seacloud-cli.git"
+  },
+  "seacloud": {
+    "bundledAssetsDir": "npm-bundles",
+    "projectName": "seacloud",
+    "releaseBaseUrlTemplate": "https://github.com/SeaCloudAI/seacloud-cli/releases/download/v{version}"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,284 @@
+#!/usr/bin/env node
+
+const crypto = require("crypto");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const AdmZip = require("adm-zip");
+const tar = require("tar");
+
+const rootDir = path.resolve(__dirname, "..");
+const pkg = require(path.join(rootDir, "package.json"));
+
+const bundledAssetsDir = path.join(
+  rootDir,
+  pkg.seacloud?.bundledAssetsDir || "npm-bundles"
+);
+const vendorDir = path.join(rootDir, "vendor");
+const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "seacloud-npm-"));
+
+const SUPPORTED_TARGETS = {
+  "darwin-arm64": { os: "darwin", arch: "arm64", ext: "tar.gz", bin: "seacloud" },
+  "darwin-x64": { os: "darwin", arch: "amd64", ext: "tar.gz", bin: "seacloud" },
+  "linux-arm64": { os: "linux", arch: "arm64", ext: "tar.gz", bin: "seacloud" },
+  "linux-x64": { os: "linux", arch: "amd64", ext: "tar.gz", bin: "seacloud" },
+  "win32-x64": { os: "windows", arch: "amd64", ext: "zip", bin: "seacloud.exe" }
+};
+
+async function main() {
+  try {
+    if (process.env.SEACLOUD_SKIP_POSTINSTALL === "1") {
+      log("skip postinstall because SEACLOUD_SKIP_POSTINSTALL=1");
+      return;
+    }
+
+    const target = resolveTarget();
+    const releaseSources = resolveReleaseSources();
+    const projectName = pkg.seacloud?.projectName || "seacloud";
+    const version = pkg.version;
+
+    const assetName = `${projectName}_${version}_${target.os}_${target.arch}.${target.ext}`;
+    const archivePath = path.join(tmpDir, assetName);
+    const extractDir = path.join(tmpDir, "extract");
+
+    fs.mkdirSync(vendorDir, { recursive: true });
+    fs.rmSync(vendorDir, { recursive: true, force: true });
+    fs.mkdirSync(vendorDir, { recursive: true });
+    fs.mkdirSync(extractDir, { recursive: true });
+
+    log(`downloading ${assetName}`);
+    const expectedSha = await resolveExpectedSha(releaseSources, assetName);
+    await materializeArchive(releaseSources, assetName, archivePath, expectedSha);
+
+    await extractArchive(archivePath, extractDir, target.ext);
+    const extractedBinary = findFileRecursive(extractDir, target.bin);
+    if (!extractedBinary) {
+      throw new Error(`failed to locate ${target.bin} in extracted archive`);
+    }
+
+    const finalBinary = path.join(vendorDir, target.bin);
+    fs.copyFileSync(extractedBinary, finalBinary);
+    if (process.platform !== "win32") {
+      fs.chmodSync(finalBinary, 0o755);
+    }
+
+    log(`installed ${target.bin} to vendor directory`);
+  } finally {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  }
+}
+
+function resolveTarget() {
+  const key = `${process.platform}-${process.arch}`;
+  const target = SUPPORTED_TARGETS[key];
+  if (!target) {
+    throw new Error(`unsupported platform: ${process.platform}/${process.arch}`);
+  }
+  return target;
+}
+
+function resolveReleaseBaseUrl() {
+  return resolveBaseUrl(
+    process.env.SEACLOUD_RELEASE_BASE_URL,
+    pkg.seacloud?.releaseBaseUrlTemplate,
+    "missing seacloud.releaseBaseUrlTemplate in package.json"
+  );
+}
+
+function resolveReleaseMirrorBaseUrl() {
+  return resolveBaseUrl(
+    process.env.SEACLOUD_RELEASE_MIRROR_BASE_URL,
+    pkg.seacloud?.releaseMirrorBaseUrlTemplate || null,
+    null
+  );
+}
+
+function resolveBaseUrl(fromEnv, template, missingMessage) {
+  if (fromEnv) {
+    return stripTrailingSlash(fromEnv);
+  }
+  if (!template) {
+    if (missingMessage) {
+      throw new Error(missingMessage);
+    }
+    return null;
+  }
+  return stripTrailingSlash(
+    template
+      .replaceAll("{version}", pkg.version)
+      .replaceAll("{tag}", `v${pkg.version}`)
+  );
+}
+
+function resolveReleaseSources() {
+  const sources = [
+    { name: "GitHub Release", type: "remote", baseUrl: resolveReleaseBaseUrl() }
+  ];
+  const mirrorBaseUrl = resolveReleaseMirrorBaseUrl();
+
+  if (mirrorBaseUrl && mirrorBaseUrl !== sources[0].baseUrl) {
+    sources.push({ name: "Release mirror", type: "remote", baseUrl: mirrorBaseUrl });
+  }
+
+  if (fs.existsSync(bundledAssetsDir)) {
+    sources.push({ name: "bundled npm package", type: "local", basePath: bundledAssetsDir });
+  }
+
+  return sources;
+}
+
+function getChecksumLocation(source) {
+  return source.type === "local"
+    ? path.join(source.basePath, "SHA256SUMS")
+    : `${source.baseUrl}/SHA256SUMS`;
+}
+
+function getAssetLocation(source, assetName) {
+  return source.type === "local"
+    ? path.join(source.basePath, assetName)
+    : `${source.baseUrl}/${assetName}`;
+}
+
+async function resolveExpectedSha(sources, assetName) {
+  const errors = [];
+
+  for (const source of sources) {
+    const checksumLocation = getChecksumLocation(source);
+    try {
+      const checksumText = source.type === "local"
+        ? fs.readFileSync(checksumLocation, "utf8")
+        : await fetchText(checksumLocation);
+      const expectedSha = parseChecksum(checksumText, assetName);
+      if (!expectedSha) {
+        throw new Error(`checksum for ${assetName} not found in SHA256SUMS`);
+      }
+      log(`using checksums from ${source.name}`);
+      return expectedSha;
+    } catch (err) {
+      errors.push(`${source.name}: ${err.message}`);
+    }
+  }
+
+  throw new Error(`failed to resolve checksums for ${assetName}\n${errors.join("\n")}`);
+}
+
+async function materializeArchive(sources, assetName, archivePath, expectedSha) {
+  const errors = [];
+
+  for (const source of sources) {
+    const assetLocation = getAssetLocation(source, assetName);
+    try {
+      log(`trying ${source.name}: ${assetLocation}`);
+      if (source.type === "local") {
+        fs.copyFileSync(assetLocation, archivePath);
+      } else {
+        await downloadFile(assetLocation, archivePath);
+      }
+      const actualSha = sha256File(archivePath);
+      if (actualSha !== expectedSha) {
+        throw new Error(`checksum mismatch for ${assetName}`);
+      }
+      log(`downloaded from ${source.name}`);
+      return;
+    } catch (err) {
+      fs.rmSync(archivePath, { force: true });
+      errors.push(`${source.name}: ${err.message}`);
+    }
+  }
+
+  throw new Error(`failed to obtain ${assetName}\n${errors.join("\n")}`);
+}
+
+function stripTrailingSlash(value) {
+  return value.replace(/\/+$/, "");
+}
+
+async function fetchText(url) {
+  try {
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}`);
+    }
+    return response.text();
+  } catch (err) {
+    throw new Error(`failed to download ${url}: ${err.message}`);
+  }
+}
+
+async function downloadFile(url, destination) {
+  try {
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}`);
+    }
+    const buffer = Buffer.from(await response.arrayBuffer());
+    fs.writeFileSync(destination, buffer);
+  } catch (err) {
+    throw new Error(`failed to download ${url}: ${err.message}`);
+  }
+}
+
+function parseChecksum(content, fileName) {
+  for (const line of content.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (!trimmed) {
+      continue;
+    }
+    const match = trimmed.match(/^([a-fA-F0-9]{64})\s+\*?(.+)$/);
+    if (match && path.basename(match[2]) === fileName) {
+      return match[1].toLowerCase();
+    }
+  }
+  return null;
+}
+
+function sha256File(filePath) {
+  const hash = crypto.createHash("sha256");
+  hash.update(fs.readFileSync(filePath));
+  return hash.digest("hex");
+}
+
+async function extractArchive(archivePath, destination, extension) {
+  if (extension === "zip") {
+    const zip = new AdmZip(archivePath);
+    zip.extractAllTo(destination, true);
+    return;
+  }
+  if (extension === "tar.gz") {
+    await tar.x({
+      file: archivePath,
+      cwd: destination
+    });
+    return;
+  }
+  throw new Error(`unsupported archive format: ${extension}`);
+}
+
+function findFileRecursive(dir, fileName) {
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isFile() && entry.name === fileName) {
+      return fullPath;
+    }
+    if (entry.isDirectory()) {
+      const found = findFileRecursive(fullPath, fileName);
+      if (found) {
+        return found;
+      }
+    }
+  }
+  return null;
+}
+
+function log(message) {
+  console.log(`[seacloud installer] ${message}`);
+}
+
+main().catch((err) => {
+  console.error(`[seacloud installer] ${err.message}`);
+  console.error(
+    "[seacloud installer] hint: GitHub download failed; package will fall back to bundled archives when available."
+  );
+  process.exit(1);
+});

package/scripts/seacloud-skills.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const { spawn } = require("child_process");
+
+const rootDir = path.resolve(__dirname, "..");
+const exeName = process.platform === "win32" ? "seacloud.exe" : "seacloud";
+const exePath = path.join(rootDir, "vendor", exeName);
+
+if (!fs.existsSync(exePath)) {
+  console.error("seacloud binary is not installed.");
+  console.error("Reinstall the package: npm install -g @seacloudai/seacloud-cli");
+  process.exit(1);
+}
+
+const child = spawn(exePath, ["skills", ...process.argv.slice(2)], {
+  stdio: "inherit",
+});
+
+child.on("error", (err) => {
+  console.error(`failed to start seacloud skills: ${err.message}`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 0);
+});

package/scripts/seacloud.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const { spawn } = require("child_process");
+
+const rootDir = path.resolve(__dirname, "..");
+const exeName = process.platform === "win32" ? "seacloud.exe" : "seacloud";
+const exePath = path.join(rootDir, "vendor", exeName);
+
+if (!fs.existsSync(exePath)) {
+  console.error("seacloud binary is not installed.");
+  console.error("Reinstall the package: npm install -g @seacloudai/seacloud-cli");
+  process.exit(1);
+}
+
+const child = spawn(exePath, process.argv.slice(2), {
+  stdio: "inherit",
+});
+
+child.on("error", (err) => {
+  console.error(`failed to start seacloud: ${err.message}`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 0);
+});