ronds_ai 0.1.6 → 0.1.8

package/README.md

@@ -0,0 +1,289 @@
+# ronds_ai
+
+`ronds_ai` 是一个命令行工具，主要用于两类事情：
+
+- 接收 Claude / Cursor 的 hook 事件，整理成统一的代码变更事件并上报
+- 帮助项目写入对应的 hook 配置，以及安装 Skills 到 Claude / Codex / Cursor
+
+## Requirements
+
+- Node.js `>=16`
+- `git`
+- `unzip`
+
+`git` 主要用于读取仓库信息和用户邮箱；`unzip` 用于 `skills install` 解压技能包。
+
+## Install
+
+按一次性执行使用：
+
+```bash
+npx ronds_ai@latest <command>
+```
+
+或全局安装：
+
+```bash
+npm install -g ronds_ai
+ronds_ai <command>
+```
+
+## Commands
+
+### `check record`
+
+检查 `record` 命令运行所需的基础环境。
+
+```bash
+ronds_ai check record
+```
+
+示例：
+
+```bash
+npx ronds_ai@latest check record
+```
+
+当前会检查并输出：
+
+- 当前 Node 版本
+- Node 是否满足 `>=16`
+- 当前目录下读取到的 `git user.email`
+- 当前 `worker_id` 配置来源和取值
+- `~/.profile` 路径
+
+输出是一个 JSON，例如：
+
+```json
+{
+  "ok": true,
+  "targetDir": "/path/to/project",
+  "node": {
+    "version": "v20.19.0",
+    "requirement": ">=16",
+    "satisfied": true
+  },
+  "gitUserEmail": "name@example.com",
+  "workerId": {
+    "name": "MCP_TRACKER_WORKER_ID",
+    "value": "worker-123",
+    "source": "env"
+  },
+  "profileFile": "/Users/you/.profile"
+}
+```
+
+如果 Node 版本不满足要求，命令会返回非 0 退出码。
+
+### `record`
+
+从标准输入读取 Claude 或 Cursor 的 hook payload，转换为统一事件后发送到服务端。
+
+```bash
+ronds_ai record <tool>
+```
+
+支持的 `tool`：
+
+- `claude`
+- `cursor`
+
+示例：
+
+```bash
+npx ronds_ai@latest record claude
+npx ronds_ai@latest record cursor
+```
+
+这个命令通常不是手工执行，而是被 Claude / Cursor 的 hook 配置调用。
+
+行为说明：
+
+- 从 `stdin` 读取一段 JSON
+- 根据来源提取文件路径、变更内容、增删行数、仓库信息、worker_id
+- 组装事件后通过 HTTP POST 上报
+- 成功时输出一行 JSON
+- 失败时会把事件写入本地失败日志，并输出保存位置
+
+成功输出示例：
+
+```json
+{"status":"sent","event_id":"...","response_status":200}
+```
+
+`dry-run` 输出示例：
+
+```json
+{"status":"dry-run","event_id":"...","response_status":0}
+```
+
+失败保存输出示例：
+
+```json
+{"status":"saved","event_id":"...","saved_path":"/Users/you/.ronds_ai/failed-events/20260409-claude-error.jsonl"}
+```
+
+目前支持的 hook 事件：
+
+- Claude: `PostToolUse`
+- Cursor: `afterFileEdit`
+
+其中 Claude 仅处理这些工具产生的事件：
+
+- `Write`
+- `Edit`
+- `MultiEdit`
+
+### `doctor`
+
+检查当前目录下的 hook 配置和最近错误日志，方便排查接入问题。
+
+```bash
+ronds_ai doctor <tool>
+```
+
+支持的 `tool`：
+
+- `claude`
+- `cursor`
+
+示例：
+
+```bash
+npx ronds_ai@latest doctor claude
+npx ronds_ai@latest doctor cursor
+```
+
+输出内容包括：
+
+- 当前检查的工具类型
+- 当前目标目录
+- 当前目录下的 `git user.email`
+- 关键配置文件是否存在
+- 今天的最近错误日志内容
+
+Claude 会检查：
+
+- `.claude/settings.json`
+- `.claude/settings.local.json`
+
+Cursor 会检查：
+
+- `.cursor/hooks.json`
+
+### `hooks deploy`
+
+在当前项目目录生成或更新 Claude / Cursor 的 hook 配置。
+
+```bash
+ronds_ai hooks deploy
+```
+
+示例：
+
+```bash
+npx ronds_ai@latest hooks deploy
+```
+
+这个命令会做的事情：
+
+- 在 `.cursor/hooks.json` 中确保存在 `npx ronds_ai@latest record cursor`
+- 在 `.claude/settings.json` 中确保存在 `npx ronds_ai@latest record claude`
+- 清理旧版 hook 脚本文件
+- 如果存在 `.claude/settings.local.json`，会移除其中由本工具管理的旧 hook，避免重复触发
+
+输出是一个 JSON，对应本次操作中：
+
+- `createdFiles`
+- `updatedFiles`
+- `removedFiles`
+
+### `skills install`
+
+下载一个技能包并安装到 Claude / Codex / Cursor 对应的技能目录。
+
+```bash
+ronds_ai skills install <name> [--tool claude,codex,cursor] [--scope project|global] [--project-dir <path>] [--force]
+```
+
+示例：
+
+```bash
+npx ronds_ai@latest skills install demo-skill
+npx ronds_ai@latest skills install demo-skill --tool claude --scope global
+npx ronds_ai@latest skills install demo-skill --tool codex,cursor --scope project
+```
+
+参数说明：
+
+- `name`: 要安装的 skill 名称
+- `--tool`: 目标工具，可传 `claude`、`codex`、`cursor`，多个值用逗号分隔
+- `--scope`: 安装范围，可选 `project` 或 `global`
+- `--project-dir`: 当 `scope=project` 时指定项目目录；默认是当前目录
+- `--force`: 目标目录已存在时覆盖
+
+如果没有传 `--tool` 或 `--scope`，CLI 会进入交互式提示。
+
+安装目录规则：
+
+- `claude` + `project`: `<project>/.claude/skills/<name>`
+- `claude` + `global`: `~/.claude/skills/<name>`
+- `codex` + `project`: `<project>/.agents/skills/<name>`
+- `codex` + `global`: `~/.agents/skills/<name>`
+- `cursor` + `project`: `<project>/.agents/skills/<name>`
+- `cursor` + `global`: `~/.agents/skills/<name>`
+
+输出是一个 JSON，包含：
+
+- 安装的 skill 名称
+- 安装范围
+- 项目目录
+- 下载地址
+- 实际安装到的目标路径列表
+
+## Environment Variables
+
+### `record` 相关
+
+- `HOOK_REPORT_URL`: 上报地址
+- `CHANGE_REPORT_URL`: 上报地址，作为 `HOOK_REPORT_URL` 的备用读取项
+- `HOOK_REPORT_TIMEOUT_MS`: 请求超时时间，默认 `10000`
+- `HOOK_REPORT_TOKEN`: 如果设置，会以 `Authorization: Bearer <token>` 发送
+- `HOOK_REPORT_HEADERS`: 额外请求头，要求是 JSON 字符串
+- `HOOK_REQUEST_DRY_RUN=1`: 不发请求，只把事件打印到标准输出
+
+默认上报地址：
+
+```text
+https://aihub.ronds.com/api/api/v1/ai-code-events
+```
+
+### `worker_id` 解析顺序
+
+`record` 在构建事件时，会按下面顺序寻找 `worker_id`：
+
+1. `process.cwd()/.ai_config/config.json` 中的 `worker_id`
+2. Git 仓库根目录下 `.ai_config/config.json` 中的 `worker_id`
+3. 环境变量 `MCP_TRACKER_WORKER_ID`
+4. 环境变量 `WORKER_ID`
+5. 当前系统用户名
+
+## Error Logs
+
+命令运行失败或上报失败时，会把信息保存到：
+
+```text
+~/.ronds_ai/failed-events
+```
+
+常见文件名格式：
+
+- `YYYYMMDD-claude-error.jsonl`
+- `YYYYMMDD-cursor-error.jsonl`
+- `YYYYMMDD-cli-error.jsonl`
+
+## Notes
+
+- `record` 和 `doctor` 目前只支持 `claude` 与 `cursor`
+- `skills install` 支持 `claude`、`codex`、`cursor`
+- 不支持的命令或参数会直接报错，并把错误写入 CLI 错误日志

