helloagents 1.1.0 → 2.2.7

package/bin/cli.mjs

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+
+/**
+ * HelloAGENTS npm/npx bootstrap installer.
+ *
+ * This script is ONLY for first-time setup:
+ *   npx helloagents                # install + interactive menu
+ *   npx helloagents install codex  # install + specify target
+ *
+ * After installation, use the native `helloagents` command directly
+ * for all subsequent operations (update, uninstall, status, etc.).
+ */
+
+import { execSync, spawnSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const REPO = "https://github.com/hellowind777/helloagents";
+const MIN_PYTHON = [3, 10];
+
+function findPython() {
+  for (const cmd of ["python3", "python"]) {
+    try {
+      const out = execSync(`${cmd} --version`, {
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "pipe"],
+      }).trim();
+      const match = out.match(/Python (\d+)\.(\d+)/);
+      if (match) {
+        const major = parseInt(match[1], 10);
+        const minor = parseInt(match[2], 10);
+        if (major > MIN_PYTHON[0] || (major === MIN_PYTHON[0] && minor >= MIN_PYTHON[1])) {
+          return cmd;
+        }
+      }
+    } catch {}
+  }
+  return null;
+}
+
+function detectBranch() {
+  try {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+    if (pkg.version && /beta/i.test(pkg.version)) return "beta";
+  } catch {}
+  return "main";
+}
+
+function pipInstall(python, branch) {
+  const suffix = branch && branch !== "main" ? `@${branch}` : "";
+  const url = `git+${REPO}.git${suffix}`;
+  console.log(`Installing helloagents Python package (${branch})...`);
+  const res = spawnSync(python, ["-m", "pip", "install", "--upgrade", url], {
+    stdio: "inherit",
+  });
+  if (res.status !== 0) {
+    console.error("Failed to install helloagents Python package.");
+    process.exit(1);
+  }
+}
+
+// --- Main ---
+const python = findPython();
+if (!python) {
+  console.error("Error: Python >= 3.10 not found.");
+  console.error("Please install Python first: https://www.python.org/downloads/");
+  process.exit(1);
+}
+
+const args = process.argv.slice(2);
+
+// Supported: no args (interactive menu) or "install [target]"
+if (args.length > 0 && args[0] !== "install") {
+  console.log("HelloAGENTS npx bootstrap installer");
+  console.log("");
+  console.log("Usage (first-time install only):");
+  console.log("  npx helloagents                # interactive menu");
+  console.log("  npx helloagents install codex   # specify target directly");
+  console.log("  npx helloagents install --all   # install to all detected CLIs");
+  console.log("");
+  console.log("After installation, use the native command directly:");
+  console.log("  helloagents update");
+  console.log("  helloagents uninstall <target>");
+  console.log("  helloagents status");
+  console.log("  helloagents version");
+  process.exit(0);
+}
+
+// Step 1: Install pip package
+pipInstall(python, detectBranch());
+
+// Step 2: Forward to native CLI (no args = interactive menu, install = direct install)
+const fwdArgs = args.length > 0 ? args : [];
+const res = spawnSync(python, ["-m", "helloagents", ...fwdArgs], { stdio: "inherit" });
+
+if (res.status === 0) {
+  console.log("");
+  console.log("Done! From now on, use the native command directly:");
+  console.log("  helloagents update          # update to latest version");
+  console.log("  helloagents uninstall codex # uninstall from a CLI");
+  console.log("  helloagents status          # check installation status");
+}
+
+process.exit(res.status ?? 1);

package/package.json

@@ -1,38 +1,23 @@
-{
-  "name": "helloagents",
-  "version": "1.1.0",
-  "description": "CLI tool to configure HelloAGENTS for Claude Code and Codex",
-  "bin": {
-    "helloagents": "bin/cli.js"
-  },
-  "files": [
-    "bin/",
-    "lib/",
-    "Claude/",
-    "Codex/"
-  ],
-  "scripts": {
-    "test": "node test/run.js"
-  },
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "keywords": [
-    "cli",
-    "claude",
-    "codex",
-    "ai",
-    "agents",
-    "helloagents"
-  ],
-  "author": "",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/hellowind777/helloagents.git"
-  },
-  "homepage": "https://github.com/hellowind777/helloagents#readme",
-  "bugs": {
-    "url": "https://github.com/hellowind777/helloagents/issues"
-  }
-}
+{
+  "name": "helloagents",
+  "version": "2.2.7",
+  "type": "module",
+  "description": "HelloAGENTS - AI-native sub-agent orchestration framework for multi-CLI environments",
+  "author": "HelloWind",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/hellowind777/helloagents",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hellowind777/helloagents.git"
+  },
+  "bin": {
+    "helloagents": "./bin/cli.mjs"
+  },
+  "files": [
+    "bin/"
+  ],
+  "keywords": ["ai", "agent", "claude", "codex", "gemini", "qwen", "grok", "opencode", "cli", "workflow"],
+  "engines": {
+    "node": ">=16"
+  }
+}