tools-cc 1.0.5 → 1.0.6

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 本项目的所有重要变更都将记录在此文件中。
 
+## [1.0.5] - 2026-02-28
+
+### Added
+- 新增部分导入功能：支持路径语法选择特定的 skills/commands/agents
+  - `tools-cc use source:skills/xxx` 只导入指定 skill
+  - `tools-cc use source:commands/` 导入所有 commands
+- 新增 `--ls` 模式：`tools-cc use --ls` 列出源内容而不创建链接
+- 新增 `tools-cc export` 命令：导出项目或全局配置到 JSON 文件
+  - `tools-cc export` 导出项目配置
+  - `tools-cc export -g` 导出全局配置
+- 新增 `codex` 工具支持，创建 `.codex -> .toolscc` 符号链接
+
+### Changed
+- 重构 `use` 命令，支持路径语法和 `--ls` 模式
+- 重构 `useSource` 核心逻辑，支持部分导入
+
+### Removed
+- 删除临时设计和实现文档 (docs/plans 目录)
+
 ## [1.0.4] - 2026-02-28
 
 ### Added
@@ -61,6 +80,7 @@
 | claude | `.claude` |
 | codebuddy | `.codebuddy` |
 | opencode | `.opencode` |
+| codex | `.codex` |
 
 ---
 

package/CHANGELOG_en.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.0.5] - 2026-02-28
+
+### Added
+- Added partial import feature: support path syntax to select specific skills/commands/agents
+  - `tools-cc use source:skills/xxx` import only specified skill
+  - `tools-cc use source:commands/` import all commands
+- Added `-ls` mode: `tools-cc use -ls` list source content without creating links
+- Added `tools-cc export` command: export project or global config to JSON file
+  - `tools-cc export` export project config
+  - `tools-cc export -g` export global config
+
+### Changed
+- Refactored `use` command to support path syntax and `-ls` mode
+- Refactored `useSource` core logic to support partial import
+
+### Removed
+- Removed temporary design and implementation docs (docs/plans directory)
+
 ## [1.0.4] - 2026-02-28
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # tools-cc
 
-一个用于统一管理多个 AI 编程工具（iflow、claude、codebuddy、opencode 等）的 skills/commands/agents 配置的 CLI 工具。通过符号链接机制，避免在多个工具间重复配置。
+一个用于统一管理多个 AI 编程工具（iflow、claude、codebuddy、opencode、codex 等）的 skills/commands/agents 配置的 CLI 工具。通过符号链接机制，避免在多个工具间重复配置。
 
 ## 安装
 
@@ -34,11 +34,11 @@ tools-cc -s list
 
 # 4. 在项目中启用配置源并创建链接
 cd my-project
-tools-cc use my-skills -p iflow claude
+tools-cc use my-skills -p iflow claude codex
 
 # 4a. 或使用部分引入（只引入需要的 skills/commands/agents）
 tools-cc use my-skills/skills/a-skill
-tools-cc use my-skills -ls                 # 交互式选择
+tools-cc use my-skills --ls                # 交互式选择
 
 # 4b. 或从配置文件快速导入
 tools-cc use -c project-config.json
@@ -119,7 +119,7 @@ tools-cc export [options]                 # 导出项目或全局配置
 ```bash
 # 整源引入（全部 skills/commands/agents）
 tools-cc use my-skills
-tools-cc use my-skills -p iflow claude    # 指定工具链接
+tools-cc use my-skills -p iflow claude codex    # 指定工具链接
 
 # 部分引入（路径语法）
 tools-cc use my-skills/skills/a-skill     # 引入单个 skill
@@ -127,14 +127,14 @@ tools-cc use my-skills/commands/test      # 引入单个 command
 tools-cc use my-skills/agents/reviewer    # 引入单个 agent
 tools-cc use my-skills/skills/a my-skills/commands/test  # 引入多项
 
-# 交互式选择（-ls 参数）
-tools-cc use my-skills -ls                # 分组展示，勾选引入
+# 交互式选择（--ls 参数）
+tools-cc use my-skills --ls               # 分组展示，勾选引入
 
 # 从配置文件导入
 tools-cc use -c project-config.json       # 快速恢复项目配置
 
 # 使用 "." 表示当前项目已配置的源（只创建链接，不复制内容）
-tools-cc use . -p iflow claude
+tools-cc use . -p iflow claude codex
 ```
 
 #### `export` 命令详解