package/bin/ronds_ai.js

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
 
 const { runCodeRecord, saveCliError } = require('../lib/code_record');
+const { runCheckRecord } = require('../lib/check_record');
 const { runDoctor } = require('../lib/doctor');
 const { deployHooks } = require('../lib/hooks_deploy');
+const { runSkillsInstall } = require('../lib/skills_install');
 
 const SUPPORTED_SOURCES = new Set(['claude', 'cursor']);
 
@@ -10,19 +12,26 @@ function printUsage() {
   process.stderr.write([
     'Usage:',
     '  ronds_ai record <tool>',
+    '  ronds_ai check record',
     '  ronds_ai doctor <tool>',
     '  ronds_ai hooks deploy',
+    '  ronds_ai skills install <name> [--tool claude,codex,cursor] [--scope project|global] [--project-dir <path>] [--force]',
     '',
     'Supported tools:',
     '  claude',
     '  cursor',
+    '  codex',
     '',
     'Examples:',
     '  npx ronds_ai@latest record claude',
     '  npx ronds_ai@latest record cursor',
+    '  npx ronds_ai@latest check record',
     '  npx ronds_ai@latest doctor claude',
     '  npx ronds_ai@latest doctor cursor',
     '  npx ronds_ai@latest hooks deploy',
+    '  npx ronds_ai@latest skills install demo-skill',
+    '  npx ronds_ai@latest skills install demo-skill --tool claude --scope global',
+    '  npx ronds_ai@latest skills install demo-skill --tool codex,cursor --scope project',
   ].join('\n'));
   process.stderr.write('\n');
 }
