@chesterzhao/mini-agent 0.2.0

package/README.md

@@ -0,0 +1,16 @@
+# @chesterzhao/mini-agent
+
+终端里的编码 Agent：配置驱动，支持 OpenAI Chat / Responses 与 Anthropic 协议、MCP、Agent Skills。
+
+这个 npm 包只是启动器，实际运行的是 PyPI 上同版本的 [`mini-agent-cli`](https://pypi.org/project/mini-agent-cli/)，
+由 [uv](https://docs.astral.sh/uv/) 自动准备 Python 3.13 和依赖。
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh   # 没有 uv 的话先装
+npm i -g @chesterzhao/mini-agent
+mini-agent                                        # 首次运行生成 ~/.config/mini-agent/mini-agent.json
+```
+
+不用 npm 也可以：`uv tool install mini-agent-cli` 或 `uvx --from mini-agent-cli mini-agent`。
+
+完整文档：https://github.com/zhaomo08/mini-agent

package/bin/mini-agent.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+// npm 入口只是个启动器：用 uvx 跑 PyPI 上同版本的 mini-agent-cli（命令名 mini-agent）。
+// uv 会自己准备 Python 3.13 和依赖，首次运行稍慢，之后走缓存。
+// MINI_AGENT_SPEC 可以覆盖要跑的包（本地 wheel 路径、git 地址），测试用。
+
+const { spawnSync } = require("node:child_process");
+const { existsSync } = require("node:fs");
+const { homedir } = require("node:os");
+const { join } = require("node:path");
+const { version } = require("../package.json");
+
+function findUvx() {
+  const candidates = [
+    process.env.UV_INSTALL_DIR && join(process.env.UV_INSTALL_DIR, "uvx"),
+    join(homedir(), ".local", "bin", "uvx"),
+    join(homedir(), ".cargo", "bin", "uvx"),
+    "/opt/homebrew/bin/uvx",
+    "/usr/local/bin/uvx",
+  ].filter(Boolean);
+  const probe = spawnSync("uvx", ["--version"], { stdio: "ignore" });
+  if (probe.status === 0) return "uvx";
+  return candidates.find((p) => existsSync(p));
+}
+
+const uvx = findUvx();
+if (!uvx) {
+  console.error(
+    "mini-agent 需要 uv（Python 包管理器，会自动准备 Python 3.13）。安装：\n" +
+      "  curl -LsSf https://astral.sh/uv/install.sh | sh\n" +
+      "  或 brew install uv\n" +
+      "装好后重新运行 mini-agent。",
+  );
+  process.exit(1);
+}
+
+const spec = process.env.MINI_AGENT_SPEC || `mini-agent-cli==${version}`;
+// Ctrl+C 由终端直接发给子进程（同一进程组），Node 这边忽略，等子进程自己收尾
+process.on("SIGINT", () => {});
+const result = spawnSync(uvx, ["--quiet", "--from", spec, "mini-agent", ...process.argv.slice(2)], {
+  stdio: "inherit",
+});
+if (result.error) {
+  console.error(`启动失败：${result.error.message}`);
+  process.exit(1);
+}
+process.exit(result.status ?? (result.signal ? 1 : 0));

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@chesterzhao/mini-agent",
+  "version": "0.2.0",
+  "description": "终端里的编码 Agent：配置驱动，支持 OpenAI Chat / Responses 与 Anthropic 协议、MCP、Agent Skills（通过 uv 运行 PyPI 上的 mini-agent）",
+  "bin": {
+    "mini-agent": "bin/mini-agent.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "keywords": ["agent", "llm", "mcp", "cli", "coding-agent", "skills"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhaomo08/mini-agent.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}