@@ -178,6 +178,7 @@ tools-cc --version                        # 显示版本号
 | claude | `.claude` |
 | codebuddy | `.codebuddy` |
 | opencode | `.opencode` |
+| codex | `.codex` |
 
 ## 配置源结构
 
@@ -224,7 +225,8 @@ my-project/
 │   └── agents/
 │       └── my-skills/
 ├── .iflow -> .toolscc            # 符号链接
-└── .claude -> .toolscc
+├── .claude -> .toolscc
+└── .codex -> .toolscc
 ```
 
 ## 配置文件
@@ -258,7 +260,7 @@ my-project/
       "agents": ["*"]
     }
   },
-  "links": ["iflow", "claude"]
+  "links": ["iflow", "claude", "codex"]
 }
 ```
 

package/dist/commands/help.js

@@ -14,7 +14,7 @@ ${chalk_1.default.bold.cyan('═════════════════
 
 ${chalk_1.default.bold('DESCRIPTION / 描述')}
   A CLI tool for managing skills/commands/agents configurations across multiple
-  AI coding tools (iflow, claude, codebuddy, opencode, etc.) via symlinks.
+  AI coding tools (iflow, claude, codebuddy, opencode, codex, etc.) via symlinks.
   
   一个用于统一管理多个 AI 编程工具配置的命令行工具，通过符号链接机制避免重复配置。
 
@@ -55,6 +55,7 @@ ${chalk_1.default.bold('SUPPORTED TOOLS / 支持的工具')}
   claude     → .claude
   codebuddy  → .codebuddy
   opencode   → .opencode
+  codex      → .codex
 
 ${chalk_1.default.bold('EXAMPLES / 示例')}
   ${chalk_1.default.gray('# Add a git source / 添加 Git 配置源')}
@@ -67,7 +68,7 @@ ${chalk_1.default.bold('EXAMPLES / 示例')}
   tools-cc sources list
 
   ${chalk_1.default.gray('# Use sources in project / 在项目中启用配置源')}
-  tools-cc use my-skills -p iflow claude
+  tools-cc use my-skills -p iflow claude codex
 
   ${chalk_1.default.gray('# Check project status / 检查项目状态')}
   tools-cc status

package/dist/commands/use.d.ts

@@ -9,12 +9,12 @@ export interface UseOptions {
 /**
  * 处理 use 命令
  *
- * 支持多种模式：
+ * 支持多种模式�?
  * 1. 配置导入模式: tools-cc use -c config.json
- * 2. 交互选择模式: tools-cc use my-source -ls
+ * 2. 交互选择模式: tools-cc use my-source --ls
  * 3. 路径语法模式: tools-cc use my-source/skills/a-skill
  * 4. 整体导入模式: tools-cc use my-source
- * 5. 点模式: tools-cc use . (使用已配置源)
+ * 5. 点模�? tools-cc use . (使用已配置源)
  */
 export declare function handleUse(sourceSpecs: string[], options: UseOptions): Promise<void>;
 export declare function handleList(): Promise<void>;

package/dist/commands/use.js

@@ -22,25 +22,18 @@ const SUPPORTED_TOOLS = {
     iflow: '.iflow',
     claude: '.claude',
     codebuddy: '.codebuddy',
-    opencode: '.opencode'
-};
-/**
- * 默认选择配置 - 导入所有内容
- */
-const DEFAULT_SELECTION = {
-    skills: ['*'],
-    commands: ['*'],
-    agents: ['*']
+    opencode: '.opencode',
+    codex: '.codex'
 };
 /**
  * 处理 use 命令
  *
- * 支持多种模式：
+ * 支持多种模式�?
  * 1. 配置导入模式: tools-cc use -c config.json
- * 2. 交互选择模式: tools-cc use my-source -ls
+ * 2. 交互选择模式: tools-cc use my-source --ls
  * 3. 路径语法模式: tools-cc use my-source/skills/a-skill
  * 4. 整体导入模式: tools-cc use my-source
- * 5. 点模式: tools-cc use . (使用已配置源)
+ * 5. 点模�? tools-cc use . (使用已配置源)
  */
 async function handleUse(sourceSpecs, options) {
     const projectDir = process.cwd();
@@ -51,15 +44,15 @@ async function handleUse(sourceSpecs, options) {
         await handleConfigImportMode(options.config, projectDir, options.projects);
         return;
     }
-    // 2. 点模式：使用当前项目已配置的源
+    // 2. 点模式：使用当前项目已配置的�?
     if (sourceSpecs.length === 1 && sourceSpecs[0] === '.') {
         await handleDotMode(projectDir, toolsccDir, configFile, options.projects);
         return;
     }
-    // 3. 交互选择模式：单个源 + -ls 选项
+    // 3. 交互选择模式：单个源 + --ls 选项
     if (options.ls && sourceSpecs.length === 1) {
         const parsed = (0, parsePath_1.parseSourcePath)(sourceSpecs[0]);
-        // 只有源名称时才进入交互模式
+        // 只有源名称时才进入交互模�?
         if (!parsed.type && parsed.sourceName) {
             await handleInteractiveMode(parsed.sourceName, projectDir, options.projects);
             return;
@@ -75,17 +68,17 @@ async function handleUse(sourceSpecs, options) {
     }
     // 5. 解析路径语法并构建选择配置
     const selectionMap = (0, parsePath_1.buildSelectionFromPaths)(sourceSpecs);
-    // 初始化项目
+    // 初始化项�?
     await (0, project_1.initProject)(projectDir);
     // 应用每个源的选择配置
     for (const [sourceName, selection] of Object.entries(selectionMap)) {
         try {
             const sourcePath = await (0, source_1.getSourcePath)(sourceName, path_1.GLOBAL_CONFIG_DIR);
             await (0, project_1.useSource)(sourceName, sourcePath, projectDir, selection);
-            console.log(chalk_1.default.green(`✓ Using source: ${sourceName}`));
+            console.log(chalk_1.default.green(`�?Using source: ${sourceName}`));
         }
         catch (error) {
-            console.log(chalk_1.default.red(`✗ Failed to use ${sourceName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
+            console.log(chalk_1.default.red(`�?Failed to use ${sourceName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
         }
     }
     // 创建符号链接
@@ -100,18 +93,18 @@ async function handleConfigImportMode(configPath, projectDir, projects) {
         const configFile = (0, path_1.getProjectConfigPath)(projectDir);
         // 解析配置文件路径
         const resolvedPath = path_2.default.resolve(configPath);
-        // 定义源路径解析函数
+        // 定义源路径解析函�?
         const resolveSourcePath = async (sourceName) => {
             return await (0, source_1.getSourcePath)(sourceName, path_1.GLOBAL_CONFIG_DIR);
         };
         // 导入配置
         await (0, project_1.importProjectConfig)(resolvedPath, projectDir, resolveSourcePath);
-        console.log(chalk_1.default.green(`✓ Imported config from: ${resolvedPath}`));
+        console.log(chalk_1.default.green(`�?Imported config from: ${resolvedPath}`));
         // 创建符号链接
         await createToolLinks(projectDir, toolsccDir, configFile, projects);
     }
     catch (error) {
-        console.log(chalk_1.default.red(`✗ Failed to import config: ${error instanceof Error ? error.message : 'Unknown error'}`));
+        console.log(chalk_1.default.red(`�?Failed to import config: ${error instanceof Error ? error.message : 'Unknown error'}`));
     }
 }
 /**
@@ -132,7 +125,7 @@ async function handleDotMode(projectDir, toolsccDir, configFile, projects) {
     await createToolLinks(projectDir, toolsccDir, configFile, projects);
 }
 /**
- * 交互选择模式：显示技能/命令/代理选择列表
+ * 交互选择模式：显示技�?命令/代理选择列表
  */
 async function handleInteractiveMode(sourceName, projectDir, projects) {
     try {
@@ -141,21 +134,21 @@ async function handleInteractiveMode(sourceName, projectDir, projects) {
         // 构建选项列表
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const choices = [];
-        // Skills 组
+        // Skills �?
         if (manifest.skills && manifest.skills.length > 0) {
             choices.push(new inquirer_1.default.Separator(`--- Skills (${manifest.skills.length}) ---`));
             for (const skill of manifest.skills) {
                 choices.push({ name: skill, value: `skills/${skill}` });
             }
         }
-        // Commands 组
+        // Commands �?
         if (manifest.commands && manifest.commands.length > 0) {
             choices.push(new inquirer_1.default.Separator(`--- Commands (${manifest.commands.length}) ---`));
             for (const cmd of manifest.commands) {
                 choices.push({ name: cmd, value: `commands/${cmd}` });
             }
         }
-        // Agents 组
+        // Agents �?
         if (manifest.agents && manifest.agents.length > 0) {
             choices.push(new inquirer_1.default.Separator(`--- Agents (${manifest.agents.length}) ---`));
             for (const agent of manifest.agents) {
@@ -180,7 +173,7 @@ async function handleInteractiveMode(sourceName, projectDir, projects) {
             console.log(chalk_1.default.gray('No items selected.'));
             return;
         }
-        // 将选择转换为 SourceSelection
+        // 将选择转换�?SourceSelection
         const selection = {
             skills: [],
             commands: [],
@@ -198,14 +191,14 @@ async function handleInteractiveMode(sourceName, projectDir, projects) {
         // 初始化项目并应用选择
         await (0, project_1.initProject)(projectDir);
         await (0, project_1.useSource)(sourceName, sourcePath, projectDir, selection);
-        console.log(chalk_1.default.green(`✓ Using source: ${sourceName}`));
+        console.log(chalk_1.default.green(`�?Using source: ${sourceName}`));
         // 创建符号链接
         const toolsccDir = (0, path_1.getToolsccDir)(projectDir);
         const configFile = (0, path_1.getProjectConfigPath)(projectDir);
         await createToolLinks(projectDir, toolsccDir, configFile, projects);
     }
     catch (error) {
-        console.log(chalk_1.default.red(`✗ Failed to use ${sourceName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
+        console.log(chalk_1.default.red(`�?Failed to use ${sourceName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
     }
 }
 /**
@@ -242,10 +235,10 @@ async function createToolLinks(projectDir, toolsccDir, configFile, projects) {
         const linkPath = path_2.default.join(projectDir, linkName);
         try {
             await (0, symlink_1.createSymlink)(toolsccDir, linkPath, true);
-            console.log(chalk_1.default.green(`✓ Linked: ${linkName} -> .toolscc`));
+            console.log(chalk_1.default.green(`�?Linked: ${linkName} -> .toolscc`));
         }
         catch (error) {
-            console.log(chalk_1.default.red(`✗ Failed to link ${linkName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
+            console.log(chalk_1.default.red(`�?Failed to link ${linkName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
         }
     }
     // 更新项目配置
@@ -270,10 +263,10 @@ async function handleRemove(sourceName) {
     const projectDir = process.cwd();
     try {
         await (0, project_1.unuseSource)(sourceName, projectDir);
-        console.log(chalk_1.default.green(`✓ Removed source: ${sourceName}`));
+        console.log(chalk_1.default.green(`�?Removed source: ${sourceName}`));
     }
     catch (error) {
-        console.log(chalk_1.default.red(`✗ ${error instanceof Error ? error.message : 'Unknown error'}`));
+        console.log(chalk_1.default.red(`�?${error instanceof Error ? error.message : 'Unknown error'}`));
     }
 }
 async function handleStatus() {
@@ -281,12 +274,12 @@ async function handleStatus() {
     const sources = await (0, project_1.listUsedSources)(projectDir);
     console.log(chalk_1.default.bold('\nProject Status:'));
     console.log(chalk_1.default.gray(`  Directory: ${projectDir}`));
-    // 检查 .toolscc
+    // 检�?.toolscc
     const toolsccDir = (0, path_1.getToolsccDir)(projectDir);
     console.log(`  .toolscc: ${await fs_extra_1.default.pathExists(toolsccDir) ? chalk_1.default.green('exists') : chalk_1.default.red('not found')}`);
-    // 检查 sources
+    // 检�?sources
     console.log(`  Sources: ${sources.length > 0 ? sources.map(s => chalk_1.default.cyan(s)).join(', ') : chalk_1.default.gray('none')}`);
-    // 检查 links
+    // 检�?links
     const configFile = (0, path_1.getProjectConfigPath)(projectDir);
     if (await fs_extra_1.default.pathExists(configFile)) {
         const config = await fs_extra_1.default.readJson(configFile);
@@ -305,7 +298,7 @@ async function handleStatus() {
 async function handleProjectUpdate(sourceNames) {
     const projectDir = process.cwd();
     const configFile = (0, path_1.getProjectConfigPath)(projectDir);
-    // 检查项目是否已初始化
+    // 检查项目是否已初始�?
     if (!(await fs_extra_1.default.pathExists(configFile))) {
         console.log(chalk_1.default.yellow('Project not initialized. Run `tools-cc use <source>` first.'));
         return;
@@ -327,18 +320,18 @@ async function handleProjectUpdate(sourceNames) {
         }
         sourcesToUpdate = sourcesToUpdate.filter((s) => configuredSources.includes(s));
     }
-    // 更新每个配置源
+    // 更新每个配置�?
     for (const sourceName of sourcesToUpdate) {
         try {
             const sourcePath = await (0, source_1.getSourcePath)(sourceName, path_1.GLOBAL_CONFIG_DIR);
             // 使用保存的选择配置进行更新
             const selection = config.sources[sourceName];
             await (0, project_1.useSource)(sourceName, sourcePath, projectDir, selection);
-            console.log(chalk_1.default.green(`✓ Updated source: ${sourceName}`));
+            console.log(chalk_1.default.green(`�?Updated source: ${sourceName}`));
         }
         catch (error) {
-            console.log(chalk_1.default.red(`✗ Failed to update ${sourceName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
+            console.log(chalk_1.default.red(`�?Failed to update ${sourceName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
         }
     }
-    console.log(chalk_1.default.green(`\n✓ Project update complete`));
+    console.log(chalk_1.default.green(`\n�?Project update complete`));
 }

package/dist/index.js

@@ -80,8 +80,8 @@ configCmd
 program
     .command('use [sources...]')
     .description('Use sources in current project')
-    .option('-p, --projects <tools...>', 'Tools to link (iflow, claude, codebuddy, opencode)')
-    .option('-ls', 'Interactive selection mode for single source')
+    .option('-p, --projects <tools...>', 'Tools to link (iflow, claude, codebuddy, opencode, codex)')
+    .option('-l, --ls', 'Interactive selection mode for single source')
     .option('-c, --config <file>', 'Import from config file')
     .action(async (sources, options) => {
     await (0, use_1.handleUse)(sources, options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tools-cc",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "tools-cc [options] <command> [args]",
   "main": "index.js",
   "directories": {

package/src/commands/help.ts

@@ -9,7 +9,7 @@ ${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 coding tools (iflow, claude, codebuddy, opencode, codex, etc.) via symlinks.
   
   一个用于统一管理多个 AI 编程工具配置的命令行工具，通过符号链接机制避免重复配置。
 
@@ -50,6 +50,7 @@ ${chalk.bold('SUPPORTED TOOLS / 支持的工具')}
   claude     → .claude
   codebuddy  → .codebuddy
   opencode   → .opencode
+  codex      → .codex
 
 ${chalk.bold('EXAMPLES / 示例')}
   ${chalk.gray('# Add a git source / 添加 Git 配置源')}
@@ -62,7 +63,7 @@ ${chalk.bold('EXAMPLES / 示例')}
   tools-cc sources list
 
   ${chalk.gray('# Use sources in project / 在项目中启用配置源')}
-  tools-cc use my-skills -p iflow claude
+  tools-cc use my-skills -p iflow claude codex
 
   ${chalk.gray('# Check project status / 检查项目状态')}
   tools-cc status