@@ -38,6 +47,101 @@ async function runHooksCommand(args) {
   process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
 }
 
+async function runCheckCommand(args) {
+  const [target] = args;
+
+  if (target !== 'record') {
+    throw new Error('Unsupported check command');
+  }
+
+  const result = runCheckRecord(process.cwd());
+  process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+
+  if (!result.ok) {
+    process.exitCode = 1;
+  }
+}
+
+function parseSkillsInstallArgs(args) {
+  const options = {
+    tool: '',
+    scope: '',
+    projectDir: '',
+    force: false,
+  };
+  const positional = [];
+
+  for (let index = 0; index < args.length; index += 1) {
+    const value = args[index];
+
+    if (value === '--force') {
+      options.force = true;
+      continue;
+    }
+
+    if (value === '--tool') {
+      index += 1;
+      options.tool = args[index] || '';
+      continue;
+    }
+
+    if (value.startsWith('--tool=')) {
+      options.tool = value.slice('--tool='.length);
+      continue;
+    }
+
+    if (value === '--scope') {
+      index += 1;
+      options.scope = args[index] || '';
+      continue;
+    }
+
+    if (value.startsWith('--scope=')) {
+      options.scope = value.slice('--scope='.length);
+      continue;
+    }
+
+    if (value === '--project-dir') {
+      index += 1;
+      options.projectDir = args[index] || '';
+      continue;
+    }
+
+    if (value.startsWith('--project-dir=')) {
+      options.projectDir = value.slice('--project-dir='.length);
+      continue;
+    }
+
+    if (value.startsWith('--')) {
+      throw new Error(`Unsupported option: ${value}`);
+    }
+
+    positional.push(value);
+  }
+
+  const [name] = positional;
+  if (!name) {
+    throw new Error('Missing skill name');
+  }
+
+  return {
+    name,
+    options,
+  };
+}
+
+async function runSkillsCommand(args) {
+  const [action, ...rest] = args;
+
+  if (action !== 'install') {
+    throw new Error('Unsupported skills command');
+  }
+
+  const { name, options } = parseSkillsInstallArgs(rest);
+  const result = await runSkillsInstall(name, options);
+  process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+}
+
 async function run() {
   const [, , command, ...args] = process.argv;
 
@@ -66,11 +170,21 @@ async function run() {
     return;
   }
 
+  if (command === 'check') {
+    await runCheckCommand(args);
+    return;
+  }
+
   if (command === 'hooks') {
     await runHooksCommand(args);
     return;
   }
 
+  if (command === 'skills') {
+    await runSkillsCommand(args);
+    return;
+  }
+
   throw new Error(`Unsupported command: ${command || ''}`);
 }
 

