tools-manager 0.1.0 → 0.1.1

package/README.md

@@ -2,6 +2,8 @@
 
 [中文文档](README.zh-CN.md)
 
+GitHub: [pipihua666/tools-manager](https://github.com/pipihua666/tools-manager)
+
 Tools Manager (`tm`) is a Bun-powered CLI for managing AI agent skills and MCP server configuration across Codex, Claude Code, and Cursor.
 
 It gives you one local source of truth for:
@@ -42,13 +44,20 @@ For source checkout usage, see [Development](#development).
 
 ## Quick Start
 
-Import all existing local agent skills into Tools Manager, then apply the default preset back to all supported agents:
+Import all existing local agent skills into Tools Manager, then sync them back to all supported agents:
 
 ```bash
+# Create the Tools Manager home directory and default config.
 tm init
+
+# Import existing skills from Codex, Claude Code, and Cursor.
 tm skills add --tool all
+
+# Show the skills now managed by Tools Manager.
 tm skills list
-tm presets apply
+
+# Sync the default skill group back to all supported agents.
+tm skills sync
 ```
 
 If you have not linked or installed the package yet, use:
@@ -57,7 +66,7 @@ If you have not linked or installed the package yet, use:
 bun run tm init
 bun run tm skills add --tool all
 bun run tm skills list
-bun run tm presets apply
+bun run tm skills sync
 ```
 
 By default, Tools Manager writes state to:
@@ -150,11 +159,21 @@ tm skills sync --mode copy
 tm skills sync Work --tool codex --mode symlink
 ```
 
-`tm skills sync` uses the same preset behavior as `tm presets apply`: it defaults to preset `Default` and tool `all`. Use `--mode symlink` or `--mode copy` to override the configured sync mode for that run.
+`tm skills sync` is the main command for making agent tools see your managed skills.
+
+Defaults:
+
+- `tm skills sync` syncs preset `Default`
+- `tm skills sync` syncs to `--tool all`, which means Codex, Claude Code, and Cursor
+- `tm skills sync` uses the configured `sync_mode`; pass `--mode symlink` or `--mode copy` to override it for one run
+
+In short: after adding or moving skills, run `tm skills sync`.
 
 ## Skill Presets
 
-Skill presets are named groups of skills. Imported skills are added to the `Default` preset automatically.
+Skill presets are named groups of skills. They help you decide which skills should be synced together.
+
+For example, you can keep everyday skills in `Default`, and work-only skills in `Work`. Imported skills are added to `Default` automatically.
 
 List skill presets:
 
@@ -174,19 +193,7 @@ Move all skills from one skill preset to another:
 tm presets move Default Work
 ```
 
-Apply a preset to agent skill directories:
-
-```bash
-tm presets apply
-tm presets apply Work --tool cursor
-tm presets apply --mode copy
-```
-
-Defaults:
-
-- `tm presets apply` uses preset `Default`
-- `tm presets apply` uses `--tool all`
-- `tm presets apply` uses `sync_mode` from config unless `--mode symlink|copy` is provided
+After changing preset membership, use `tm skills sync` to update agent skill directories.
 
 ## MCP Servers
 
@@ -272,7 +279,6 @@ tm skills show <name> [--json]
 tm skills remove <name> [--yes]
 tm skills sync [preset] [--tool <tool|all>] [--mode <symlink|copy>]
 tm presets list [--json]
-tm presets apply [preset] [--tool <tool|all>] [--mode <symlink|copy>]
 tm presets move-skill <skill> <from> <to>
 tm presets move <from> <to>
 tm mcp add <name> --command <cmd> [--arg value] [--env K=V] [--tool <tool|all>]

package/README.zh-CN.md

@@ -2,6 +2,8 @@
 
 [English](README.md)
 
+GitHub: [pipihua666/tools-manager](https://github.com/pipihua666/tools-manager)
+
 Tools Manager (`tm`) 是一个基于 Bun 的 CLI，用来统一管理 Codex、Claude Code 和 Cursor 等 AI Agent 的 skills 与 MCP server 配置。
 
 它提供一个本地统一管理入口：
@@ -41,13 +43,20 @@ tm status
 
 ## 快速开始
 
-先把所有本地 Agent 里已有的 skills 导入 Tools Manager，再把默认 preset 应用回所有支持的 Agent：
+先把所有本地 Agent 里已有的 skills 导入 Tools Manager，再同步回所有支持的 Agent：
 
 ```bash
+# 创建 Tools Manager 的本地管理目录和默认配置。
 tm init
+
+# 从 Codex、Claude Code、Cursor 导入已有 skills。
 tm skills add --tool all
+
+# 查看当前由 Tools Manager 托管的 skills。
 tm skills list
-tm presets apply
+
+# 把默认 skill 分组同步回所有支持的 Agent。
+tm skills sync
 ```
 
 如果还没有 link 或安装这个包，可以使用：
@@ -56,7 +65,7 @@ tm presets apply
 bun run tm init
 bun run tm skills add --tool all
 bun run tm skills list
-bun run tm presets apply
+bun run tm skills sync
 ```
 
 默认情况下，Tools Manager 会把状态写入：
@@ -149,11 +158,21 @@ tm skills sync --mode copy
 tm skills sync Work --tool codex --mode symlink
 ```
 
-`tm skills sync` 与 `tm presets apply` 使用相同的 preset 行为：默认 preset 是 `Default`，默认 tool 是 `all`。使用 `--mode symlink` 或 `--mode copy` 可以覆盖本次同步的配置模式。
+`tm skills sync` 是让 Agent 工具看到托管 skills 的主命令。
+
+默认行为：
+
+- `tm skills sync` 同步 `Default` preset
+- `tm skills sync` 同步到 `--tool all`，也就是 Codex、Claude Code 和 Cursor
+- `tm skills sync` 使用配置里的 `sync_mode`；传入 `--mode symlink` 或 `--mode copy` 可以覆盖本次执行
+
+简单理解：添加或移动 skills 后，执行 `tm skills sync`。
 
 ## Skill Presets
 
-Skill presets 是命名的 skill 分组。导入的 skills 会自动加入 `Default` preset。
+Skill presets 是命名的 skill 分组，用来决定哪些 skills 要一起同步。
+
+例如，日常使用的 skills 可以放在 `Default`，工作专用的 skills 可以放在 `Work`。导入的 skills 会自动加入 `Default`。
 
 列出 skill presets：
 
@@ -173,19 +192,7 @@ tm presets move-skill my-skill Default Work
 tm presets move Default Work
 ```
 
-把 preset 应用到 Agent skill 目录：
-
-```bash
-tm presets apply
-tm presets apply Work --tool cursor
-tm presets apply --mode copy
-```
-
-默认行为：
-
-- `tm presets apply` 使用 preset `Default`
-- `tm presets apply` 使用 `--tool all`
-- `tm presets apply` 默认使用配置里的 `sync_mode`，传入 `--mode symlink|copy` 时覆盖本次执行
+调整 preset 分组后，使用 `tm skills sync` 更新 Agent skill 目录。
 
 ## MCP Servers
 
@@ -271,7 +278,6 @@ tm skills show <name> [--json]
 tm skills remove <name> [--yes]
 tm skills sync [preset] [--tool <tool|all>] [--mode <symlink|copy>]
 tm presets list [--json]
-tm presets apply [preset] [--tool <tool|all>] [--mode <symlink|copy>]
 tm presets move-skill <skill> <from> <to>
 tm presets move <from> <to>
 tm mcp add <name> --command <cmd> [--arg value] [--env K=V] [--tool <tool|all>]

package/docs/remote-skill-repositories.md

@@ -23,6 +23,19 @@ tm skills add 'git@github.com:you/my-skill-repo.git'
 
 Use this layout when one repository contains multiple skills:
 
+```text
+my-skills-repo/
+  skills/
+    skill-a/
+      SKILL.md
+    skill-b/
+      SKILL.md
+    skill-c/
+      SKILL.md
+```
+
+The `skills/` directory is optional. Tools Manager scans recursively from the selected import root, so this also works:
+
 ```text
 my-skills-repo/
   skill-a/
@@ -33,7 +46,13 @@ my-skills-repo/
     SKILL.md
 ```
 
-Import all skills under the shared directory:
+Import all skills from the repository:
+
+```bash
+tm skills add 'git@github.com:you/my-skills-repo.git#main'
+```
+
+Or import all skills under the `skills/` directory explicitly:
 
 ```bash
 tm skills add 'git@github.com:you/my-skills-repo.git#main:skills'
@@ -42,7 +61,7 @@ tm skills add 'git@github.com:you/my-skills-repo.git#main:skills'
 Or import a specific skill by providing the branch, tag, or commit and the skill subpath:
 
 ```bash
-tm skills add 'git@github.com:you/my-skills-repo.git#main:skill-a'
+tm skills add 'git@github.com:you/my-skills-repo.git#main:skills/skill-a'
 ```
 
 The Git source format is:

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "tools-manager",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A Bun CLI for managing AI agent skills and MCP server configuration across tools.",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pipihua666/tools-manager.git"
+  },
+  "homepage": "https://github.com/pipihua666/tools-manager#readme",
+  "bugs": {
+    "url": "https://github.com/pipihua666/tools-manager/issues"
+  },
   "type": "module",
   "bin": {
     "tm": "./dist/cli.js"