@huajiwuyan/hello 3.0.0

package/README.md

@@ -0,0 +1,68 @@
+# @huajiwuyan/hello
+
+HelloAGENTS 交互式安装器 - 支持 Claude Code 和 Codex CLI。
+
+## 安装
+
+```bash
+# 使用 npx 一次性运行（推荐）
+npx @huajiwuyan/hello
+
+# 或全局安装
+npm install -g @huajiwuyan/hello
+hello
+```
+
+## 使用
+
+### 交互式安装
+
+```bash
+npx @huajiwuyan/hello
+```
+
+运行后会引导你：
+1. 选择要安装的 CLI（Claude Code / Codex CLI / 两者）
+2. 选择是否自定义安装路径
+3. 处理已存在的安装（覆盖/跳过/取消）
+
+### 卸载
+
+```bash
+npx @huajiwuyan/hello -u
+# 或
+npx @huajiwuyan/hello --uninstall
+```
+
+### 帮助
+
+```bash
+npx @huajiwuyan/hello -h
+```
+
+## 默认安装位置
+
+| CLI | 默认路径 |
+|-----|----------|
+| Claude Code | `~/.claude` |
+| Codex CLI | `~/.codex` |
+
+安装内容：
+- `skills/helloagents/` - HelloAGENTS 技能模块
+- `commands/hello.md`（Claude）或 `prompts/hello.md`（Codex）- 命令入口
+
+## 安装后使用
+
+**Claude Code:**
+```
+/hello
+```
+
+**Codex CLI:**
+```
+~hello
+```
+
+## 许可证
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,448 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { parseArgs } from "util";
+
+// src/installer.ts
+import { join as join2, dirname as dirname2 } from "path";
+import { fileURLToPath } from "url";
+import * as p2 from "@clack/prompts";
+
+// src/constants.ts
+import { homedir } from "os";
+import { join } from "path";
+var CLI_CONFIGS = {
+  claude: {
+    name: "Claude Code",
+    defaultPath: join(homedir(), ".claude"),
+    skillsDir: "skills/helloagents",
+    commandDir: "commands",
+    commandFile: "hello.md"
+  },
+  codex: {
+    name: "Codex CLI",
+    defaultPath: join(homedir(), ".codex"),
+    skillsDir: "skills/helloagents",
+    commandDir: "prompts",
+    commandFile: "hello.md"
+  }
+};
+function getDefaultPaths(cli) {
+  const paths = {};
+  if (cli === "claude" || cli === "both") {
+    paths.claude = CLI_CONFIGS.claude.defaultPath;
+  }
+  if (cli === "codex" || cli === "both") {
+    paths.codex = CLI_CONFIGS.codex.defaultPath;
+  }
+  return paths;
+}
+
+// src/utils/fs.ts
+import { existsSync, mkdirSync, cpSync, rmSync, readdirSync, statSync } from "fs";
+import { dirname } from "path";
+function ensureDir(dirPath) {
+  if (!existsSync(dirPath)) {
+    mkdirSync(dirPath, { recursive: true });
+  }
+}
+function copyDir(src, dest) {
+  ensureDir(dirname(dest));
+  cpSync(src, dest, { recursive: true });
+}
+function copyFile(src, dest) {
+  ensureDir(dirname(dest));
+  cpSync(src, dest);
+}
+function remove(targetPath) {
+  if (existsSync(targetPath)) {
+    rmSync(targetPath, { recursive: true, force: true });
+  }
+}
+function exists(targetPath) {
+  return existsSync(targetPath);
+}
+
+// src/prompts.ts
+import * as p from "@clack/prompts";
+
+// src/utils/platform.ts
+import { homedir as homedir2 } from "os";
+function expandHome(inputPath) {
+  if (inputPath.startsWith("~")) {
+    return inputPath.replace("~", homedir2());
+  }
+  return inputPath;
+}
+
+// src/prompts.ts
+async function askInstallOptions() {
+  p.intro("\u{1F680} HelloAGENTS \u5B89\u88C5\u5668");
+  const cli = await p.select({
+    message: "\u9009\u62E9\u8981\u5B89\u88C5\u7684 CLI",
+    options: [
+      { value: "claude", label: "Claude Code", hint: "~/.claude" },
+      { value: "codex", label: "Codex CLI", hint: "~/.codex" },
+      { value: "both", label: "\u4E24\u8005\u90FD\u5B89\u88C5" }
+    ]
+  });
+  if (p.isCancel(cli)) {
+    p.cancel("\u5B89\u88C5\u5DF2\u53D6\u6D88");
+    return null;
+  }
+  const customPath = await p.confirm({
+    message: "\u662F\u5426\u81EA\u5B9A\u4E49\u5B89\u88C5\u8DEF\u5F84\uFF1F",
+    initialValue: false
+  });
+  if (p.isCancel(customPath)) {
+    p.cancel("\u5B89\u88C5\u5DF2\u53D6\u6D88");
+    return null;
+  }
+  let paths = getDefaultPaths(cli);
+  if (customPath) {
+    const customPaths = await askCustomPaths(cli);
+    if (!customPaths) return null;
+    paths = customPaths;
+  }
+  const existingPaths = checkExistingInstall(cli, paths);
+  if (existingPaths.length > 0) {
+    const overwrite = await p.select({
+      message: "\u68C0\u6D4B\u5230\u5DF2\u5B89\u88C5\u7684 HelloAGENTS",
+      options: [
+        { value: "overwrite", label: "\u8986\u76D6\u73B0\u6709\u6587\u4EF6" },
+        { value: "skip", label: "\u8DF3\u8FC7\u5DF2\u5B58\u5728\u7684\u6587\u4EF6" },
+        { value: "cancel", label: "\u53D6\u6D88\u5B89\u88C5" }
+      ]
+    });
+    if (p.isCancel(overwrite) || overwrite === "cancel") {
+      p.cancel("\u5B89\u88C5\u5DF2\u53D6\u6D88");
+      return null;
+    }
+    if (overwrite === "skip") {
+      for (const existing of existingPaths) {
+        if (existing === "claude") paths.claude = void 0;
+        if (existing === "codex") paths.codex = void 0;
+      }
+    }
+  }
+  return { cli, paths };
+}
+async function askCustomPaths(cli) {
+  const paths = {};
+  if (cli === "claude" || cli === "both") {
+    const claudePath = await p.text({
+      message: "Claude Code \u5B89\u88C5\u8DEF\u5F84",
+      placeholder: CLI_CONFIGS.claude.defaultPath,
+      defaultValue: CLI_CONFIGS.claude.defaultPath,
+      validate: (value) => {
+        if (!value) return "\u8BF7\u8F93\u5165\u8DEF\u5F84";
+        return void 0;
+      }
+    });
+    if (p.isCancel(claudePath)) {
+      p.cancel("\u5B89\u88C5\u5DF2\u53D6\u6D88");
+      return null;
+    }
+    paths.claude = expandHome(claudePath);
+  }
+  if (cli === "codex" || cli === "both") {
+    const codexPath = await p.text({
+      message: "Codex CLI \u5B89\u88C5\u8DEF\u5F84",
+      placeholder: CLI_CONFIGS.codex.defaultPath,
+      defaultValue: CLI_CONFIGS.codex.defaultPath,
+      validate: (value) => {
+        if (!value) return "\u8BF7\u8F93\u5165\u8DEF\u5F84";
+        return void 0;
+      }
+    });
+    if (p.isCancel(codexPath)) {
+      p.cancel("\u5B89\u88C5\u5DF2\u53D6\u6D88");
+      return null;
+    }
+    paths.codex = expandHome(codexPath);
+  }
+  return paths;
+}
+function checkExistingInstall(cli, paths) {
+  const existing = [];
+  if ((cli === "claude" || cli === "both") && paths.claude) {
+    const skillsPath = `${paths.claude}/${CLI_CONFIGS.claude.skillsDir}`;
+    if (exists(skillsPath)) existing.push("claude");
+  }
+  if ((cli === "codex" || cli === "both") && paths.codex) {
+    const skillsPath = `${paths.codex}/${CLI_CONFIGS.codex.skillsDir}`;
+    if (exists(skillsPath)) existing.push("codex");
+  }
+  return existing;
+}
+async function askUninstallOptions() {
+  p.intro("\u{1F5D1}\uFE0F  HelloAGENTS \u5378\u8F7D\u5668");
+  const installed = [];
+  const claudePath = CLI_CONFIGS.claude.defaultPath;
+  const codexPath = CLI_CONFIGS.codex.defaultPath;
+  const claudeInstalled = exists(`${claudePath}/${CLI_CONFIGS.claude.skillsDir}`);
+  const codexInstalled = exists(`${codexPath}/${CLI_CONFIGS.codex.skillsDir}`);
+  if (claudeInstalled) installed.push({ value: "claude", label: "Claude Code" });
+  if (codexInstalled) installed.push({ value: "codex", label: "Codex CLI" });
+  if (installed.length === 0) {
+    p.log.warning("\u672A\u68C0\u6D4B\u5230\u5DF2\u5B89\u88C5\u7684 HelloAGENTS");
+    p.outro("\u65E0\u9700\u5378\u8F7D");
+    return null;
+  }
+  if (installed.length === 2) {
+    installed.push({ value: "both", label: "\u4E24\u8005\u90FD\u5378\u8F7D" });
+  }
+  const cli = await p.select({
+    message: "\u9009\u62E9\u8981\u5378\u8F7D\u7684 CLI",
+    options: installed
+  });
+  if (p.isCancel(cli)) {
+    p.cancel("\u5378\u8F7D\u5DF2\u53D6\u6D88");
+    return null;
+  }
+  const toDelete = [];
+  const paths = {};
+  if (cli === "claude" || cli === "both") {
+    paths.claude = claudePath;
+    toDelete.push(`${claudePath}/${CLI_CONFIGS.claude.skillsDir}`);
+    toDelete.push(`${claudePath}/${CLI_CONFIGS.claude.commandDir}/${CLI_CONFIGS.claude.commandFile}`);
+  }
+  if (cli === "codex" || cli === "both") {
+    paths.codex = codexPath;
+    toDelete.push(`${codexPath}/${CLI_CONFIGS.codex.skillsDir}`);
+    toDelete.push(`${codexPath}/${CLI_CONFIGS.codex.commandDir}/${CLI_CONFIGS.codex.commandFile}`);
+  }
+  p.log.info("\u5C06\u5220\u9664\u4EE5\u4E0B\u6587\u4EF6:");
+  for (const file of toDelete) {
+    p.log.message(`  - ${file}`);
+  }
+  const confirm2 = await p.confirm({
+    message: "\u786E\u8BA4\u5378\u8F7D\uFF1F",
+    initialValue: false
+  });
+  if (p.isCancel(confirm2) || !confirm2) {
+    p.cancel("\u5378\u8F7D\u5DF2\u53D6\u6D88");
+    return null;
+  }
+  return { cli, paths };
+}
+
+// src/installer.ts
+var __dirname2 = dirname2(fileURLToPath(import.meta.url));
+var templatesDir = join2(__dirname2, "..", "templates");
+function installCLI(cliType, basePath, result) {
+  const config = CLI_CONFIGS[cliType];
+  const templatePath = join2(templatesDir, cliType);
+  const skillsSrc = join2(templatePath, "skills", "helloagents");
+  const skillsDest = join2(basePath, config.skillsDir);
+  try {
+    if (exists(skillsSrc)) {
+      copyDir(skillsSrc, skillsDest);
+      result.installed.push(skillsDest);
+    } else {
+      result.errors.push(`Skills \u6A21\u677F\u4E0D\u5B58\u5728: ${skillsSrc}`);
+    }
+  } catch (error) {
+    result.errors.push(`\u590D\u5236 skills \u5931\u8D25: ${error.message}`);
+  }
+  const commandSrc = join2(templatePath, config.commandDir, config.commandFile);
+  const commandDest = join2(basePath, config.commandDir, config.commandFile);
+  try {
+    if (exists(commandSrc)) {
+      ensureDir(dirname2(commandDest));
+      copyFile(commandSrc, commandDest);
+      result.installed.push(commandDest);
+    } else {
+      result.errors.push(`\u547D\u4EE4\u6A21\u677F\u4E0D\u5B58\u5728: ${commandSrc}`);
+    }
+  } catch (error) {
+    result.errors.push(`\u590D\u5236\u547D\u4EE4\u6587\u4EF6\u5931\u8D25: ${error.message}`);
+  }
+}
+async function install(config) {
+  const result = {
+    success: true,
+    installed: [],
+    skipped: [],
+    errors: []
+  };
+  const s = p2.spinner();
+  s.start("\u5B89\u88C5\u4E2D...");
+  try {
+    if (config.paths.claude) {
+      installCLI("claude", config.paths.claude, result);
+    }
+    if (config.paths.codex) {
+      installCLI("codex", config.paths.codex, result);
+    }
+    if (result.errors.length > 0) {
+      result.success = false;
+    }
+  } catch (error) {
+    result.success = false;
+    result.errors.push(error.message);
+  }
+  s.stop(result.success ? "\u5B89\u88C5\u5B8C\u6210" : "\u5B89\u88C5\u8FC7\u7A0B\u4E2D\u51FA\u73B0\u9519\u8BEF");
+  return result;
+}
+async function runInstaller() {
+  try {
+    const config = await askInstallOptions();
+    if (!config) {
+      process.exit(0);
+    }
+    const result = await install(config);
+    if (result.installed.length > 0) {
+      p2.log.success("\u5DF2\u5B89\u88C5:");
+      for (const file of result.installed) {
+        p2.log.message(`  \u2713 ${file}`);
+      }
+    }
+    if (result.skipped.length > 0) {
+      p2.log.warning("\u5DF2\u8DF3\u8FC7:");
+      for (const file of result.skipped) {
+        p2.log.message(`  - ${file}`);
+      }
+    }
+    if (result.errors.length > 0) {
+      p2.log.error("\u9519\u8BEF:");
+      for (const error of result.errors) {
+        p2.log.message(`  \u2717 ${error}`);
+      }
+    }
+    if (result.success) {
+      p2.outro("\u2705 \u5B89\u88C5\u5B8C\u6210\uFF01\u4F7F\u7528 /hello \u542F\u52A8");
+    } else {
+      p2.outro("\u26A0\uFE0F \u5B89\u88C5\u5B8C\u6210\uFF0C\u4F46\u5B58\u5728\u9519\u8BEF");
+      process.exit(1);
+    }
+  } catch (error) {
+    if (error.code === "EACCES") {
+      p2.log.error("\u6743\u9650\u4E0D\u8DB3\uFF0C\u8BF7\u68C0\u67E5\u76EE\u5F55\u6743\u9650\u6216\u4F7F\u7528 sudo");
+    } else if (error.code === "ENOSPC") {
+      p2.log.error("\u78C1\u76D8\u7A7A\u95F4\u4E0D\u8DB3");
+    } else {
+      p2.log.error(`\u5B89\u88C5\u5931\u8D25: ${error.message}`);
+    }
+    process.exit(1);
+  }
+}
+
+// src/uninstaller.ts
+import * as p3 from "@clack/prompts";
+function uninstallCLI(cliType, basePath, deleted, errors) {
+  const config = CLI_CONFIGS[cliType];
+  const skillsPath = `${basePath}/${config.skillsDir}`;
+  try {
+    if (exists(skillsPath)) {
+      remove(skillsPath);
+      deleted.push(skillsPath);
+    }
+  } catch (error) {
+    errors.push(`\u5220\u9664 skills \u5931\u8D25: ${error.message}`);
+  }
+  const commandPath = `${basePath}/${config.commandDir}/${config.commandFile}`;
+  try {
+    if (exists(commandPath)) {
+      remove(commandPath);
+      deleted.push(commandPath);
+    }
+  } catch (error) {
+    errors.push(`\u5220\u9664\u547D\u4EE4\u6587\u4EF6\u5931\u8D25: ${error.message}`);
+  }
+}
+async function uninstall(config) {
+  const deleted = [];
+  const errors = [];
+  const s = p3.spinner();
+  s.start("\u5378\u8F7D\u4E2D...");
+  try {
+    if (config.paths.claude) {
+      uninstallCLI("claude", config.paths.claude, deleted, errors);
+    }
+    if (config.paths.codex) {
+      uninstallCLI("codex", config.paths.codex, deleted, errors);
+    }
+  } catch (error) {
+    errors.push(error.message);
+  }
+  s.stop(errors.length === 0 ? "\u5378\u8F7D\u5B8C\u6210" : "\u5378\u8F7D\u8FC7\u7A0B\u4E2D\u51FA\u73B0\u9519\u8BEF");
+  return { deleted, errors };
+}
+async function runUninstaller() {
+  try {
+    const config = await askUninstallOptions();
+    if (!config) {
+      process.exit(0);
+    }
+    const { deleted, errors } = await uninstall(config);
+    if (deleted.length > 0) {
+      p3.log.success("\u5DF2\u5220\u9664:");
+      for (const file of deleted) {
+        p3.log.message(`  \u2713 ${file}`);
+      }
+    }
+    if (errors.length > 0) {
+      p3.log.error("\u9519\u8BEF:");
+      for (const error of errors) {
+        p3.log.message(`  \u2717 ${error}`);
+      }
+    }
+    if (errors.length === 0) {
+      p3.outro("\u2705 \u5378\u8F7D\u5B8C\u6210");
+    } else {
+      p3.outro("\u26A0\uFE0F \u5378\u8F7D\u5B8C\u6210\uFF0C\u4F46\u5B58\u5728\u9519\u8BEF");
+      process.exit(1);
+    }
+  } catch (error) {
+    if (error.code === "EACCES") {
+      p3.log.error("\u6743\u9650\u4E0D\u8DB3\uFF0C\u8BF7\u68C0\u67E5\u76EE\u5F55\u6743\u9650\u6216\u4F7F\u7528 sudo");
+    } else {
+      p3.log.error(`\u5378\u8F7D\u5931\u8D25: ${error.message}`);
+    }
+    process.exit(1);
+  }
+}
+
+// src/index.ts
+function showHelp() {
+  console.log(`
+\u{1F680} HelloAGENTS \u5B89\u88C5\u5668
+
+\u7528\u6CD5:
+  npx @huajiwuyan/hello          \u4EA4\u4E92\u5F0F\u5B89\u88C5
+  npx @huajiwuyan/hello -u       \u5378\u8F7D
+  npx @huajiwuyan/hello -h       \u663E\u793A\u5E2E\u52A9
+
+\u9009\u9879:
+  -u, --uninstall    \u5378\u8F7D HelloAGENTS
+  -h, --help         \u663E\u793A\u5E2E\u52A9\u4FE1\u606F
+
+\u652F\u6301\u7684 CLI:
+  - Claude Code (~/.claude)
+  - Codex CLI (~/.codex)
+`);
+}
+async function main() {
+  try {
+    const { values } = parseArgs({
+      options: {
+        uninstall: { type: "boolean", short: "u" },
+        help: { type: "boolean", short: "h" }
+      }
+    });
+    if (values.help) {
+      showHelp();
+      process.exit(0);
+    }
+    if (values.uninstall) {
+      await runUninstaller();
+    } else {
+      await runInstaller();
+    }
+  } catch (error) {
+    console.error("\u9519\u8BEF:", error.message);
+    process.exit(1);
+  }
+}
+main();

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@huajiwuyan/hello",
+  "version": "3.0.0",
+  "description": "HelloAGENTS 交互式安装器 - 支持 Claude Code 和 Codex CLI",
+  "type": "module",
+  "bin": {
+    "hello": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "helloagents",
+    "claude",
+    "codex",
+    "cli",
+    "installer"
+  ],
+  "author": "huajiwuyan",
+  "license": "MIT",
+  "dependencies": {
+    "@clack/prompts": "^0.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.1.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}