@renwin/ccc 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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,192 @@
+# CCC CLI - ClawHub Clone 命令行工具
+
+一个用于安装 AI Agent Skills 的命令行工具，类似于 `npx clawhub@latest install`。
+
+---
+
+## 功能特性
+
+- 📦 **安装 Skills**: 从 ClawHub registry 下载并安装 skills
+- 📋 **列表查看**: 浏览所有可用的 skills
+- 🔍 **搜索功能**: 按名称或描述搜索 skills
+- 🎨 **美观输出**: 带颜色和进度提示的终端界面
+
+---
+
+## 安装
+
+### 方式一：全局安装（推荐）
+
+```bash
+npm install -g ccc
+```
+
+### 方式二：使用 npx（无需安装）
+
+```bash
+npx ccc@latest install owner/skill-name
+```
+
+### 方式三：本地开发
+
+```bash
+git clone <repo-url>
+cd ccc-cli
+npm install
+npm link
+```
+
+---
+
+## 使用方法
+
+### 安装 Skill
+
+```bash
+# 基本用法
+ccc install owner/skill-name
+
+# 指定安装目录
+ccc install owner/skill-name --dir my-skills
+
+# 示例
+ccc install steipete/trello
+ccc install daaab/ethermail
+```
+
+安装后的文件位置：`.skills/skill-name/`
+
+### 查看所有 Skills
+
+```bash
+# 列出所有 skills
+ccc list
+
+# 搜索 skills
+ccc list --search trello
+```
+
+### 查看帮助
+
+```bash
+ccc --help
+ccc install --help
+```
+
+---
+
+## 命令详解
+
+### `ccc install <skill>`
+
+安装指定的 skill。
+
+**参数**:
+- `<skill>` - Skill 名称，格式：`owner/skill-name`
+
+**选项**:
+- `-d, --dir <directory>` - 安装目录（默认：`.skills`）
+
+**示例**:
+```bash
+ccc install steipete/trello
+ccc install daaab/ethermail --dir my-agents-skills
+```
+
+### `ccc list`
+
+列出所有可用的 skills。
+
+**选项**:
+- `-s, --search <query>` - 搜索关键词
+
+**示例**:
+```bash
+ccc list
+ccc list --search calendar
+```
+
+---
+
+## 工作原理
+
+1. **连接 API**: CLI 工具连接到 ClawHub Clone API
+2. **验证 Skill**: 检查 skill 是否存在
+3. **下载 ZIP**: 从服务器下载 skill 的 ZIP 包
+4. **解压文件**: 解压到目标目录
+5. **完成提示**: 显示安装位置和下一步操作
+
+---
+
+## 依赖
+
+- **commander** - CLI 框架
+- **chalk** - 终端颜色
+- **ora** - 加载动画
+- **adm-zip** - ZIP 解压
+- **node-fetch** - HTTP 请求
+
+---
+
+## 开发
+
+### 项目结构
+
+```
+ccc-cli/
+├── bin/
+│   └── cli.js          # CLI 入口
+├── lib/
+│   ├── install.js      # 安装逻辑
+│   └── list.js         # 列表逻辑
+├── package.json
+└── README.md
+```
+
+### 本地测试
+
+```bash
+# 安装依赖
+npm install
+
+# 链接到全局
+npm link
+
+# 测试命令
+ccc install test/skill
+```
+
+### 发布到 npm
+
+```bash
+# 登录 npm
+npm login
+
+# 发布包
+npm publish
+```
+
+---
+
+## 配置
+
+CLI 工具默认连接到本地 API (`http://localhost:3001`)。
+
+要修改 API 地址，编辑 `lib/install.js` 和 `lib/list.js` 中的 `API_BASE` 常量：
+
+```javascript
+const API_BASE = 'https://your-production-api.com/api';
+```
+
+---
+
+## 许可证
+
+MIT
+
+---
+
+## 相关项目
+
+- [ClawHub Clone](../README.md) - 主项目
+- [ClawHub.ai](https://clawhub.ai/) - 原始项目

package/bin/cli.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { installSkill } from '../lib/install.js';
+import { listSkills } from '../lib/list.js';
+
+const program = new Command();
+
+program
+    .name('ccc')
+    .description('ClawHub Clone CLI - Install AI agent skills')
+    .version('1.0.0');
+
+// Install command
+program
+    .command('install <skill>')
+    .description('Install a skill from ClawHub registry')
+    .option('-d, --dir <directory>', 'Installation directory', '.skills')
+    .action(async (skill, options) => {
+        try {
+            await installSkill(skill, options.dir);
+        } catch (error) {
+            console.error(chalk.red('✗ Error:'), error.message);
+            process.exit(1);
+        }
+    });
+
+// List command
+program
+    .command('list')
+    .description('List all available skills')
+    .option('-s, --search <query>', 'Search skills')
+    .action(async (options) => {
+        try {
+            await listSkills(options.search);
+        } catch (error) {
+            console.error(chalk.red('✗ Error:'), error.message);
+            process.exit(1);
+        }
+    });
+
+program.parse(process.argv);

package/lib/config.js

@@ -0,0 +1,28 @@
+/**
+ * Configuration file for CCC CLI
+ * Centralized API and environment settings
+ */
+
+export const config = {
+    // API Base URL
+    // Production
+    apiBase: process.env.CCC_API_BASE || 'https://www.ccc.onl/api',
+
+    // Development (uncomment to use local API)
+    // apiBase: 'http://localhost:3001/api',
+
+    // Installation directory
+    defaultDir: '.skills',
+
+    // Network settings
+    timeout: 30000, // 30 seconds
+
+    // Version
+    version: '1.0.1'
+};
+
+/**
+ * Environment detection
+ */
+export const isDevelopment = process.env.NODE_ENV === 'development';
+export const isProduction = process.env.NODE_ENV === 'production';

package/lib/install.js

@@ -0,0 +1,99 @@
+import fetch from 'node-fetch';
+
+// Production API
+const API_BASE = 'https://www.ccc.onl/api';
+
+// Development API (uncomment for local testing)
+// const API_BASE = 'http://localhost:3001/api';
+
+/**
+ * Install a skill from ClawHub registry
+ * @param {string} skillName - Format: owner/slug
+ * @param {string} targetDir - Installation directory
+ */
+export async function installSkill(skillName, targetDir = '.skills') {
+    // Parse skill name
+    const [owner, slug] = skillName.split('/');
+    if (!owner || !slug) {
+        throw new Error('Invalid skill name. Use format: owner/skill-name');
+    }
+
+    const spinner = ora(`Installing ${chalk.cyan(skillName)}...`).start();
+
+    try {
+        // Step 1: Verify skill exists
+        spinner.text = 'Verifying skill...';
+        const skillData = await fetchSkillData(owner, slug);
+
+        if (!skillData) {
+            spinner.fail(`Skill ${chalk.cyan(skillName)} not found`);
+            throw new Error('Skill not found in registry');
+        }
+
+        // Step 2: Download skill ZIP
+        spinner.text = 'Downloading skill files...';
+        const zipBuffer = await downloadSkillZip(owner, slug);
+
+        // Step 3: Extract to target directory
+        spinner.text = 'Extracting files...';
+        const skillPath = path.join(process.cwd(), targetDir, slug);
+        await extractSkill(zipBuffer, skillPath);
+
+        // Step 4: Success
+        spinner.succeed(chalk.green(`✓ Successfully installed ${chalk.cyan(skillName)}`));
+
+        console.log();
+        console.log(chalk.gray(`  Location: ${skillPath}`));
+        console.log(chalk.gray(`  Version:  ${skillData.version || 'N/A'}`));
+        console.log();
+        console.log(chalk.yellow('  Next steps:'));
+        console.log(chalk.gray(`    cd ${path.join(targetDir, slug)}`));
+        console.log(chalk.gray(`    cat SKILL.md`));
+
+    } catch (error) {
+        spinner.fail(chalk.red(`Failed to install ${skillName}`));
+        throw error;
+    }
+}
+
+/**
+ * Fetch skill metadata from API
+ */
+async function fetchSkillData(owner, slug) {
+    const response = await fetch(`${API_BASE}/skills/${owner}/${slug}`);
+
+    if (!response.ok) {
+        if (response.status === 404) {
+            return null;
+        }
+        throw new Error(`API error: ${response.statusText}`);
+    }
+
+    const data = await response.json();
+    return data.skill;
+}
+
+/**
+ * Download skill ZIP from API
+ */
+async function downloadSkillZip(owner, slug) {
+    const response = await fetch(`${API_BASE}/skills/${owner}/${slug}/download`);
+
+    if (!response.ok) {
+        throw new Error(`Download failed: ${response.statusText}`);
+    }
+
+    return Buffer.from(await response.arrayBuffer());
+}
+
+/**
+ * Extract ZIP to target directory
+ */
+async function extractSkill(zipBuffer, targetPath) {
+    // Create target directory
+    await fs.mkdir(targetPath, { recursive: true });
+
+    // Extract ZIP
+    const zip = new AdmZip(zipBuffer);
+    zip.extractAllTo(targetPath, true);
+}

package/lib/list.js

@@ -0,0 +1,58 @@
+import chalk from 'chalk';
+import fetch from 'node-fetch';
+
+// Production API
+const API_BASE = 'https://www.ccc.onl/api';
+
+// Development API (uncomment for local testing)
+// const API_BASE = 'http://localhost:3001/api';
+
+/**
+ * List all available skills
+ * @param {string} searchQuery - Optional search query
+ */
+export async function listSkills(searchQuery) {
+    try {
+        // Fetch skills from API
+        const url = searchQuery
+            ? `${API_BASE}/skills?search=${encodeURIComponent(searchQuery)}`
+            : `${API_BASE}/skills`;
+
+        const response = await fetch(url);
+
+        if (!response.ok) {
+            throw new Error(`API error: ${response.statusText}`);
+        }
+
+        const data = await response.json();
+        const skills = data.skills || [];
+
+        if (skills.length === 0) {
+            console.log(chalk.yellow('No skills found'));
+            return;
+        }
+
+        // Display header
+        console.log();
+        console.log(chalk.bold(`Found ${skills.length} skill(s):`));
+        console.log();
+
+        // Display skills
+        skills.forEach(skill => {
+            const name = chalk.cyan(`${skill.owner}/${skill.slug}`);
+            const version = skill.version ? chalk.gray(`v${skill.version}`) : '';
+            const desc = chalk.gray(skill.description || 'No description');
+
+            console.log(`  ${name} ${version}`);
+            console.log(`    ${desc}`);
+            console.log();
+        });
+
+        // Display install hint
+        console.log(chalk.gray('To install: ccc install owner/skill-name'));
+        console.log();
+
+    } catch (error) {
+        throw new Error(`Failed to list skills: ${error.message}`);
+    }
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+    "name": "@renwin/ccc",
+    "version": "1.0.1",
+    "description": "CLI tool for installing ClawHub skills",
+    "type": "module",
+    "main": "index.js",
+    "bin": {
+        "ccc": "./bin/cli.js"
+    },
+    "scripts": {
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "keywords": [
+        "clawhub",
+        "ai",
+        "skills",
+        "cli",
+        "agent"
+    ],
+    "author": "",
+    "license": "MIT",
+    "dependencies": {
+        "commander": "^11.1.0",
+        "node-fetch": "^3.3.2",
+        "adm-zip": "^0.5.10",
+        "chalk": "^5.3.0",
+        "ora": "^8.0.1"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    }
+}