package/lib/check_record.js

@@ -0,0 +1,106 @@
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { execFileSync } = require('child_process');
+
+const ENVIRONMENT_VARIABLE_NAME = process.env.ENVIRONMENT_VARIABLE_NAME || 'MCP_TRACKER_WORKER_ID';
+const MINIMUM_NODE_MAJOR = 16;
+
+function readGitUserEmail(baseDir) {
+  try {
+    return execFileSync('git', ['config', 'user.email'], {
+      cwd: baseDir,
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'pipe'],
+    })
+      .trim()
+      .replace(/^["'“”]+/, '')
+      .replace(/["'“”]+$/, '');
+  } catch {
+    return '';
+  }
+}
+
+function getProfileFilePath() {
+  return path.join(os.homedir(), '.profile');
+}
+
+function getCurrentWorkerId() {
+  const envValue = String(process.env[ENVIRONMENT_VARIABLE_NAME] || '').trim();
+  if (envValue) {
+    return {
+      name: ENVIRONMENT_VARIABLE_NAME,
+      value: envValue,
+      source: 'env',
+    };
+  }
+
+  const profileFile = getProfileFilePath();
+  if (!fs.existsSync(profileFile)) {
+    return {
+      name: ENVIRONMENT_VARIABLE_NAME,
+      value: '',
+      source: '',
+    };
+  }
+
+  const lines = fs.readFileSync(profileFile, 'utf8').split('\n');
+  const prefix = `export ${ENVIRONMENT_VARIABLE_NAME}=`;
+
+  for (let index = lines.length - 1; index >= 0; index -= 1) {
+    const line = lines[index].trim();
+    if (!line.startsWith(prefix)) {
+      continue;
+    }
+
+    const value = line
+      .slice(prefix.length)
+      .trim()
+      .replace(/^"/, '')
+      .replace(/"$/, '');
+
+    return {
+      name: ENVIRONMENT_VARIABLE_NAME,
+      value,
+      source: 'profile',
+    };
+  }
+
+  return {
+    name: ENVIRONMENT_VARIABLE_NAME,
+    value: '',
+    source: '',
+  };
+}
+
+function parseNodeMajor(version) {
+  const normalized = String(version || '').trim();
+  const match = normalized.match(/^v?(\d+)/);
+  return match ? Number(match[1]) : 0;
+}
+
+function runCheckRecord(targetDir = process.cwd()) {
+  const baseDir = path.resolve(targetDir);
+  const nodeVersion = process.version;
+  const nodeMajor = parseNodeMajor(nodeVersion);
+  const gitUserEmail = readGitUserEmail(baseDir);
+  const worker = getCurrentWorkerId();
+  const nodeSatisfied = nodeMajor >= MINIMUM_NODE_MAJOR;
+
+  return {
+    ok: nodeSatisfied,
+    targetDir: baseDir,
+    node: {
+      version: nodeVersion,
+      requirement: `>=${MINIMUM_NODE_MAJOR}`,
+      satisfied: nodeSatisfied,
+    },
+    gitUserEmail,
+    workerId: worker,
+    profileFile: getProfileFilePath(),
+  };
+}
+
+module.exports = {
+  runCheckRecord,
+};

package/lib/skills_install.js

@@ -0,0 +1,226 @@
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const http = require('http');
+const https = require('https');
+const { execFileSync } = require('child_process');
+const { buildInstallTargets, normalizeScope, normalizeTools } = require('./skills_targets');
+const { promptForScope, promptForTools } = require('./skills_prompt');
+
+const SKILL_DOWNLOAD_BASE_URL = 'https://aihub.ronds.com/api/api/v1/skills/download';
+const MAX_REDIRECTS = 5;
+
+function parseJson(raw, label) {
+  try {
+    return JSON.parse(raw);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new Error(`${label} is not valid JSON: ${detail}`);
+  }
+}
+
+function loadDownloadConfig() {
+  const token = String(process.env.SKILL_DOWNLOAD_TOKEN || '').trim();
+  const extraHeaders = process.env.SKILL_DOWNLOAD_HEADERS
+    ? parseJson(process.env.SKILL_DOWNLOAD_HEADERS, 'SKILL_DOWNLOAD_HEADERS')
+    : {};
+
+  const headers = {
+    ...extraHeaders,
+  };
+
+  if (token) {
+    headers.authorization = `Bearer ${token}`;
+  }
+
+  return { headers };
+}
+
+function copyDirectoryRecursive(sourceDir, destinationDir) {
+  const entries = fs.readdirSync(sourceDir, { withFileTypes: true });
+  fs.mkdirSync(destinationDir, { recursive: true });
+
+  for (const entry of entries) {
+    const sourcePath = path.join(sourceDir, entry.name);
+    const destinationPath = path.join(destinationDir, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDirectoryRecursive(sourcePath, destinationPath);
+      continue;
+    }
+
+    if (entry.isSymbolicLink()) {
+      const targetPath = fs.readlinkSync(sourcePath);
+      fs.symlinkSync(targetPath, destinationPath);
+      continue;
+    }
+
+    fs.copyFileSync(sourcePath, destinationPath);
+  }
+}
+
+function copyDirectory(sourceDir, destinationDir) {
+  if (typeof fs.cpSync === 'function') {
+    fs.cpSync(sourceDir, destinationDir, { recursive: true });
+    return;
+  }
+
+  copyDirectoryRecursive(sourceDir, destinationDir);
+}
+
+function streamToFile(url, destinationPath, config, redirectCount = 0) {
+  return new Promise((resolve, reject) => {
+    const transport = String(url).startsWith('http://') ? http : https;
+    const request = transport.get(url, { headers: config.headers }, (response) => {
+      if (response.statusCode && response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
+        response.resume();
+        if (redirectCount >= MAX_REDIRECTS) {
+          reject(new Error('Too many redirects while downloading skill archive'));
+          return;
+        }
+
+        const nextUrl = new URL(response.headers.location, url).toString();
+        streamToFile(nextUrl, destinationPath, config, redirectCount + 1).then(resolve, reject);
+        return;
+      }
+
+      if (response.statusCode !== 200) {
+        response.resume();
+        reject(new Error(`Skill download failed with status ${response.statusCode || 0}`));
+        return;
+      }
+
+      const fileStream = fs.createWriteStream(destinationPath);
+      response.pipe(fileStream);
+
+      fileStream.on('finish', () => {
+        fileStream.close(() => resolve(destinationPath));
+      });
+
+      fileStream.on('error', (error) => {
+        fileStream.close(() => reject(error));
+      });
+    });
+
+    request.on('error', reject);
+  });
+}
+
+async function downloadSkillArchive(name, workingDir) {
+  const archivePath = path.join(workingDir, `${name}.zip`);
+  const url = `${SKILL_DOWNLOAD_BASE_URL}/${encodeURIComponent(name)}`;
+  await streamToFile(url, archivePath, loadDownloadConfig());
+  return {
+    url,
+    archivePath,
+  };
+}
+
+function extractArchive(archivePath, outputDir) {
+  fs.mkdirSync(outputDir, { recursive: true });
+  execFileSync('unzip', ['-q', archivePath, '-d', outputDir], {
+    stdio: ['ignore', 'pipe', 'pipe'],
+  });
+}
+
+function findSkillRoot(extractDir) {
+  const directSkillMd = path.join(extractDir, 'SKILL.md');
+  if (fs.existsSync(directSkillMd)) {
+    return extractDir;
+  }
+
+  const entries = fs.readdirSync(extractDir, { withFileTypes: true });
+  const candidateDirs = entries
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => path.join(extractDir, entry.name))
+    .filter((entryPath) => fs.existsSync(path.join(entryPath, 'SKILL.md')));
+
+  if (candidateDirs.length === 1) {
+    return candidateDirs[0];
+  }
+
+  if (candidateDirs.length > 1) {
+    throw new Error('Downloaded archive contains multiple skill roots');
+  }
+
+  throw new Error('Downloaded archive does not contain SKILL.md');
+}
+
+function copySkill(sourceDir, destinationDir, force) {
+  if (fs.existsSync(destinationDir)) {
+    if (!force) {
+      throw new Error(`Skill already exists at ${destinationDir}. Use --force to overwrite.`);
+    }
+
+    fs.rmSync(destinationDir, { recursive: true, force: true });
+  }
+
+  fs.mkdirSync(path.dirname(destinationDir), { recursive: true });
+  copyDirectory(sourceDir, destinationDir);
+}
+
+async function resolveInstallOptions(options) {
+  let tools = normalizeTools(options.tool);
+  if (tools.length === 0) {
+    tools = normalizeTools(await promptForTools());
+  }
+
+  if (tools.length === 0) {
+    throw new Error('No skills tool selected');
+  }
+
+  let scope = normalizeScope(options.scope);
+  if (!scope) {
+    scope = normalizeScope(await promptForScope());
+  }
+
+  if (!scope) {
+    throw new Error('No skills scope selected');
+  }
+
+  return {
+    tools,
+    scope,
+    projectDir: options.projectDir ? path.resolve(options.projectDir) : process.cwd(),
+    force: Boolean(options.force),
+  };
+}
+
+async function runSkillsInstall(name, rawOptions = {}) {
+  const skillName = String(name || '').trim();
+  if (!skillName) {
+    throw new Error('Missing skill name');
+  }
+
+  const options = await resolveInstallOptions(rawOptions);
+  const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'ronds-ai-skill-'));
+
+  try {
+    const download = await downloadSkillArchive(skillName, tempRoot);
+    const extractDir = path.join(tempRoot, 'extracted');
+    extractArchive(download.archivePath, extractDir);
+    const skillRoot = findSkillRoot(extractDir);
+    const targets = buildInstallTargets(options.tools, options.scope, options.projectDir, skillName);
+
+    for (const target of targets) {
+      copySkill(skillRoot, target.destination, options.force);
+    }
+
+    return {
+      name: skillName,
+      scope: options.scope,
+      projectDir: options.scope === 'project' ? options.projectDir : '',
+      archiveUrl: download.url,
+      installedTargets: targets.map((target) => ({
+        tools: target.tools,
+        destination: target.destination,
+      })),
+    };
+  } finally {
+    fs.rmSync(tempRoot, { recursive: true, force: true });
+  }
+}
+
+module.exports = {
+  runSkillsInstall,
+};

package/lib/skills_prompt.js

@@ -0,0 +1,87 @@
+const readline = require('readline/promises');
+
+const TOOL_CHOICES = ['claude', 'codex', 'cursor'];
+const SCOPE_CHOICES = ['project', 'global'];
+
+function normalizeCsvInput(raw) {
+  return String(raw || '')
+    .split(',')
+    .map((item) => item.trim().toLowerCase())
+    .filter(Boolean);
+}
+
+function normalizeChoiceInput(raw) {
+  const values = normalizeCsvInput(raw);
+  if (values.length === 0) {
+    return [];
+  }
+
+  return values.flatMap((value) => {
+    if (/^\d+$/.test(value)) {
+      const index = Number(value) - 1;
+      return TOOL_CHOICES[index] ? [TOOL_CHOICES[index]] : [];
+    }
+
+    return [value];
+  });
+}
+
+async function promptForTools() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  try {
+    process.stderr.write([
+      'Select tools to install:',
+      '  1. claude',
+      '  2. codex',
+      '  3. cursor',
+      'Enter comma-separated names or numbers:',
+    ].join('\n'));
+    process.stderr.write('\n');
+
+    const answer = await rl.question('> ');
+    return normalizeChoiceInput(answer);
+  } finally {
+    rl.close();
+  }
+}
+
+async function promptForScope() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  try {
+    process.stderr.write([
+      'Select install scope:',
+      '  1. project',
+      '  2. global',
+      'Enter project or global:',
+    ].join('\n'));
+    process.stderr.write('\n');
+
+    const answer = String(await rl.question('> ')).trim().toLowerCase();
+    if (answer === '1') {
+      return 'project';
+    }
+    if (answer === '2') {
+      return 'global';
+    }
+    return answer;
+  } finally {
+    rl.close();
+  }
+}
+
+module.exports = {
+  SCOPE_CHOICES,
+  TOOL_CHOICES,
+  normalizeChoiceInput,
+  normalizeCsvInput,
+  promptForScope,
+  promptForTools,
+};

