@remixmate/cli 0.9.22 → 0.9.23

package/README.md

@@ -16,15 +16,27 @@ npm install -g @remixmate/cli && remixmate install
 
 `npm install` gives you the `remixmate` binary. `remixmate install` is what makes an
 agent *discover* the skills on its own: it copies the bundled `skills/` into every
-agent home it finds — Claude Code (`~/.claude/skills`) and Codex (`$CODEX_HOME/skills`,
-default `~/.codex/skills`), which share the same `SKILL.md` format. Restart the agent
+agent home it finds. All of these hosts read the same `SKILL.md` format, so one
+`skills/` directory serves all of them:
+
+| Host | User-level | Project-level | Override |
+| --- | --- | --- | --- |
+| Claude Code | `~/.claude/skills` | `./.claude/skills` | `CLAUDE_CONFIG_DIR` |
+| Codex | `~/.codex/skills` | — | `CODEX_HOME` |
+| WorkBuddy | `~/.workbuddy/skills` | `./.workbuddy/skills` | — |
+| CodeBuddy | `~/.codebuddy/skills` | `./.codebuddy/skills` | — |
+| Trae / TraeWork | — | `./.trae/skills` | — |
+
+Trae CN and TraeWork CN share `~/.trae-cn` and only define a workspace location (`.trae/skills/<name>/`, per its own built-in
+`skill-creator`), so it is installed per project — a plain `remixmate install` reports
+it and tells you to re-run with `--project` inside the repo. Restart the agent
 afterwards.
 
 ```bash
-remixmate install --host codex     # only one host
-remixmate install --project        # ./.claude/skills (Claude Code only)
-remixmate install --dir <path>     # explicit target
-remixmate uninstall                # remove exactly what was installed
+remixmate install --host workbuddy  # only one host
+remixmate install --project         # ./<config-dir>/skills (not Codex — it has none)
+remixmate install --dir <path>      # explicit target, for a host not listed above
+remixmate uninstall                 # remove exactly what was installed
 ```
 
 The install is *managed*, not a `cp -R`: each skills directory gets a

package/README.zh-CN.md

@@ -15,15 +15,26 @@ npm install -g @remixmate/cli && remixmate install
 ```
 
 `npm install` 装的是 `remixmate` 这个命令；`remixmate install` 才让 agent **自己发现**
-这些 skill —— 它把内置的 `skills/` 铺进检测到的每个 agent 目录：Claude Code
-（`~/.claude/skills`）与 Codex（`$CODEX_HOME/skills`，默认 `~/.codex/skills`），两者
-用的是同一套 `SKILL.md` 格式。装完重启 agent 生效。
+这些 skill —— 它把内置的 `skills/` 铺进检测到的每个 agent 目录。下面这些宿主用的是
+同一套 `SKILL.md` 格式，所以一份 `skills/` 全都能喂：
+
+| 宿主 | 用户级 | 项目级 | 可用环境变量改位置 |
+| --- | --- | --- | --- |
+| Claude Code | `~/.claude/skills` | `./.claude/skills` | `CLAUDE_CONFIG_DIR` |
+| Codex | `~/.codex/skills` | — | `CODEX_HOME` |
+| WorkBuddy | `~/.workbuddy/skills` | `./.workbuddy/skills` | — |
+| CodeBuddy | `~/.codebuddy/skills` | `./.codebuddy/skills` | — |
+| Trae / TraeWork | — | `./.trae/skills` | — |
+
+Trae CN 与 TraeWork CN 共用 `~/.trae-cn`，且只定义了工作区位置（`.trae/skills/<name>/`，依据是它自带的 `skill-creator`），
+所以只能按项目装 —— 直接跑 `remixmate install` 会提示你进项目目录加 `--project` 重跑。
+装完重启 agent 生效。
 
 ```bash
