tools-cc 1.0.0

package/dist/core/source.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addSource = addSource;
+exports.listSources = listSources;
+exports.removeSource = removeSource;
+exports.updateSource = updateSource;
+exports.getSourcePath = getSourcePath;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const config_1 = require("./config");
+async function addSource(name, sourcePath, configDir) {
+    const config = await (0, config_1.loadGlobalConfig)(configDir);
+    // 判断是 git url 还是本地路径
+    const isGit = sourcePath.startsWith('http') || sourcePath.startsWith('git@');
+    let sourceConfig;
+    if (isGit) {
+        // Clone git repo
+        const cloneDir = path_1.default.join(config.sourcesDir, name);
+        console.log(`Cloning ${sourcePath} to ${cloneDir}...`);
+        await fs_extra_1.default.ensureDir(config.sourcesDir);
+        (0, child_process_1.execSync)(`git clone ${sourcePath} "${cloneDir}"`, { stdio: 'inherit' });
+        sourceConfig = { type: 'git', url: sourcePath };
+    }
+    else {
+        // 本地路径
+        const absolutePath = path_1.default.resolve(sourcePath);
+        if (!(await fs_extra_1.default.pathExists(absolutePath))) {
+            throw new Error(`Path does not exist: ${absolutePath}`);
+        }
+        sourceConfig = { type: 'local', path: absolutePath };
+    }
+    config.sources[name] = sourceConfig;
+    await (0, config_1.saveGlobalConfig)(config, configDir);
+    return sourceConfig;
+}
+async function listSources(configDir) {
+    const config = await (0, config_1.loadGlobalConfig)(configDir);
+    return config.sources;
+}
+async function removeSource(name, configDir) {
+    const config = await (0, config_1.loadGlobalConfig)(configDir);
+    if (!config.sources[name]) {
+        throw new Error(`Source not found: ${name}`);
+    }
+    const source = config.sources[name];
+    // 如果是 git 类型，清理克隆目录
+    if (source.type === 'git') {
+        const cloneDir = path_1.default.join(config.sourcesDir, name);
+        if (await fs_extra_1.default.pathExists(cloneDir)) {
+            console.log(`Removing cloned directory: ${cloneDir}`);
+            await fs_extra_1.default.remove(cloneDir);
+        }
+    }
+    delete config.sources[name];
+    await (0, config_1.saveGlobalConfig)(config, configDir);
+}
+async function updateSource(name, configDir) {
+    const config = await (0, config_1.loadGlobalConfig)(configDir);
+    const source = config.sources[name];
+    if (!source) {
+        throw new Error(`Source not found: ${name}`);
+    }
+    if (source.type === 'git') {
+        const cloneDir = path_1.default.join(config.sourcesDir, name);
+        console.log(`Updating ${name}...`);
+        (0, child_process_1.execSync)(`git -C "${cloneDir}" pull`, { stdio: 'inherit' });
+    }
+    else {
+        console.log(`Source ${name} is local, no update needed.`);
+    }
+}
+async function getSourcePath(name, configDir) {
+    const config = await (0, config_1.loadGlobalConfig)(configDir);
+    const source = config.sources[name];
+    if (!source) {
+        throw new Error(`Source not found: ${name}`);
+    }
+    if (source.type === 'local') {
+        return source.path;
+    }
+    return path_1.default.join(config.sourcesDir, name);
+}

package/dist/core/symlink.d.ts

@@ -0,0 +1,3 @@
+export declare function createSymlink(target: string, linkPath: string, force?: boolean): Promise<void>;
+export declare function removeSymlink(linkPath: string): Promise<void>;
+export declare function isSymlink(path: string): Promise<boolean>;