package/lib/skills_targets.js

@@ -0,0 +1,81 @@
+const os = require('os');
+const path = require('path');
+const { SCOPE_CHOICES, TOOL_CHOICES, normalizeCsvInput } = require('./skills_prompt');
+
+function normalizeTools(rawTools) {
+  const values = Array.isArray(rawTools)
+    ? rawTools.flatMap((item) => normalizeCsvInput(item))
+    : normalizeCsvInput(rawTools);
+  const unique = [];
+
+  for (const tool of values) {
+    if (!TOOL_CHOICES.includes(tool)) {
+      throw new Error(`Unsupported skills tool: ${tool}`);
+    }
+
+    if (!unique.includes(tool)) {
+      unique.push(tool);
+    }
+  }
+
+  return unique;
+}
+
+function normalizeScope(rawScope) {
+  const scope = String(rawScope || '').trim().toLowerCase();
+  if (!scope) {
+    return '';
+  }
+
+  if (!SCOPE_CHOICES.includes(scope)) {
+    throw new Error(`Unsupported skills scope: ${rawScope}`);
+  }
+
+  return scope;
+}
+
+function resolveToolBaseDir(tool, scope, projectDir) {
+  const baseDir = scope === 'global' ? os.homedir() : path.resolve(projectDir || process.cwd());
+
+  if (tool === 'claude') {
+    return path.join(baseDir, '.claude', 'skills');
+  }
+
+  if (tool === 'codex' || tool === 'cursor') {
+    return path.join(baseDir, '.agents', 'skills');
+  }
+
+  throw new Error(`Unsupported skills tool: ${tool}`);
+}
+
+function buildInstallTargets(tools, scope, projectDir, skillName) {
+  const deduped = new Map();
+
+  for (const tool of tools) {
+    const baseDir = resolveToolBaseDir(tool, scope, projectDir);
+    const destination = path.join(baseDir, skillName);
+    const existing = deduped.get(destination);
+
+    if (existing) {
+      existing.tools.push(tool);
+      continue;
+    }
+
+    deduped.set(destination, {
+      tool,
+      tools: [tool],
+      scope,
+      baseDir,
+      destination,
+    });
+  }
+
+  return Array.from(deduped.values());
+}
+
+module.exports = {
+  buildInstallTargets,
+  normalizeScope,
+  normalizeTools,
+  resolveToolBaseDir,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ronds_ai",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "CLI for reporting AI code edit events.",
   "bin": {
     "ronds_ai": "bin/ronds_ai.js"
@@ -9,5 +9,8 @@
     "bin",
     "lib"
   ],
+  "engines": {
+    "node": ">=16"
+  },
   "license": "MIT"
 }