-remixmate install --host codex     # 只装某一个宿主
-remixmate install --project        # 装到 ./.claude/skills（仅 Claude Code）
-remixmate install --dir <path>     # 指定目录
-remixmate uninstall                # 按装机记录精确卸载
+remixmate install --host workbuddy  # 只装某一个宿主
+remixmate install --project         # 装到 ./<配置目录>/skills（Codex 没有项目级目录）
+remixmate install --dir <path>      # 指定目录，用于上表之外的宿主
+remixmate uninstall                 # 按装机记录精确卸载
 ```
 
 这里的安装是**受管**的，不是 `cp -R`：每个 skills 目录下会写一份

package/dist/doctor.js

@@ -166,7 +166,9 @@ export async function runDoctor(opts = {}) {
     if (!opts.skipNetwork)
         checks.push(await checkBackend(apiBaseUrl));
     for (const c of checks) {
-        process.stdout.write(`${ICON[c.status]} ${padDisplay(c.name, 14)}${c.detail}\n`);
+        // 16 而不是 14：宿主检查名最长是「WorkBuddy skill」，窄一格就会把那两行的
+        // detail 列顶出去，报告看起来像是漏了对齐。
+        process.stdout.write(`${ICON[c.status]} ${padDisplay(c.name, 16)}${c.detail}\n`);
     }
     const failed = checks.filter((c) => c.status === 'fail');
     if (failed.length === 0) {

package/dist/install.d.ts

@@ -21,18 +21,22 @@
  */
 export declare const INSTALL_VERB = "install";
 export declare const UNINSTALL_VERB = "uninstall";
-export type HostId = 'claude' | 'codex';
+export type HostId = 'claude' | 'codex' | 'workbuddy' | 'codebuddy' | 'trae';
 interface Host {
     id: HostId | 'custom';
     label: string;
     /** skill 的父目录 —— 安装写到 <skillsDir>/<skill-name>/。 */
     skillsDir: string;
 }
+/** 已检测到、且**有用户级位置**的宿主。 */
+export declare function detectHosts(): Host[];
 /**
- * 检测「这台机器上用了哪些 agent」。判据是配置根目录存在，而不是 skills/ 存在 ——
- * 从没装过 skill 的用户 skills/ 本来就没有，那恰恰是最需要装的人。
+ * 检测到了、但只能项目级安装的宿主（当前只有 Trae）。
+ *
+ * 单独拎出来是为了别把它们**静默**跳过：用户装了 Trae 却在全局 install 的输出里
+ * 完全看不到它，只会以为这个 CLI 不支持 —— 正是这次 WorkBuddy 的翻车方式。
  */
-export declare function detectHosts(): Host[];
+export declare function projectOnlyHosts(): HostId[];
 export declare function installUsage(): void;
 export declare function uninstallUsage(): void;
 export declare function runInstall(argv: string[]): number;

package/dist/install.js

@@ -34,27 +34,118 @@ const PKG_ROOT = path.resolve(__dirname, '..');
 const RECEIPT = '.remixmate-install.json';
 const PACKAGE_NAME = '@remixmate/cli';
 /**
- * 宿主的配置根目录。两个 agent 都允许用环境变量改位置，检测必须跟着走 ——
- * 否则把 CODEX_HOME 指到别处的用户会看到「未检测到 Codex」。
+ * 支持的 agent 宿主。
+ *
+ * 共同点是 skill 的格式：`<某个目录>/skills/<name>/SKILL.md`，frontmatter 都是
+ * name + description —— 一份 skills/ 能喂给所有宿主。这张表记的是各家把那个「某个
+ * 目录」放在哪、能不能被环境变量改、有没有用户级 / 项目级。
+ *
+ * 每一条的依据：
+ *   - Claude Code / Codex：各自的官方安装位置（Codex 见其内置 skill-installer，
+ *     原话是装到 $CODEX_HOME/skills）。
+ *   - WorkBuddy / CodeBuddy：WorkBuddy 内置的 find-skills skill 给了两条路径,
+ *     它按 __CFBundleIdentifier 区分。这里不做那个区分 —— 检测到哪个装哪个,
+ *     两个都在就都装,比猜「当前跑在哪个客户端里」稳。
+ *   - Trae：内置的 skill-creator skill 只给了一个位置 —— 工作区的
+ *     `.trae/skills/<name>/`。注意它的应用数据目录叫 ~/.trae-cn(国内版),
+ *     跟 skill 目录名 .trae 不是一个东西,而且 ~/.trae-cn/skills 并不存在。
+ *     没有任何证据表明存在用户级位置,所以 userDirName 留空:Trae 只能项目级装。
+ */
+const HOSTS = [
+    {
+        id: 'claude',
+        label: 'Claude Code',
+        detectDirNames: ['.claude'],
+        homeEnv: 'CLAUDE_CONFIG_DIR',
+        userDirName: '.claude',
+        projectDirName: '.claude',
+    },
+    {
+        id: 'codex',
+        label: 'Codex',
+        detectDirNames: ['.codex'],
+        homeEnv: 'CODEX_HOME',
+        userDirName: '.codex',
+    },
+    {
+        id: 'workbuddy',
+        label: 'WorkBuddy',
+        detectDirNames: ['.workbuddy'],
+        userDirName: '.workbuddy',
+        projectDirName: '.workbuddy',
+    },
+    {
+        id: 'codebuddy',
+        label: 'CodeBuddy',
+        detectDirNames: ['.codebuddy'],
+        userDirName: '.codebuddy',
+        projectDirName: '.codebuddy',
+    },
+    {
+        id: 'trae',
+        // Trae CN 与 TraeWork CN（安装出来叫 TRAE SOLO CN.app，bundle id cn.trae.solo.app）
+        // 共用 ~/.trae-cn —— 后者的内置 skill(dynamic-ui 等)就躺在那底下的
+        // builtin/*/skills/，所以一条 host 覆盖两个客户端。
+        label: 'Trae / TraeWork',
+        detectDirNames: ['.trae-cn', '.trae'],
+        projectDirName: '.trae',
+    },
+];
+const HOST_IDS = HOSTS.map((h) => h.id);
+function spec(id) {
+    return HOSTS.find((h) => h.id === id);
+}
+/**
+ * 用户级 skills 目录；宿主没有用户级位置时返回 null。声明了环境变量的宿主要跟着
+ * 变量走 —— 否则把 CODEX_HOME 指到别处的用户会看到「未检测到 Codex」。
  */
-function hostHome(id) {
-    return id === 'claude'
-        ? process.env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), '.claude')
-        : process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
+function userSkillsDir(id) {
+    const h = spec(id);
+    if (!h.userDirName)
+        return null;
+    const override = h.homeEnv ? process.env[h.homeEnv] : undefined;
+    return path.join(override || path.join(os.homedir(), h.userDirName), 'skills');
+}
+/** 检测用的候选目录 —— 存在任意一个就算这台机器上装了这个 agent。 */
+function detectDirs(id) {
+    const h = spec(id);
+    const override = h.homeEnv ? process.env[h.homeEnv] : undefined;
+    if (override)
+        return [override];
+    return h.detectDirNames.map((d) => path.join(os.homedir(), d));
+}
+function isInstalled(id) {
+    return detectDirs(id).some((d) => existsSync(d));
 }
-const HOST_LABEL = {
-    claude: 'Claude Code',
-    codex: 'Codex',
-};
 function hostOf(id) {
-    return { id, label: HOST_LABEL[id], skillsDir: path.join(hostHome(id), 'skills') };
+    const dir = userSkillsDir(id);
+    return dir ? { id, label: spec(id).label, skillsDir: dir } : null;
+}
+/** 项目级安装目标：当前目录下的 ./<projectDirName>/skills。 */
+function projectHostOf(id) {
+    const h = spec(id);
+    if (!h.projectDirName)
+        return null;
+    return {
+        id,
+        label: `${h.label}（项目级）`,
+        skillsDir: path.join(process.cwd(), h.projectDirName, 'skills'),
+    };
+}
+/** 已检测到、且**有用户级位置**的宿主。 */
+export function detectHosts() {
+    return HOST_IDS.filter(isInstalled)
+        .map(hostOf)
+        .filter((h) => h !== null);
 }
 /**
- * 检测「这台机器上用了哪些 agent」。判据是配置根目录存在，而不是 skills/ 存在 ——
- * 从没装过 skill 的用户 skills/ 本来就没有，那恰恰是最需要装的人。
+ * 检测到了、但只能项目级安装的宿主（当前只有 Trae）。
+ *
+ * 单独拎出来是为了别把它们**静默**跳过：用户装了 Trae 却在全局 install 的输出里
+ * 完全看不到它，只会以为这个 CLI 不支持 —— 正是这次 WorkBuddy 的翻车方式。
  */
-export function detectHosts() {
-    return ['claude', 'codex'].filter((id) => existsSync(hostHome(id))).map(hostOf);
+export function projectOnlyHosts() {
+    return HOST_IDS.filter((id) => isInstalled(id) && !spec(id).userDirName);
 }
 function packageVersion() {
     try {
@@ -91,9 +182,11 @@ function readReceipt(skillsDir) {
         return null;
     }
 }
+const nonNull = (h) => h !== null;
 function parseArgs(argv, verb) {
     const out = { hosts: [], force: false, help: false };
     const picked = [];
+    let all = false;
     let dir = '';
     let project = false;
     for (let i = 0; i < argv.length; i++) {
@@ -105,12 +198,14 @@ function parseArgs(argv, verb) {
         switch (key) {
             case '--host': {
                 const v = next();
+                // `all` 是「所有**适用**的宿主」，不是「表里每一行」—— 展开成后者会让
+                // `--host all` 撞上 Trae 这种只有项目级的宿主而整条命令失败。
                 if (v === 'all')
-                    picked.push('claude', 'codex');
-                else if (v === 'claude' || v === 'codex')
+                    all = true;
+                else if (HOST_IDS.includes(v))
                     picked.push(v);
                 else {
-                    out.unknown = `--host ${v}`;
+                    out.error = `未知参数: --host ${v}`;
                     return out;
                 }
                 break;
@@ -129,35 +224,64 @@ function parseArgs(argv, verb) {
                 out.help = true;
                 return out;
             default:
-                out.unknown = a;
+                out.error = `未知参数: ${a}`;
                 return out;
         }
     }
     if (dir) {
         out.hosts = [{ id: 'custom', label: '自定义目录', skillsDir: path.resolve(dir) }];
+        return out;
     }
-    else if (project) {
-        // 只有 Claude Code 有项目级 skill 目录。Codex 的官方安装位置只有
-        // $CODEX_HOME/skills(见其内置 skill-installer),没有项目级约定,不臆造一个。
-        out.hosts = [{ id: 'claude', label: 'Claude Code（项目级）', skillsDir: path.join(process.cwd(), '.claude', 'skills') }];
+    if (project) {
+        // Codex 的官方安装位置只有 $CODEX_HOME/skills（见其内置 skill-installer），
+        // 没有项目级约定,不臆造一个 —— 点名 --host codex --project 直接报错,
+        // 不声不响装到一个宿主永远不会读的目录才是最糟的。
+        const chosen = all
+            ? HOST_IDS.filter((id) => spec(id).projectDirName)
+            : picked.length > 0
+                ? [...new Set(picked)]
+                : HOST_IDS.filter((id) => isInstalled(id) && spec(id).projectDirName);
+        const unsupported = chosen.filter((id) => !spec(id).projectDirName);
+        if (unsupported.length > 0) {
+            out.error = `${unsupported.map((id) => spec(id).label).join('、')} 没有项目级 skill 目录，不能和 --project 一起用`;
+            return out;
+        }
+        out.hosts = chosen.map(projectHostOf).filter(nonNull);
+        return out;
+    }
+    if (all) {
+        out.hosts = HOST_IDS.map(hostOf).filter(nonNull);
+        return out;
     }
-    else if (picked.length > 0) {
-        out.hosts = [...new Set(picked)].map(hostOf);
+    if (picked.length > 0) {
+        const chosen = [...new Set(picked)];
+        // 点名了一个只有项目级的宿主(Trae)却没给 --project:报错而不是默默装到别处。
+        const userless = chosen.filter((id) => !spec(id).userDirName);
+        if (userless.length > 0) {
+            out.error =
+                `${userless.map((id) => spec(id).label).join('、')} 只有项目级 skill 目录 —— ` +
+                    '进到项目根目录后加 --project 重跑。';
+            return out;
+        }
+        out.hosts = chosen.map(hostOf).filter(nonNull);
     }
     else {
-        out.hosts = verb === UNINSTALL_VERB ? ['claude', 'codex'].map(hostOf) : detectHosts();
+        // 卸载时不做检测:配置目录可能已经随 agent 一起被删掉,而我们铺出去的副本还在。
+        out.hosts = verb === UNINSTALL_VERB ? HOST_IDS.map(hostOf).filter(nonNull) : detectHosts();
     }
     return out;
 }
 export function installUsage() {
     process.stdout.write('Usage: remixmate install [options]\n' +
         '\n' +
-        '把本包自带的 skill 装进已检测到的 agent 宿主，让它们能自动发现这些能力\n' +
-        '（Claude Code: ~/.claude/skills，Codex: ~/.codex/skills）。重复运行即升级。\n' +
+        '把本包自带的 skill 装进已检测到的 agent 宿主，让它们能自动发现这些能力。\n' +
+        '重复运行即升级。支持的宿主：\n' +
+        HOSTS.map((h) => `  ${padDisplay(h.label, 14)}${h.userDirName ? `~/${h.userDirName}/skills` : '（仅项目级）'}${h.projectDirName ? `   项目级 ./${h.projectDirName}/skills` : ''}\n`).join('') +
         '\n' +
         'Options:\n' +
-        '  --host <claude|codex|all>  只装指定宿主（默认：装到所有检测到的宿主）\n' +
-        '  --project                  装到当前目录 ./.claude/skills（仅 Claude Code）\n' +
+        `  --host <${HOST_IDS.join('|')}|all>\n` +
+        '                             只装指定宿主（默认：装到所有检测到的宿主）\n' +
+        '  --project                  装到当前目录 ./<配置目录>/skills（Codex 不支持）\n' +
         '  --dir <path>               自定义 skills 父目录（覆盖上面两者）\n' +
         '  --force                    覆盖同名的、非本 CLI 安装的 skill 目录\n');
 }
@@ -167,7 +291,8 @@ export function uninstallUsage() {
         '按装机回执删除本 CLI 装过的 skill —— 只删回执里列出的目录，不碰其它 skill。\n' +
         '\n' +
         'Options:\n' +
-        '  --host <claude|codex|all>  只卸载指定宿主（默认：两个宿主都查）\n' +
+        `  --host <${HOST_IDS.join('|')}|all>\n` +
+        '                             只卸载指定宿主（默认：所有宿主都查）\n' +
         '  --project                  卸载当前目录 ./.claude/skills 下的安装\n' +
         '  --dir <path>               自定义 skills 父目录\n');
 }
@@ -210,8 +335,8 @@ export function runInstall(argv) {
         installUsage();
         return EXIT.OK;
     }
-    if (opts.unknown) {
-        process.stderr.write(`❌ 未知参数: ${opts.unknown}\n`);
+    if (opts.error) {
+        process.stderr.write(`❌ ${opts.error}\n`);
         installUsage();
         return EXIT.USAGE;
     }
@@ -220,10 +345,17 @@ export function runInstall(argv) {
         process.stderr.write(`❌ 包内没有可安装的 skill（${SKILLS_DIR}）\n`);
         return EXIT.ERROR;
     }
+    const projectOnly = projectOnlyHosts();
     if (opts.hosts.length === 0) {
-        process.stderr.write('❌ 没有检测到任何 agent 宿主。找过这两个位置：\n' +
-            `     Claude Code  ${hostHome('claude')}\n` +
-            `     Codex        ${hostHome('codex')}\n` +
+        // 只检测到项目级宿主(比如只装了 Trae)时,这不是「没检测到」,而是「装法不同」。
+        if (projectOnly.length > 0) {
+            process.stderr.write(`❌ 只检测到 ${projectOnly.map((id) => spec(id).label).join('、')}，` +
+                '它只有项目级 skill 目录。\n' +
+                '   进到项目根目录后运行：remixmate install --project\n');
+            return EXIT.USAGE;
+        }
+        process.stderr.write('❌ 没有检测到任何 agent 宿主。找过这些位置：\n' +
+            HOST_IDS.map((id) => `     ${padDisplay(spec(id).label, 14)}${detectDirs(id).join('、')}\n`).join('') +
             '   先把 agent 装好再重跑，或用 --dir <path> 指定目录。\n');
         return EXIT.USAGE;
     }
@@ -240,6 +372,11 @@ export function runInstall(argv) {
     }
     if (failures > 0)
         return EXIT.ERROR;
+    // 检测到了但这一轮装不了的宿主要说出来 —— 静默跳过会让用户以为不支持。
+    if (projectOnly.length > 0 && !opts.hosts.some((h) => projectOnly.includes(h.id))) {
+        process.stdout.write(`\nℹ️  还检测到 ${projectOnly.map((id) => spec(id).label).join('、')}，` +
+            '它只有项目级 skill 目录 —— 在项目根目录里运行 remixmate install --project 即可。\n');
+    }
     process.stdout.write('\n重启 agent 后即可生效。升级后重跑 remixmate install 覆盖即可。\n');
     return EXIT.OK;
 }
@@ -249,8 +386,8 @@ export function runUninstall(argv) {
         uninstallUsage();
         return EXIT.OK;
     }
-    if (opts.unknown) {
-        process.stderr.write(`❌ 未知参数: ${opts.unknown}\n`);
+    if (opts.error) {
+        process.stderr.write(`❌ ${opts.error}\n`);
         uninstallUsage();
         return EXIT.USAGE;
     }

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "version": "0.9.22",
-  "generatedAt": "2026-09-06T10:24:59.463Z",
+  "version": "0.9.23",
+  "generatedAt": "2026-09-06T12:35:46.901Z",
   "skills": [
     {
       "id": "export-jianying",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remixmate/cli",
-  "version": "0.9.22",
+  "version": "0.9.23",
   "description": "AI media generation skills for Claude Code / Codex — 12 skills covering image, video, voice, digital human, web screenshot, web recording, script, template registry, rendering, Jianying export, and video deconstruction.",
   "type": "module",
   "main": "dist/index.js",