tools-cc 1.0.0

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "tools-cc",
+  "version": "1.0.0",
+  "description": "tools-cc [options] <command> [args]",
+  "main": "index.js",
+  "directories": {
+    "doc": "docs"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest",
+    "test:run": "vitest run"
+  },
+  "bin": {
+    "tools-cc": "./dist/index.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/q759410559/tools-cc.git"
+  },
+  "bugs": {
+    "url": "https://github.com/q759410559/tools-cc/issues"
+  },
+  "homepage": "https://github.com/q759410559/tools-cc#readme",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "fs-extra": "^11.3.3",
+    "inquirer": "^13.3.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^25.3.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}

package/readme.md

@@ -0,0 +1,182 @@
+# tools-cc
+
+一个用于统一管理多个 AI 编程工具（iflow、claude、codebuddy、opencode 等）的 skills/commands/agents 配置的 CLI 工具。通过符号链接机制，避免在多个工具间重复配置。
+
+## 安装
+
+```bash
+# 从 npm 安装
+npm install -g tools-cc
+
+# 或从源码构建
+git clone https://github.com/q759410559/tools-cc.git
+cd tools-cc
+npm install
+npm run build
+npm link
+```
+
+## 快速上手
+
+```bash
+# 1. 设置配置源存储位置（可选，默认为 ~/.tools-cc/sources）
+tools-cc -c set sourcesDir D:/skills-hub-sources
+
+# 2. 添加配置源（支持 Git URL 或本地路径）
+tools-cc -s add my-skills https://github.com/user/my-skills.git
+tools-cc -s add local-skills D:/path/to/local-skills
+
+# 3. 查看已添加的配置源
+tools-cc -s list
+
+# 4. 在项目中启用配置源并创建链接
+cd my-project
+tools-cc use my-skills -p iflow claude
+
+# 5. 查看项目状态
+tools-cc status
+
+# 6. 查看已启用的配置源
+tools-cc list
+
+# 7. 移除配置源
+tools-cc rm my-skills
+```
+
+## 命令列表
+
+### Source 管理
+
+```bash
+# 快捷方式 (-s)
+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)
+
+# 完整命令 (sources)
+tools-cc sources add <name> <path-or-url> # 添加配置源
+tools-cc sources list                     # 列出所有配置源 (缩写: sources ls)
+tools-cc sources remove <name>            # 移除配置源 (缩写: sources rm)
+tools-cc sources update [name]            # 更新配置源 (缩写: sources up)
+```
+
+### 项目配置
+
+```bash
+tools-cc use [sources...] [-p tools...]   # 启用配置源并创建链接
+tools-cc list                             # 列出已启用的配置源
+tools-cc rm <source>                      # 禁用配置源
+tools-cc status                           # 查看项目状态
+```
+
+### Config 管理
+
+```bash
+# 快捷方式 (-c)
+tools-cc -c set <key> <value>             # 设置配置
+tools-cc -c get <key>                     # 查看配置
+
+# 完整命令 (config)
+tools-cc config set <key> <value>         # 设置配置
+tools-cc config get <key>                 # 查看配置
+tools-cc config list                      # 查看完整全局配置
+```
+
+### 帮助
+
+```bash
+tools-cc help                             # 显示中英双语帮助信息
+tools-cc --help                           # 显示命令行帮助
+tools-cc --version                        # 显示版本号
+```
+
+## 支持的工具
+
+| 工具 | 链接名称 |
+|------|----------|
+| iflow | `.iflow` |
+| claude | `.claude` |
+| codebuddy | `.codebuddy` |
+| opencode | `.opencode` |
+
+## 配置源结构
+
+配置源目录应包含以下结构：
+
+```
+my-skills/
+├── manifest.json          # 可选，描述组件信息
+├── skills/
+│   └── my-skill/
+│       └── SKILL.md
+├── commands/
+│   └── my-command.md
+└── agents/
+    └── my-agent.md
+```
+
+### manifest.json 格式
+
+```json
+{
+  "name": "my-skills",
+  "version": "1.0.0",
+  "skills": ["my-skill"],
+  "commands": ["my-command"],
+  "agents": ["my-agent"]
+}
+```
+
+如果没有 `manifest.json`，CLI 会自动扫描目录结构生成。
+
+## 项目结构
+
+使用 `tools-cc use` 后，项目目录结构：
+
+```
+my-project/
+├── .toolscc/                     # 实际内容目录
+│   ├── skills/                   # 扁平化，带来源前缀
+│   │   └── my-skills-my-skill/
+│   ├── commands/
+│   │   └── my-skills/
+│   └── agents/
+│       └── my-skills/
+├── .iflow -> .toolscc            # 符号链接
+├── .claude -> .toolscc
+└── tools-cc.json                 # 项目配置
+```
+
+## 配置文件
+
+### 全局配置 `~/.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"],
+  "links": ["iflow", "claude"]
+}
+```
+
+## 许可证
+
+MIT

package/src/commands/config.ts

@@ -0,0 +1,50 @@
+import chalk from 'chalk';
+import { loadGlobalConfig, saveGlobalConfig } from '../core/config';
+import { GLOBAL_CONFIG_DIR } from '../utils/path';
+
+export async function handleConfigSet(key: string, value: string): Promise<void> {
+  const config = await loadGlobalConfig(GLOBAL_CONFIG_DIR);
+  
+  if (key === 'sourcesDir') {
+    config.sourcesDir = value;
+    await saveGlobalConfig(config, GLOBAL_CONFIG_DIR);
+    console.log(chalk.green(`✓ Set sourcesDir to: ${value}`));
+  } else {
+    console.log(chalk.red(`✗ Unknown config key: ${key}`));
+    console.log(chalk.gray('Available keys: sourcesDir'));
+  }
+}
+
+export async function handleConfigGet(key: string): Promise<void> {
+  const config = await loadGlobalConfig(GLOBAL_CONFIG_DIR);
+  
+  if (key === 'sourcesDir') {
+    console.log(config.sourcesDir);
+  } else if (key === 'all') {
+    console.log(JSON.stringify(config, null, 2));
+  } else {
+    console.log(chalk.red(`✗ Unknown config key: ${key}`));
+  }
+}
+
+export async function handleConfigList(): Promise<void> {
+  const config = await loadGlobalConfig(GLOBAL_CONFIG_DIR);
+  
+  console.log(chalk.bold('Global Configuration:'));
+  console.log(chalk.gray(`  Config directory: ${GLOBAL_CONFIG_DIR}`));
+  console.log(`  sourcesDir: ${chalk.cyan(config.sourcesDir || 'not set')}`);
+  
+  if (config.sources && Object.keys(config.sources).length > 0) {
+    console.log(`  sources:`);
+    for (const [name, source] of Object.entries(config.sources)) {
+      console.log(`    ${chalk.cyan(name)} (${source.type})`);
+      if (source.type === 'git') {
+        console.log(chalk.gray(`      URL: ${source.url}`));
+      } else {
+        console.log(chalk.gray(`      Path: ${source.path}`));
+      }
+    }
+  } else {
+    console.log(`  sources: ${chalk.gray('none')}`);
+  }
+}

package/src/commands/help.ts

@@ -0,0 +1,79 @@
+import chalk from 'chalk';
+
+export function showHelp(): void {
+  console.log(`
+${chalk.bold.cyan('═══════════════════════════════════════════════════════════════════════════')}
+${chalk.bold('tools-cc')} - AI Coding Tools Configuration Manager
+${chalk.bold('tools-cc')} - AI 编程工具配置管理器
+${chalk.bold.cyan('═══════════════════════════════════════════════════════════════════════════')}
+
+${chalk.bold('DESCRIPTION / 描述')}
+  A CLI tool for managing skills/commands/agents configurations across multiple
+  AI coding tools (iflow, claude, codebuddy, opencode, etc.) via symlinks.
+  
+  一个用于统一管理多个 AI 编程工具配置的命令行工具，通过符号链接机制避免重复配置。
+
+${chalk.bold('USAGE / 用法')}
+  tools-cc <command> [options]
+  tools-cc <shortcut> <subcommand> [args]
+
+${chalk.bold('COMMANDS / 命令')}
+
+  ${chalk.cyan('Source Management / 配置源管理')}
+    tools-cc sources add <name> <path-or-url>    Add a source / 添加配置源
+    tools-cc sources list, ls                    List all sources / 列出所有配置源
+    tools-cc sources remove, rm <name>           Remove a source / 移除配置源
+    tools-cc sources update, up [name]           Update source(s) / 更新配置源
+    
+    ${chalk.gray('Shortcut: -s')}  e.g., tools-cc -s add my-skills https://github.com/user/skills.git
+
+  ${chalk.cyan('Config Management / 配置管理')}
+    tools-cc config set <key> <value>            Set config value / 设置配置值
+    tools-cc config get <key>                    Get config value / 获取配置值
+    tools-cc config list                         Show full config / 显示完整配置
+    
+    ${chalk.gray('Shortcut: -c')}  e.g., tools-cc -c set sourcesDir D:/skills
+
+  ${chalk.cyan('Project Commands / 项目命令')}
+    tools-cc use [sources...] [-p tools...]      Use sources in project / 在项目中启用配置源
+    tools-cc list                                List used sources / 列出已启用的配置源
+    tools-cc rm <source>                         Remove source from project / 禁用配置源
+    tools-cc status                              Show project status / 显示项目状态
+
+  ${chalk.cyan('Help / 帮助')}
+    tools-cc help                                Show this help / 显示此帮助信息
+    tools-cc --help, -h                          Show command help / 显示命令帮助
+    tools-cc --version, -V                       Show version / 显示版本号
+
+${chalk.bold('SUPPORTED TOOLS / 支持的工具')}
+  iflow      → .iflow
+  claude     → .claude
+  codebuddy  → .codebuddy
+  opencode   → .opencode
+
+${chalk.bold('EXAMPLES / 示例')}
+  ${chalk.gray('# Add a git source / 添加 Git 配置源')}
+  tools-cc sources add my-skills https://github.com/user/my-skills.git
+
+  ${chalk.gray('# Add a local source / 添加本地配置源')}
+  tools-cc sources add local-skills D:/path/to/local-skills
+
+  ${chalk.gray('# List all sources / 列出所有配置源')}
+  tools-cc sources list
+
+  ${chalk.gray('# Use sources in project / 在项目中启用配置源')}
+  tools-cc use my-skills -p iflow claude
+
+  ${chalk.gray('# Check project status / 检查项目状态')}
+  tools-cc status
+
+  ${chalk.gray('# Show full configuration / 显示完整配置')}
+  tools-cc config list
+
+${chalk.bold('MORE INFO / 更多信息')}
+  GitHub: https://github.com/user/tools-cc
+  Docs:   https://github.com/user/tools-cc#readme
+
+${chalk.bold.cyan('═══════════════════════════════════════════════════════════════════════════')}
+`);
+}

package/src/commands/source.ts

@@ -0,0 +1,63 @@
+import chalk from 'chalk';
+import { addSource, listSources, removeSource, updateSource } from '../core/source';
+import { GLOBAL_CONFIG_DIR } from '../utils/path';
+
+export async function handleSourceAdd(name: string, pathOrUrl: string): Promise<void> {
+  try {
+    const result = await addSource(name, pathOrUrl, GLOBAL_CONFIG_DIR);
+    console.log(chalk.green(`✓ Added source: ${name}`));
+    console.log(chalk.gray(`  Type: ${result.type}`));
+    if (result.type === 'git') {
+      console.log(chalk.gray(`  URL: ${result.url}`));
+    } else {
+      console.log(chalk.gray(`  Path: ${result.path}`));
+    }
+  } catch (error) {
+    console.log(chalk.red(`✗ ${error instanceof Error ? error.message : 'Unknown error'}`));
+  }
+}
+
+export async function handleSourceList(): Promise<void> {
+  const sources = await listSources(GLOBAL_CONFIG_DIR);
+  const entries = Object.entries(sources);
+  
+  if (entries.length === 0) {
+    console.log(chalk.gray('No sources configured.'));
+    return;
+  }
+  
+  console.log(chalk.bold('Configured sources:'));
+  for (const [name, config] of entries) {
+    console.log(`  ${chalk.cyan(name)} (${config.type})`);
+    if (config.type === 'git') {
+      console.log(chalk.gray(`    ${config.url}`));
+    } else {
+      console.log(chalk.gray(`    ${config.path}`));
+    }
+  }
+}
+
+export async function handleSourceRemove(name: string): Promise<void> {
+  try {
+    await removeSource(name, GLOBAL_CONFIG_DIR);
+    console.log(chalk.green(`✓ Removed source: ${name}`));
+  } catch (error) {
+    console.log(chalk.red(`✗ ${error instanceof Error ? error.message : 'Unknown error'}`));
+  }
+}
+
+export async function handleSourceUpdate(name?: string): Promise<void> {
+  try {
+    if (name) {
+      await updateSource(name, GLOBAL_CONFIG_DIR);
+    } else {
+      const sources = await listSources(GLOBAL_CONFIG_DIR);
+      for (const sourceName of Object.keys(sources)) {
+        await updateSource(sourceName, GLOBAL_CONFIG_DIR);
+      }
+    }
+    console.log(chalk.green(`✓ Update complete`));
+  } catch (error) {
+    console.log(chalk.red(`✗ ${error instanceof Error ? error.message : 'Unknown error'}`));
+  }
+}

package/src/commands/use.ts

@@ -0,0 +1,147 @@
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { useSource, unuseSource, listUsedSources, initProject } from '../core/project';
+import { getSourcePath, listSources } from '../core/source';
+import { createSymlink, isSymlink } from '../core/symlink';
+import { GLOBAL_CONFIG_DIR, getToolsccDir } from '../utils/path';
+import fs from 'fs-extra';
+import path from 'path';
+
+const SUPPORTED_TOOLS: Record<string, string> = {
+  iflow: '.iflow',
+  claude: '.claude',
+  codebuddy: '.codebuddy',
+  opencode: '.opencode'
+};
+
+export async function handleUse(
+  sourceNames: string[],
+  options: { projects?: string[] }
+): Promise<void> {
+  const projectDir = process.cwd();
+  
+  // 如果没有指定 source，进入交互模式
+  if (sourceNames.length === 0) {
+    const sources = await listSources(GLOBAL_CONFIG_DIR);
+    const sourceList = Object.keys(sources);
+    
+    if (sourceList.length === 0) {
+      console.log(chalk.yellow('No sources configured. Use `tools-cc -s add` to add one.'));
+      return;
+    }
+    
+    const answers = await inquirer.prompt([
+      {
+        type: 'checkbox',
+        name: 'selectedSources',
+        message: 'Select sources to use:',
+        choices: sourceList
+      }
+    ]);
+    
+    sourceNames = answers.selectedSources;
+  }
+  
+  if (sourceNames.length === 0) {
+    console.log(chalk.gray('No sources selected.'));
+    return;
+  }
+  
+  // 初始化项目
+  await initProject(projectDir);
+  
+  // 启用每个配置源
+  for (const sourceName of sourceNames) {
+    try {
+      const sourcePath = await getSourcePath(sourceName, GLOBAL_CONFIG_DIR);
+      await useSource(sourceName, sourcePath, projectDir);
+      console.log(chalk.green(`✓ Using source: ${sourceName}`));
+    } catch (error) {
+      console.log(chalk.red(`✗ Failed to use ${sourceName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
+    }
+  }
+  
+  // 创建符号链接
+  const tools = options.projects || Object.keys(SUPPORTED_TOOLS);
+  const toolsccDir = getToolsccDir(projectDir);
+  
+  for (const tool of tools) {
+    const linkName = SUPPORTED_TOOLS[tool];
+    if (!linkName) {
+      console.log(chalk.yellow(`Unknown tool: ${tool}`));
+      continue;
+    }
+    
+    const linkPath = path.join(projectDir, linkName);
+    
+    try {
+      await createSymlink(toolsccDir, linkPath, true);
+      console.log(chalk.green(`✓ Linked: ${linkName} -> .toolscc`));
+    } catch (error) {
+      console.log(chalk.red(`✗ Failed to link ${linkName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
+    }
+  }
+  
+  // 更新项目配置
+  const configFile = path.join(projectDir, 'tools-cc.json');
+  const config = await fs.readJson(configFile);
+  const existingLinks = config.links || [];
+  config.links = [...new Set([...existingLinks, ...tools])];
+  await fs.writeJson(configFile, config, { spaces: 2 });
+}
+
+export async function handleList(): Promise<void> {
+  const projectDir = process.cwd();
+  const sources = await listUsedSources(projectDir);
+  
+  if (sources.length === 0) {
+    console.log(chalk.gray('No sources in use. Run `tools-cc use <source-name>` to add one.'));
+    return;
+  }
+  
+  console.log(chalk.bold('Sources in use:'));
+  for (const source of sources) {
+    console.log(`  ${chalk.cyan(source)}`);
+  }
+}
+
+export async function handleRemove(sourceName: string): Promise<void> {
+  const projectDir = process.cwd();
+  
+  try {
+    await unuseSource(sourceName, projectDir);
+    console.log(chalk.green(`✓ Removed source: ${sourceName}`));
+  } catch (error) {
+    console.log(chalk.red(`✗ ${error instanceof Error ? error.message : 'Unknown error'}`));
+  }
+}
+
+export async function handleStatus(): Promise<void> {
+  const projectDir = process.cwd();
+  const sources = await listUsedSources(projectDir);
+  
+  console.log(chalk.bold('\nProject Status:'));
+  console.log(chalk.gray(`  Directory: ${projectDir}`));
+  
+  // 检查 .toolscc
+  const toolsccDir = getToolsccDir(projectDir);
+  console.log(`  .toolscc: ${await fs.pathExists(toolsccDir) ? chalk.green('exists') : chalk.red('not found')}`);
+  
+  // 检查 sources
+  console.log(`  Sources: ${sources.length > 0 ? sources.map(s => chalk.cyan(s)).join(', ') : chalk.gray('none')}`);
+  
+  // 检查 links
+  const configFile = path.join(projectDir, 'tools-cc.json');
+  if (await fs.pathExists(configFile)) {
+    const config = await fs.readJson(configFile);
+    console.log(`  Links:`);
+    for (const tool of config.links || []) {
+      const linkName = SUPPORTED_TOOLS[tool];
+      if (!linkName) continue;
+      const linkPath = path.join(projectDir, linkName);
+      const isLink = await isSymlink(linkPath);
+      console.log(`    ${tool}: ${isLink ? chalk.green('linked') : chalk.red('not linked')}`);
+    }
+  }
+  console.log();
+}

package/src/core/config.ts

@@ -0,0 +1,37 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { GlobalConfig, ProjectConfig } from '../types';
+import { DEFAULT_CONFIG, getProjectConfigPath } from '../utils/path';
+
+export async function loadGlobalConfig(configDir: string): Promise<GlobalConfig> {
+  const configFile = path.join(configDir, 'config.json');
+  
+  if (!(await fs.pathExists(configFile))) {
+    await fs.ensureDir(configDir);
+    await fs.writeJson(configFile, DEFAULT_CONFIG, { spaces: 2 });
+    return DEFAULT_CONFIG;
+  }
+  
+  return await fs.readJson(configFile);
+}
+
+export async function saveGlobalConfig(config: GlobalConfig, configDir: string): Promise<void> {
+  const configFile = path.join(configDir, 'config.json');
+  await fs.ensureDir(configDir);
+  await fs.writeJson(configFile, config, { spaces: 2 });
+}
+
+export async function loadProjectConfig(projectDir: string): Promise<ProjectConfig | null> {
+  const configFile = getProjectConfigPath(projectDir);
+  
+  if (!(await fs.pathExists(configFile))) {
+    return null;
+  }
+  
+  return await fs.readJson(configFile);
+}
+
+export async function saveProjectConfig(config: ProjectConfig, projectDir: string): Promise<void> {
+  const configFile = getProjectConfigPath(projectDir);
+  await fs.writeJson(configFile, config, { spaces: 2 });
+}

package/src/core/manifest.ts

@@ -0,0 +1,57 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { Manifest } from '../types';
+
+export async function loadManifest(sourceDir: string): Promise<Manifest> {
+  const manifestPath = path.join(sourceDir, 'manifest.json');
+  
+  if (await fs.pathExists(manifestPath)) {
+    try {
+      return await fs.readJson(manifestPath);
+    } catch (error) {
+      throw new Error(`Failed to parse manifest.json: ${error instanceof Error ? error.message : 'Invalid JSON'}`);
+    }
+  }
+  
+  return scanSource(sourceDir);
+}
+
+export async function scanSource(sourceDir: string): Promise<Manifest> {
+  const name = path.basename(sourceDir);
+  const manifest: Manifest = {
+    name,
+    version: '0.0.0',
+    skills: [],
+    commands: [],
+    agents: []
+  };
+  
+  // Scan skills
+  const skillsDir = path.join(sourceDir, 'skills');
+  if (await fs.pathExists(skillsDir)) {
+    const entries = await fs.readdir(skillsDir, { withFileTypes: true });
+    manifest.skills = entries
+      .filter(e => e.isDirectory())
+      .map(e => e.name);
+  }
+  
+  // Scan commands
+  const commandsDir = path.join(sourceDir, 'commands');
+  if (await fs.pathExists(commandsDir)) {
+    const entries = await fs.readdir(commandsDir, { withFileTypes: true });
+    manifest.commands = entries
+      .filter(e => e.isFile() && e.name.endsWith('.md'))
+      .map(e => e.name.replace('.md', ''));
+  }
+  
+  // Scan agents
+  const agentsDir = path.join(sourceDir, 'agents');
+  if (await fs.pathExists(agentsDir)) {
+    const entries = await fs.readdir(agentsDir, { withFileTypes: true });
+    manifest.agents = entries
+      .filter(e => e.isFile() && e.name.endsWith('.md'))
+      .map(e => e.name.replace('.md', ''));
+  }
+  
+  return manifest;
+}