package/dist/core/symlink.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSymlink = createSymlink;
+exports.removeSymlink = removeSymlink;
+exports.isSymlink = isSymlink;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+async function createSymlink(target, linkPath, force = false) {
+    // 如果目标已存在
+    if (await fs_extra_1.default.pathExists(linkPath)) {
+        if (!force) {
+            throw new Error(`Path already exists: ${linkPath}. Use force=true to overwrite.`);
+        }
+        // 检查是否已经是符号链接
+        if (await isSymlink(linkPath)) {
+            await fs_extra_1.default.remove(linkPath);
+        }
+        else {
+            // 是真实目录，删除
+            await fs_extra_1.default.remove(linkPath);
+        }
+    }
+    // 确保目标存在
+    if (!(await fs_extra_1.default.pathExists(target))) {
+        throw new Error(`Target does not exist: ${target}`);
+    }
+    // 创建符号链接
+    // Windows: 使用 junction (不需要管理员权限)
+    // Linux/macOS: 使用 symlink
+    const targetPath = path_1.default.resolve(target);
+    if (process.platform === 'win32') {
+        // Windows: 使用 junction
+        await fs_extra_1.default.ensureSymlink(targetPath, linkPath, 'junction');
+    }
+    else {
+        // Linux/macOS: 使用 dir symlink
+        await fs_extra_1.default.ensureSymlink(targetPath, linkPath, 'dir');
+    }
+}
+async function removeSymlink(linkPath) {
+    if (await isSymlink(linkPath)) {
+        await fs_extra_1.default.remove(linkPath);
+    }
+}
+async function isSymlink(path) {
+    try {
+        const stats = await fs_extra_1.default.lstat(path);
+        return stats.isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const config_1 = require("./commands/config");
+const source_1 = require("./commands/source");
+const use_1 = require("./commands/use");
+const help_1 = require("./commands/help");
+const program = new commander_1.Command();
+program
+    .name('tools-cc')
+    .description('CLI tool for managing skills/commands/agents across multiple AI coding tools')
+    .version('0.0.1');
+// Source management (shortcut options)
+program
+    .option('-s, --source <command> [args...]', 'Source management (shortcut)')
+    .option('-c, --config <command> [args...]', 'Config management (shortcut)');
+// Source subcommands (full command version)
+const sourceCmd = program
+    .command('sources')
+    .description('Source management');
+sourceCmd
+    .command('add <name> <path-or-url>')
+    .description('Add a source')
+    .action(async (name, pathOrUrl) => {
+    await (0, source_1.handleSourceAdd)(name, pathOrUrl);
+});
+sourceCmd
+    .command('list')
+    .alias('ls')
+    .description('List all sources')
+    .action(async () => {
+    await (0, source_1.handleSourceList)();
+});
+sourceCmd
+    .command('remove <name>')
+    .alias('rm')
+    .description('Remove a source')
+    .action(async (name) => {
+    await (0, source_1.handleSourceRemove)(name);
+});
+sourceCmd
+    .command('update [name]')
+    .alias('up')
+    .description('Update source(s)')
+    .action(async (name) => {
+    await (0, source_1.handleSourceUpdate)(name);
+});
+// Config subcommands (full command version)
+const configCmd = program
+    .command('config')
+    .description('Config management');
+configCmd
+    .command('set <key> <value>')
+    .description('Set a config value')
+    .action(async (key, value) => {
+    await (0, config_1.handleConfigSet)(key, value);
+});
+configCmd
+    .command('get <key>')
+    .description('Get a config value')
+    .action(async (key) => {
+    await (0, config_1.handleConfigGet)(key);
+});
+configCmd
+    .command('list')
+    .description('Show full configuration')
+    .action(async () => {
+    await (0, config_1.handleConfigList)();
+});
+// Project commands
+program
+    .command('use [sources...]')
+    .description('Use sources in current project')
+    .option('-p, --projects <tools...>', 'Tools to link (iflow, claude, codebuddy, opencode)')
+    .action(async (sources, options) => {
+    await (0, use_1.handleUse)(sources, options);
+});
+program
+    .command('list')
+    .description('List sources in use')
+    .action(async () => {
+    await (0, use_1.handleList)();
+});
+program
+    .command('rm <source>')
+    .description('Remove a source from project')
+    .action(async (source) => {
+    await (0, use_1.handleRemove)(source);
+});
+program
+    .command('status')
+    .description('Show project status')
+    .action(async () => {
+    await (0, use_1.handleStatus)();
+});
+// Help command
+program
+    .command('help')
+    .description('Show bilingual help information')
+    .action(() => {
+    (0, help_1.showHelp)();
+});
+// Main action handler for -s and -c options
+program
+    .action(async (options) => {
+    // Handle -s/--source
+    if (options.source) {
+        const [cmd, ...args] = options.source;
+        switch (cmd) {
+            case 'add':
+                if (args.length < 2) {
+                    console.log('Usage: tools-cc -s add <name> <path-or-url>');
+                    return;
+                }
+                await (0, source_1.handleSourceAdd)(args[0], args[1]);
+                break;
+            case 'list':
+            case 'ls':
+                await (0, source_1.handleSourceList)();
+                break;
+            case 'remove':
+            case 'rm':
+                if (args.length < 1) {
+                    console.log('Usage: tools-cc -s remove <name>');
+                    return;
+                }
+                await (0, source_1.handleSourceRemove)(args[0]);
+                break;
+            case 'update':
+            case 'up':
+                await (0, source_1.handleSourceUpdate)(args[0]);
+                break;
+            default:
+                console.log(`Unknown source command: ${cmd}`);
+        }
+        return;
+    }
+    // Handle -c/--config
+    if (options.config) {
+        const [cmd, ...args] = options.config;
+        switch (cmd) {
+            case 'set':
+                if (args.length < 2) {
+                    console.log('Usage: tools-cc -c set <key> <value>');
+                    return;
+                }
+                await (0, config_1.handleConfigSet)(args[0], args[1]);
+                break;
+            case 'get':
+                if (args.length < 1) {
+                    console.log('Usage: tools-cc -c get <key>');
+                    return;
+                }
+                await (0, config_1.handleConfigGet)(args[0]);
+                break;
+            default:
+                console.log(`Unknown config command: ${cmd}`);
+        }
+        return;
+    }
+    // No options provided, show help
+    program.outputHelp();
+});
+program.parseAsync();

package/dist/types/config.d.ts

@@ -0,0 +1,23 @@
+export interface SourceConfig {
+    type: 'git' | 'local';
+    url?: string;
+    path?: string;
+}
+export interface GlobalConfig {
+    sourcesDir: string;
+    sources: Record<string, SourceConfig>;
+}
+export interface ProjectConfig {
+    sources: string[];
+    links: string[];
+}
+export interface Manifest {
+    name: string;
+    version: string;
+    skills?: string[];
+    commands?: string[];
+    agents?: string[];
+}
+export interface ToolConfig {
+    linkName: string;
+}

package/dist/types/config.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/index.d.ts

@@ -0,0 +1 @@
+export * from './config';

package/dist/types/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./config"), exports);

package/dist/utils/path.d.ts

@@ -0,0 +1,8 @@
+export declare const GLOBAL_CONFIG_DIR: string;
+export declare const GLOBAL_CONFIG_FILE: string;
+export declare const DEFAULT_CONFIG: {
+    sourcesDir: string;
+    sources: {};
+};
+export declare function getProjectConfigPath(projectDir: string): string;
+export declare function getToolsccDir(projectDir: string): string;

package/dist/utils/path.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = exports.GLOBAL_CONFIG_FILE = exports.GLOBAL_CONFIG_DIR = void 0;
+exports.getProjectConfigPath = getProjectConfigPath;
+exports.getToolsccDir = getToolsccDir;
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+exports.GLOBAL_CONFIG_DIR = path_1.default.join(os_1.default.homedir(), '.tools-cc');
+exports.GLOBAL_CONFIG_FILE = path_1.default.join(exports.GLOBAL_CONFIG_DIR, 'config.json');
+exports.DEFAULT_CONFIG = {
+    sourcesDir: path_1.default.join(exports.GLOBAL_CONFIG_DIR, 'sources'),
+    sources: {}
+};
+function getProjectConfigPath(projectDir) {
+    return path_1.default.join(projectDir, 'tools-cc.json');
+}
+function getToolsccDir(projectDir) {
+    return path_1.default.join(projectDir, '.toolscc');
+}

package/docs/plans/2026-02-25-tools-cc-design.md

@@ -0,0 +1,195 @@
+# tools-cc CLI 设计文档
+
+## 概述
+
+tools-cc 是一个用于统一管理多个 AI 编程工具（iflow、claude、codebuddy、opencode 等）的 skills、commands、agents 配置的 CLI 工具。通过符号链接机制，避免在多个工具间重复配置。
+
+## 核心需求
+
+- 同时使用多个 AI 编程工具时，避免重复配置 skills/commands/agents
+- 支持从 git 仓库或本地目录安装配置源
+- 支持同时启用多个配置源
+- 全局配置 + 项目级覆盖
+- 自动创建符号链接
+
+## 架构设计
+
+### 目录结构
+
+```
+~/.tools-cc/                      # 全局配置目录
+├── config.json                   # 全局配置
+└── cache/                        # 缓存（可选）
+
+D:/skills-hub-sources/            # 用户自定义的 sources 存储位置
+├── my-skills/
+│   ├── manifest.json
+│   ├── skills/
+│   ├── commands/
+│   └── agents/
+└── my-skills2/
+    ├── manifest.json
+    ├── skills/
+    ├── commands/
+    └── agents/
+
+项目目录/
+├── .toolscc/                     # 实际内容目录
+│   ├── skills/                   # 扁平化，带来源前缀
+│   │   ├── my-skills-brainstorming/
+│   │   └── my-skills2-debugging/
+│   ├── commands/
+│   │   ├── my-skills/           # 按来源分子目录
+│   │   └── my-skills2/
+│   └── agents/
+│       ├── my-skills/
+│       └── my-skills2/
+├── .iflow -> .toolscc            # 符号链接
+├── .claude -> .toolscc
+└── tools-cc.json                 # 项目配置
+```
+
+### 关键设计点
+
+1. **skills 目录扁平化**：由于工具只能识别一级目录下的 skills，多个配置源的 skills 使用 `{source-name}-{skill-name}` 命名避免冲突
+2. **commands/agents 保持层级**：按来源分子目录，因为工具支持多级目录
+
+## 文件格式
+
+### 全局配置 `~/.tools-cc/config.json`
+
+```json
+{
+  "sourcesDir": "D:/skills-hub-sources",
+  "sources": {
+    "my-skills": {
+      "type": "git",
+      "url": "https://github.com/user/my-skills.git"
+    },
+    "local-skills": {
+      "type": "local",
+      "path": "D:/local-skills"
+    }
+  }
+}
+```
+
+### 项目配置 `项目/tools-cc.json`
+
+```json
+{
+  "sources": ["my-skills", "local-skills"],
+  "links": ["iflow", "claude"]
+}
+```
+
+### 配置源清单 `sources/my-skills/manifest.json`
+
+```json
+{
+  "name": "my-skills",
+  "version": "1.0.0",
+  "skills": ["brainstorming", "debugging"],
+  "commands": ["brainstorm", "review"],
+  "agents": ["code-reviewer"]
+}
+```
+
+如果配置源是本地目录且没有 manifest，CLI 会自动扫描目录结构生成。
+
+## CLI 命令
+
+```
+tools-cc [options] <command> [args]
+
+# Source 管理
+tools-cc -s add <name> <path-or-url>     # 添加配置源
+tools-cc -s list                          # 列出所有配置源 (-s ls)
+tools-cc -s remove <name>                 # 移除配置源 (-s rm)
+tools-cc -s update [name]                 # 更新配置源 (-s up)
+
+# 项目配置
+tools-cc use [source-names...] [-p tools...]   # 启用配置源并可选创建链接
+tools-cc list                                  # 列出已启用的配置源
+tools-cc rm <name>                             # 禁用配置源
+
+# Config 管理
+tools-cc -c set <key> <value>             # 设置配置
+tools-cc -c get <key>                     # 查看配置
+
+# 信息查看
+tools-cc status                           # 查看项目状态
+```
+
+## 内置支持的 Tools
+
+```typescript
+const SUPPORTED_TOOLS = {
+  iflow: { linkName: '.iflow' },
+  claude: { linkName: '.claude' },
+  codebuddy: { linkName: '.codebuddy' },
+  opencode: { linkName: '.opencode' }
+}
+```
+
+## 数据流
+
+```
+用户执行: tools-cc use my-skills -p iflow claude
+
+1. 检查全局配置，确认 my-skills 存在
+2. 在项目创建 .toolscc/ 目录
+3. 从 sources/my-skills/ 复制/链接组件:
+   - skills/* -> .toolscc/skills/my-skills-*/
+   - commands/* -> .toolscc/commands/my-skills/
+   - agents/* -> .toolscc/agents/my-skills/
+4. 创建符号链接:
+   - .iflow -> .toolscc
+   - .claude -> .toolscc
+5. 更新项目配置 tools-cc.json
+```
+
+## 技术栈
+
+- **语言**: TypeScript / Node.js
+- **CLI 框架**: commander 或 yargs
+- **交互式 UI**: inquirer
+- **符号链接**: Node.js fs.symlink / fs.symlinkSync
+
+## 使用示例
+
+```bash
+# 1. 设置 sources 存储位置
+tools-cc -c set sourcesDir D:/skills-hub-sources
+
+# 2. 添加配置源
+tools-cc -s add my-skills https://github.com/user/my-skills.git
+tools-cc -s add local-skills D:/local-skills
+
+# 3. 在项目中启用配置源并创建链接
+cd my-project
+tools-cc use my-skills local-skills -p iflow claude
+
+# 4. 查看状态
+tools-cc status
+tools-cc list
+
+# 5. 禁用某个配置源
+tools-cc rm local-skills
+
+# 6. 更新配置源
+tools-cc -s update my-skills
+```
+
+## 符号链接处理
+
+- **Windows**: 创建 junction 或 symlink（需要管理员权限，或开启开发者模式）
+- **Linux/macOS**: 创建标准符号链接
+
+当目标目录已存在时，提示用户确认后强制覆盖删除。
+
+## 后续扩展
+
+- 支持自定义 tool 配置（通过 config 添加新的 tool）
+- 支持配置源版本管理
+- 支持团队共享配置（通过 git 管理 tools-cc.json）