clawt 2.12.1 → 2.14.0

package/README.md

@@ -150,6 +150,33 @@ clawt config          # 查看当前配置
 clawt config reset    # 恢复默认配置
 ```
 
+### `clawt alias` — 管理命令别名
+
+```bash
+clawt alias                          # 列出所有命令别名
+clawt alias list                     # 列出所有命令别名
+clawt alias set <alias> <command>    # 设置命令别名
+clawt alias remove <alias>           # 移除命令别名
+```
+
+**使用示例：**
+
+```bash
+# 设置别名
+clawt alias set l list
+clawt alias set r run
+clawt alias set v validate
+
+# 使用别名（等同于对应的完整命令）
+clawt l          # 等同于 clawt list
+clawt r task.md  # 等同于 clawt run task.md
+
+# 移除别名
+clawt alias remove l
+```
+
+> **约束：** 别名不能覆盖内置命令名，目标必须是已注册的内置命令。别名的选项和参数会完全透传给目标命令。
+
 ## 配置
 
 配置文件位于 `~/.clawt/config.json`，安装后自动生成：
@@ -162,6 +189,7 @@ clawt config reset    # 恢复默认配置
 | `confirmDestructiveOps` | `true` | 破坏性操作前确认 |
 | `maxConcurrency` | `0` | run 命令最大并发数，`0` 为不限制 |
 | `terminalApp` | `"auto"` | 批量 resume 使用的终端：`auto` / `iterm2` / `terminal` |
+| `aliases` | `{}` | 命令别名映射（如 `{"l": "list", "r": "run"}`） |
 
 ## 全局选项
 

package/dist/index.js

@@ -251,7 +251,26 @@ var RESET_MESSAGES = {
 // src/constants/messages/config.ts
 var CONFIG_CMD_MESSAGES = {
   /** 配置已恢复为默认值 */
-  CONFIG_RESET_SUCCESS: "\u2713 \u914D\u7F6E\u5DF2\u6062\u590D\u4E3A\u9ED8\u8BA4\u503C"
+  CONFIG_RESET_SUCCESS: "\u2713 \u914D\u7F6E\u5DF2\u6062\u590D\u4E3A\u9ED8\u8BA4\u503C",
+  /** 配置项设置成功 */
+  CONFIG_SET_SUCCESS: (key, value) => `\u2713 ${key} \u5DF2\u8BBE\u7F6E\u4E3A ${value}`,
+  /** 获取配置值显示 */
+  CONFIG_GET_VALUE: (key, value) => `${key} = ${value}`,
+  /** 无效配置项名称 */
+  CONFIG_INVALID_KEY: (key, validKeys) => `\u65E0\u6548\u7684\u914D\u7F6E\u9879: ${key}
+\u53EF\u7528\u7684\u914D\u7F6E\u9879: ${validKeys.join(", ")}`,
+  /** 布尔类型值无效 */
+  CONFIG_INVALID_BOOLEAN: (key) => `\u914D\u7F6E\u9879 ${key} \u4E3A\u5E03\u5C14\u7C7B\u578B\uFF0C\u4EC5\u63A5\u53D7 true \u6216 false`,
+  /** 数字类型值无效 */
+  CONFIG_INVALID_NUMBER: (key) => `\u914D\u7F6E\u9879 ${key} \u4E3A\u6570\u5B57\u7C7B\u578B\uFF0C\u8BF7\u8F93\u5165\u6709\u6548\u7684\u6570\u5B57`,
+  /** 枚举类型配置项值无效（通用版） */
+  CONFIG_INVALID_ENUM: (key, validValues) => `\u914D\u7F6E\u9879 ${key} \u4EC5\u63A5\u53D7\u4EE5\u4E0B\u503C: ${validValues.join(", ")}`,
+  /** 交互式选择配置项提示 */
+  CONFIG_SELECT_PROMPT: "\u9009\u62E9\u8981\u4FEE\u6539\u7684\u914D\u7F6E\u9879",
+  /** 交互式输入新值提示 */
+  CONFIG_INPUT_PROMPT: (key) => `\u8F93\u5165 ${key} \u7684\u65B0\u503C`,
+  /** 缺少 value 参数提示 */
+  CONFIG_MISSING_VALUE: (key) => `\u7F3A\u5C11\u914D\u7F6E\u503C\uFF0C\u7528\u6CD5: clawt config set ${key} <value>`
 };
 
 // src/constants/messages/status.ts
@@ -280,6 +299,24 @@ var STATUS_MESSAGES = {
   STATUS_SNAPSHOT_ORPHANED: "(\u5BF9\u5E94 worktree \u5DF2\u4E0D\u5B58\u5728)"
 };
 
+// src/constants/messages/alias.ts
+var ALIAS_MESSAGES = {
+  /** 别名列表为空 */
+  ALIAS_LIST_EMPTY: "(\u65E0\u522B\u540D)",
+  /** 别名设置成功 */
+  ALIAS_SET_SUCCESS: (alias, command) => `\u2713 \u5DF2\u8BBE\u7F6E\u522B\u540D: ${alias} \u2192 ${command}`,
+  /** 别名移除成功 */
+  ALIAS_REMOVE_SUCCESS: (alias) => `\u2713 \u5DF2\u79FB\u9664\u522B\u540D: ${alias}`,
+  /** 别名不存在 */
+  ALIAS_NOT_FOUND: (alias) => `\u522B\u540D "${alias}" \u4E0D\u5B58\u5728`,
+  /** 别名与内置命令冲突 */
+  ALIAS_CONFLICTS_BUILTIN: (alias) => `\u522B\u540D "${alias}" \u4E0E\u5185\u7F6E\u547D\u4EE4\u51B2\u7A81\uFF0C\u4E0D\u5141\u8BB8\u8986\u76D6\u5185\u7F6E\u547D\u4EE4`,
+  /** 目标命令不存在 */
+  ALIAS_TARGET_NOT_FOUND: (command) => `\u76EE\u6807\u547D\u4EE4 "${command}" \u4E0D\u5B58\u5728\uFF0C\u8BF7\u6307\u5B9A\u5DF2\u6CE8\u518C\u7684\u5185\u7F6E\u547D\u4EE4\u540D`,
+  /** 别名列表标题 */
+  ALIAS_LIST_TITLE: "\u5F53\u524D\u522B\u540D\u5217\u8868\uFF1A"
+};
+
 // src/constants/messages/index.ts
 var MESSAGES = {
   ...COMMON_MESSAGES,
@@ -292,7 +329,8 @@ var MESSAGES = {
   ...REMOVE_MESSAGES,
   ...RESET_MESSAGES,
   ...CONFIG_CMD_MESSAGES,
-  ...STATUS_MESSAGES
+  ...STATUS_MESSAGES,
+  ...ALIAS_MESSAGES
 };
 
 // src/constants/exitCodes.ts
@@ -334,7 +372,12 @@ var CONFIG_DEFINITIONS = {
   },
   terminalApp: {
     defaultValue: "auto",
-    description: "\u6279\u91CF resume \u4F7F\u7528\u7684\u7EC8\u7AEF\u5E94\u7528\uFF1Aauto\uFF08\u81EA\u52A8\u68C0\u6D4B\uFF09\u3001iterm2\u3001terminal\uFF08macOS\uFF09"
+    description: "\u6279\u91CF resume \u4F7F\u7528\u7684\u7EC8\u7AEF\u5E94\u7528\uFF1Aauto\uFF08\u81EA\u52A8\u68C0\u6D4B\uFF09\u3001iterm2\u3001terminal\uFF08macOS\uFF09",
+    allowedValues: VALID_TERMINAL_APPS
+  },
+  aliases: {
+    defaultValue: {},
+    description: "\u547D\u4EE4\u522B\u540D\u6620\u5C04\uFF08\u901A\u8FC7 clawt alias \u547D\u4EE4\u7BA1\u7406\uFF09"
   }
 };
 function deriveDefaultConfig(definitions) {
@@ -907,12 +950,18 @@ function loadConfig() {
     return { ...DEFAULT_CONFIG };
   }
 }
+function writeConfig(config2) {
+  writeFileSync(CONFIG_PATH, JSON.stringify(config2, null, 2), "utf-8");
+}
 function writeDefaultConfig() {
-  writeFileSync(CONFIG_PATH, JSON.stringify(DEFAULT_CONFIG, null, 2), "utf-8");
+  writeConfig(DEFAULT_CONFIG);
+}
+function saveConfig(config2) {
+  writeFileSync(CONFIG_PATH, JSON.stringify(config2, null, 2), "utf-8");
 }
 function getConfigValue(key) {
-  const config = loadConfig();
-  return config[key];
+  const config2 = loadConfig();
+  return config2[key];
 }
 function ensureClawtDirs() {
   ensureDir(CLAWT_HOME);
@@ -1692,8 +1741,111 @@ async function executeBatchTasks(worktrees, tasks, concurrency) {
   printTaskSummary(summary);
 }
 
-// src/commands/list.ts
+// src/utils/alias.ts
+function applyAliases(program2, aliases) {
+  for (const [alias, commandName] of Object.entries(aliases)) {
+    const targetCmd = program2.commands.find((cmd) => cmd.name() === commandName);
+    if (targetCmd) {
+      targetCmd.alias(alias);
+      logger.debug(`\u5DF2\u6CE8\u518C\u522B\u540D: ${alias} \u2192 ${commandName}`);
+    } else {
+      logger.warn(`\u522B\u540D "${alias}" \u7684\u76EE\u6807\u547D\u4EE4 "${commandName}" \u4E0D\u5B58\u5728\uFF0C\u5DF2\u8DF3\u8FC7`);
+    }
+  }
+}
+
+// src/utils/config-strategy.ts
 import chalk4 from "chalk";
+import Enquirer3 from "enquirer";
+function isValidConfigKey(key) {
+  return key in DEFAULT_CONFIG;
+}
+function getValidConfigKeys() {
+  return Object.keys(DEFAULT_CONFIG);
+}
+function parseConfigValue(key, rawValue) {
+  const expectedType = typeof DEFAULT_CONFIG[key];
+  if (expectedType === "boolean") {
+    if (rawValue === "true") return { success: true, value: true };
+    if (rawValue === "false") return { success: true, value: false };
+    return { success: false, error: MESSAGES.CONFIG_INVALID_BOOLEAN(key) };
+  }
+  if (expectedType === "number") {
+    const num = Number(rawValue);
+    if (Number.isNaN(num)) {
+      return { success: false, error: MESSAGES.CONFIG_INVALID_NUMBER(key) };
+    }
+    return { success: true, value: num };
+  }
+  const definition = CONFIG_DEFINITIONS[key];
+  if (definition.allowedValues && !definition.allowedValues.includes(rawValue)) {
+    return { success: false, error: MESSAGES.CONFIG_INVALID_ENUM(key, definition.allowedValues) };
+  }
+  return { success: true, value: rawValue };
+}
+async function promptConfigValue(key, currentValue) {
+  const expectedType = typeof currentValue;
+  if (expectedType === "boolean") {
+    return promptBooleanValue(key, currentValue);
+  }
+  if (expectedType === "number") {
+    return promptNumberValue(key, currentValue);
+  }
+  const definition = CONFIG_DEFINITIONS[key];
+  if (definition.allowedValues) {
+    return promptEnumValue(key, currentValue, definition.allowedValues);
+  }
+  return promptStringValue(key, currentValue);
+}
+function formatConfigValue(value) {
+  if (typeof value === "boolean") {
+    return value ? chalk4.green("true") : chalk4.yellow("false");
+  }
+  return chalk4.cyan(String(value));
+}
+async function promptBooleanValue(key, currentValue) {
+  const choices = [
+    { name: "true", message: "true" },
+    { name: "false", message: "false" }
+  ];
+  const selected = await new Enquirer3.Select({
+    message: MESSAGES.CONFIG_INPUT_PROMPT(key),
+    choices,
+    initial: currentValue ? 0 : 1
+  }).run();
+  return selected === "true";
+}
+async function promptNumberValue(key, currentValue) {
+  const input = await new Enquirer3.Input({
+    message: MESSAGES.CONFIG_INPUT_PROMPT(key),
+    initial: String(currentValue),
+    validate: (val) => {
+      if (Number.isNaN(Number(val))) return "\u8BF7\u8F93\u5165\u6709\u6548\u7684\u6570\u5B57";
+      return true;
+    }
+  }).run();
+  return Number(input);
+}
+async function promptEnumValue(key, currentValue, allowedValues) {
+  const choices = allowedValues.map((v) => ({
+    name: v,
+    message: v
+  }));
+  return await new Enquirer3.Select({
+    message: MESSAGES.CONFIG_INPUT_PROMPT(key),
+    choices,
+    initial: allowedValues.indexOf(currentValue)
+  }).run();
+}
+async function promptStringValue(key, currentValue) {
+  return await new Enquirer3.Input({
+    message: MESSAGES.CONFIG_INPUT_PROMPT(key),
+    initial: currentValue
+  }).run();
+}
+
+// src/commands/list.ts
+import chalk5 from "chalk";
 function registerListCommand(program2) {
   program2.command("list").description("\u5217\u51FA\u5F53\u524D\u9879\u76EE\u6240\u6709 worktree").option("--json", "\u4EE5 JSON \u683C\u5F0F\u8F93\u51FA").action((options) => {
     handleList(options);
@@ -1730,12 +1882,12 @@ function printListAsText(projectName, worktrees) {
     for (const wt of worktrees) {
       const status = getWorktreeStatus(wt);
       const isIdle = status ? isWorktreeIdle(status) : false;
-      const pathDisplay = isIdle ? chalk4.hex("#FF8C00")(wt.path) : wt.path;
+      const pathDisplay = isIdle ? chalk5.hex("#FF8C00")(wt.path) : wt.path;
       printInfo(`  ${pathDisplay}   [${wt.branch}]`);
       if (status) {
         printInfo(`    ${formatWorktreeStatus(status)}`);
       } else {
-        printInfo(`    ${chalk4.yellow(MESSAGES.WORKTREE_STATUS_UNAVAILABLE)}`);
+        printInfo(`    ${chalk5.yellow(MESSAGES.WORKTREE_STATUS_UNAVAILABLE)}`);
       }
       printInfo("");
     }
@@ -1958,7 +2110,7 @@ async function handleBatchResume(worktrees) {
 }
 
 // src/commands/validate.ts
-import Enquirer3 from "enquirer";
+import Enquirer4 from "enquirer";
 var VALIDATE_RESOLVE_MESSAGES = {
   noWorktrees: MESSAGES.VALIDATE_NO_WORKTREES,
   selectBranch: MESSAGES.VALIDATE_SELECT_BRANCH,
@@ -1972,7 +2124,7 @@ function registerValidateCommand(program2) {
 }
 async function handleDirtyMainWorktree(mainWorktreePath) {
   printWarning("\u4E3B worktree \u5F53\u524D\u5206\u652F\u6709\u672A\u63D0\u4EA4\u7684\u66F4\u6539\uFF0C\u8BF7\u9009\u62E9\u5904\u7406\u65B9\u5F0F\uFF1A\n");
-  const choice = await new Enquirer3.Select({
+  const choice = await new Enquirer4.Select({
     message: "\u9009\u62E9\u5904\u7406\u65B9\u5F0F",
     choices: [
       {
@@ -2260,34 +2412,21 @@ async function handleMerge(options) {
 }
 
 // src/commands/config.ts
-import chalk5 from "chalk";
+import chalk6 from "chalk";
+import Enquirer5 from "enquirer";
 function registerConfigCommand(program2) {
-  const configCmd = program2.command("config").description("\u67E5\u770B\u548C\u7BA1\u7406\u5168\u5C40\u914D\u7F6E").action(() => {
-    handleConfig();
+  const configCmd = program2.command("config").description("\u4EA4\u4E92\u5F0F\u67E5\u770B\u548C\u4FEE\u6539\u5168\u5C40\u914D\u7F6E").action(async () => {
+    await handleConfigSet();
   });
   configCmd.command("reset").description("\u5C06\u914D\u7F6E\u6062\u590D\u4E3A\u9ED8\u8BA4\u503C").action(async () => {
     await handleConfigReset();
   });
-}
-function handleConfig() {
-  const config = loadConfig();
-  logger.info("config \u547D\u4EE4\u6267\u884C\uFF0C\u5C55\u793A\u5168\u5C40\u914D\u7F6E");
-  printInfo(`
-${chalk5.dim("\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84:")} ${CONFIG_PATH}
-`);
-  printSeparator();
-  const keys = Object.keys(DEFAULT_CONFIG);
-  for (let i = 0; i < keys.length; i++) {
-    const key = keys[i];
-    const value = config[key];
-    const description = CONFIG_DESCRIPTIONS[key];
-    const formattedValue = formatConfigValue(value);
-    if (i === 0) printInfo("");
-    printInfo(`  ${chalk5.bold(key)}: ${formattedValue}`);
-    printInfo(`  ${chalk5.dim(description)}`);
-    printInfo("");
-  }
-  printSeparator();
+  configCmd.command("set [key] [value]").description("\u4FEE\u6539\u914D\u7F6E\u9879\uFF08\u65E0\u53C2\u6570\u8FDB\u5165\u4EA4\u4E92\u5F0F\u914D\u7F6E\uFF09").action(async (key, value) => {
+    await handleConfigSet(key, value);
+  });
+  configCmd.command("get <key>").description("\u83B7\u53D6\u5355\u4E2A\u914D\u7F6E\u9879\u7684\u503C").action((key) => {
+    handleConfigGet(key);
+  });
 }
 async function handleConfigReset() {
   logger.info("config reset \u547D\u4EE4\u6267\u884C\uFF0C\u6062\u590D\u9ED8\u8BA4\u914D\u7F6E");
@@ -2302,11 +2441,57 @@ async function handleConfigReset() {
   writeDefaultConfig();
   printSuccess(MESSAGES.CONFIG_RESET_SUCCESS);
 }
-function formatConfigValue(value) {
-  if (typeof value === "boolean") {
-    return value ? chalk5.green("true") : chalk5.yellow("false");
+async function handleConfigSet(key, value) {
+  if (!key) {
+    await handleInteractiveConfigSet();
+    return;
+  }
+  if (!isValidConfigKey(key)) {
+    printError(MESSAGES.CONFIG_INVALID_KEY(key, getValidConfigKeys()));
+    return;
   }
-  return chalk5.cyan(String(value));
+  if (value === void 0) {
+    printError(MESSAGES.CONFIG_MISSING_VALUE(key));
+    return;
+  }
+  const result = parseConfigValue(key, value);
+  if (!result.success) {
+    printError(result.error);
+    return;
+  }
+  const config2 = loadConfig();
+  config2[key] = result.value;
+  saveConfig(config2);
+  logger.info(`config set \u547D\u4EE4\u6267\u884C\uFF0C\u8BBE\u7F6E ${key} = ${String(result.value)}`);
+  printSuccess(MESSAGES.CONFIG_SET_SUCCESS(key, String(result.value)));
+}
+async function handleInteractiveConfigSet() {
+  const config2 = loadConfig();
+  const keys = Object.keys(DEFAULT_CONFIG);
+  logger.info("config set \u547D\u4EE4\u6267\u884C\uFF0C\u8FDB\u5165\u4EA4\u4E92\u5F0F\u914D\u7F6E");
+  const choices = keys.map((k) => ({
+    name: k,
+    message: `${k}: ${formatConfigValue(config2[k])}  ${chalk6.dim(`\u2014 ${CONFIG_DESCRIPTIONS[k]}`)}`
+  }));
+  const selectedKey = await new Enquirer5.Select({
+    message: MESSAGES.CONFIG_SELECT_PROMPT,
+    choices
+  }).run();
+  const currentValue = config2[selectedKey];
+  const newValue = await promptConfigValue(selectedKey, currentValue);
+  config2[selectedKey] = newValue;
+  saveConfig(config2);
+  printSuccess(MESSAGES.CONFIG_SET_SUCCESS(selectedKey, String(newValue)));
+}
+function handleConfigGet(key) {
+  if (!isValidConfigKey(key)) {
+    printError(MESSAGES.CONFIG_INVALID_KEY(key, getValidConfigKeys()));
+    return;
+  }
+  const config2 = loadConfig();
+  const value = config2[key];
+  logger.info(`config get \u547D\u4EE4\u6267\u884C\uFF0C\u83B7\u53D6 ${key} = ${String(value)}`);
+  printInfo(MESSAGES.CONFIG_GET_VALUE(key, String(value)));
 }
 
 // src/commands/sync.ts
@@ -2393,7 +2578,7 @@ async function handleReset() {
 }
 
 // src/commands/status.ts
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 function registerStatusCommand(program2) {
   program2.command("status").description("\u663E\u793A\u9879\u76EE\u5168\u5C40\u72B6\u6001\u603B\u89C8").option("--json", "\u4EE5 JSON \u683C\u5F0F\u8F93\u51FA").action((options) => {
     handleStatus(options);
@@ -2489,7 +2674,7 @@ function printStatusAsJson(result) {
 }
 function printStatusAsText(result) {
   printDoubleSeparator();
-  printInfo(`  ${chalk6.bold.cyan(MESSAGES.STATUS_TITLE(result.main.projectName))}`);
+  printInfo(`  ${chalk7.bold.cyan(MESSAGES.STATUS_TITLE(result.main.projectName))}`);
   printDoubleSeparator();
   printInfo("");
   printMainSection(result.main);
@@ -2502,17 +2687,17 @@ function printStatusAsText(result) {
   printDoubleSeparator();
 }
 function printMainSection(main) {
-  printInfo(`  ${chalk6.bold("\u25C6")} ${chalk6.bold(MESSAGES.STATUS_MAIN_SECTION)}`);
-  printInfo(`    \u5206\u652F: ${chalk6.bold(main.branch)}`);
+  printInfo(`  ${chalk7.bold("\u25C6")} ${chalk7.bold(MESSAGES.STATUS_MAIN_SECTION)}`);
+  printInfo(`    \u5206\u652F: ${chalk7.bold(main.branch)}`);
   if (main.isClean) {
-    printInfo(`    \u72B6\u6001: ${chalk6.green("\u2713 \u5E72\u51C0")}`);
+    printInfo(`    \u72B6\u6001: ${chalk7.green("\u2713 \u5E72\u51C0")}`);
   } else {
-    printInfo(`    \u72B6\u6001: ${chalk6.yellow("\u2717 \u6709\u672A\u63D0\u4EA4\u4FEE\u6539")}`);
+    printInfo(`    \u72B6\u6001: ${chalk7.yellow("\u2717 \u6709\u672A\u63D0\u4EA4\u4FEE\u6539")}`);
   }
   printInfo("");
 }
 function printWorktreesSection(worktrees, total) {
-  printInfo(`  ${chalk6.bold("\u25C6")} ${chalk6.bold(MESSAGES.STATUS_WORKTREES_SECTION)} (${total} \u4E2A)`);
+  printInfo(`  ${chalk7.bold("\u25C6")} ${chalk7.bold(MESSAGES.STATUS_WORKTREES_SECTION)} (${total} \u4E2A)`);
   printInfo("");
   if (worktrees.length === 0) {
     printInfo(`    ${MESSAGES.STATUS_NO_WORKTREES}`);
@@ -2524,39 +2709,39 @@ function printWorktreesSection(worktrees, total) {
 }
 function printWorktreeItem(wt) {
   const statusLabel = formatChangeStatusLabel(wt.changeStatus);
-  printInfo(`  ${chalk6.bold("\u25CF")} ${chalk6.bold(wt.branch)}   [${statusLabel}]`);
+  printInfo(`  ${chalk7.bold("\u25CF")} ${chalk7.bold(wt.branch)}   [${statusLabel}]`);
   const parts = [];
   if (wt.insertions > 0 || wt.deletions > 0) {
-    parts.push(`${chalk6.green(`+${wt.insertions}`)} ${chalk6.red(`-${wt.deletions}`)}`);
+    parts.push(`${chalk7.green(`+${wt.insertions}`)} ${chalk7.red(`-${wt.deletions}`)}`);
   }
   if (wt.commitsAhead > 0) {
-    parts.push(chalk6.yellow(`${wt.commitsAhead} \u4E2A\u672C\u5730\u63D0\u4EA4`));
+    parts.push(chalk7.yellow(`${wt.commitsAhead} \u4E2A\u672C\u5730\u63D0\u4EA4`));
   }
   if (wt.commitsBehind > 0) {
-    parts.push(chalk6.yellow(`\u843D\u540E\u4E3B\u5206\u652F ${wt.commitsBehind} \u4E2A\u63D0\u4EA4`));
+    parts.push(chalk7.yellow(`\u843D\u540E\u4E3B\u5206\u652F ${wt.commitsBehind} \u4E2A\u63D0\u4EA4`));
   } else {
-    parts.push(chalk6.green("\u4E0E\u4E3B\u5206\u652F\u540C\u6B65"));
+    parts.push(chalk7.green("\u4E0E\u4E3B\u5206\u652F\u540C\u6B65"));
   }
   printInfo(`    ${parts.join("   ")}`);
   if (wt.hasSnapshot) {
-    printInfo(`    ${chalk6.blue("\u6709 validate \u5FEB\u7167")}`);
+    printInfo(`    ${chalk7.blue("\u6709 validate \u5FEB\u7167")}`);
   }
   printInfo("");
 }
 function formatChangeStatusLabel(status) {
   switch (status) {
     case "committed":
-      return chalk6.green(MESSAGES.STATUS_CHANGE_COMMITTED);
+      return chalk7.green(MESSAGES.STATUS_CHANGE_COMMITTED);
     case "uncommitted":
-      return chalk6.yellow(MESSAGES.STATUS_CHANGE_UNCOMMITTED);
+      return chalk7.yellow(MESSAGES.STATUS_CHANGE_UNCOMMITTED);
     case "conflict":
-      return chalk6.red(MESSAGES.STATUS_CHANGE_CONFLICT);
+      return chalk7.red(MESSAGES.STATUS_CHANGE_CONFLICT);
     case "clean":
-      return chalk6.gray(MESSAGES.STATUS_CHANGE_CLEAN);
+      return chalk7.gray(MESSAGES.STATUS_CHANGE_CLEAN);
   }
 }
 function printSnapshotsSection(snapshots) {
-  printInfo(`  ${chalk6.bold("\u25C6")} ${chalk6.bold(MESSAGES.STATUS_SNAPSHOTS_SECTION)} (${snapshots.length} \u4E2A)`);
+  printInfo(`  ${chalk7.bold("\u25C6")} ${chalk7.bold(MESSAGES.STATUS_SNAPSHOTS_SECTION)} (${snapshots.length} \u4E2A)`);
   printInfo("");
   if (snapshots.length === 0) {
     printInfo(`    ${MESSAGES.STATUS_NO_SNAPSHOTS}`);
@@ -2564,13 +2749,81 @@ function printSnapshotsSection(snapshots) {
     return;
   }
   for (const snap of snapshots) {
-    const orphanLabel = snap.worktreeExists ? "" : `  ${chalk6.yellow(MESSAGES.STATUS_SNAPSHOT_ORPHANED)}`;
-    const icon = snap.worktreeExists ? chalk6.blue("\u25CF") : chalk6.yellow("\u26A0");
+    const orphanLabel = snap.worktreeExists ? "" : `  ${chalk7.yellow(MESSAGES.STATUS_SNAPSHOT_ORPHANED)}`;
+    const icon = snap.worktreeExists ? chalk7.blue("\u25CF") : chalk7.yellow("\u26A0");
     printInfo(`  ${icon} ${snap.branch}${orphanLabel}`);
   }
   printInfo("");
 }
 
+// src/commands/alias.ts
+import chalk8 from "chalk";
+function getRegisteredCommandNames(program2) {
+  return program2.commands.map((cmd) => cmd.name());
+}
+function isBuiltinCommand(program2, alias) {
+  return getRegisteredCommandNames(program2).includes(alias);
+}
+function handleAliasList() {
+  const config2 = loadConfig();
+  const { aliases } = config2;
+  const entries = Object.entries(aliases);
+  logger.debug("alias list \u547D\u4EE4\u6267\u884C\uFF0C\u5C55\u793A\u522B\u540D\u5217\u8868");
+  if (entries.length === 0) {
+    printInfo(MESSAGES.ALIAS_LIST_EMPTY);
+    return;
+  }
+  printInfo(`
+${MESSAGES.ALIAS_LIST_TITLE}
+`);
+  printSeparator();
+  for (const [alias, command] of entries) {
+    printInfo(`  ${chalk8.bold(alias)} \u2192 ${chalk8.cyan(command)}`);
+  }
+  printInfo("");
+  printSeparator();
+}
+function handleAliasSet(program2, alias, command) {
+  logger.debug(`alias set \u547D\u4EE4\u6267\u884C\uFF0C\u522B\u540D: ${alias}\uFF0C\u76EE\u6807: ${command}`);
+  if (isBuiltinCommand(program2, alias)) {
+    printError(MESSAGES.ALIAS_CONFLICTS_BUILTIN(alias));
+    return;
+  }
+  if (!isBuiltinCommand(program2, command)) {
+    printError(MESSAGES.ALIAS_TARGET_NOT_FOUND(command));
+    return;
+  }
+  const config2 = loadConfig();
+  config2.aliases[alias] = command;
+  writeConfig(config2);
+  printSuccess(MESSAGES.ALIAS_SET_SUCCESS(alias, command));
+}
+function handleAliasRemove(alias) {
+  logger.debug(`alias remove \u547D\u4EE4\u6267\u884C\uFF0C\u522B\u540D: ${alias}`);
+  const config2 = loadConfig();
+  if (!(alias in config2.aliases)) {
+    printError(MESSAGES.ALIAS_NOT_FOUND(alias));
+    return;
+  }
+  delete config2.aliases[alias];
+  writeConfig(config2);
+  printSuccess(MESSAGES.ALIAS_REMOVE_SUCCESS(alias));
+}
+function registerAliasCommand(program2) {
+  const aliasCmd = program2.command("alias").description("\u7BA1\u7406\u547D\u4EE4\u522B\u540D").action(() => {
+    handleAliasList();
+  });
+  aliasCmd.command("list").description("\u5217\u51FA\u6240\u6709\u522B\u540D").action(() => {
+    handleAliasList();
+  });
+  aliasCmd.command("set <alias> <command>").description("\u8BBE\u7F6E\u547D\u4EE4\u522B\u540D").action((alias, command) => {
+    handleAliasSet(program2, alias, command);
+  });
+  aliasCmd.command("remove <alias>").description("\u79FB\u9664\u547D\u4EE4\u522B\u540D").action((alias) => {
+    handleAliasRemove(alias);
+  });
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -2593,6 +2846,9 @@ registerConfigCommand(program);
 registerSyncCommand(program);
 registerResetCommand(program);
 registerStatusCommand(program);
+registerAliasCommand(program);
+var config = loadConfig();
+applyAliases(program, config.aliases);
 process.on("uncaughtException", (error) => {
   if (error instanceof ClawtError) {
     printError(error.message);

package/dist/postinstall.js

@@ -243,7 +243,26 @@ var RESET_MESSAGES = {
 // src/constants/messages/config.ts
 var CONFIG_CMD_MESSAGES = {
   /** 配置已恢复为默认值 */
-  CONFIG_RESET_SUCCESS: "\u2713 \u914D\u7F6E\u5DF2\u6062\u590D\u4E3A\u9ED8\u8BA4\u503C"
+  CONFIG_RESET_SUCCESS: "\u2713 \u914D\u7F6E\u5DF2\u6062\u590D\u4E3A\u9ED8\u8BA4\u503C",
+  /** 配置项设置成功 */
+  CONFIG_SET_SUCCESS: (key, value) => `\u2713 ${key} \u5DF2\u8BBE\u7F6E\u4E3A ${value}`,
+  /** 获取配置值显示 */
+  CONFIG_GET_VALUE: (key, value) => `${key} = ${value}`,
+  /** 无效配置项名称 */
+  CONFIG_INVALID_KEY: (key, validKeys) => `\u65E0\u6548\u7684\u914D\u7F6E\u9879: ${key}
+\u53EF\u7528\u7684\u914D\u7F6E\u9879: ${validKeys.join(", ")}`,
+  /** 布尔类型值无效 */
+  CONFIG_INVALID_BOOLEAN: (key) => `\u914D\u7F6E\u9879 ${key} \u4E3A\u5E03\u5C14\u7C7B\u578B\uFF0C\u4EC5\u63A5\u53D7 true \u6216 false`,
+  /** 数字类型值无效 */
+  CONFIG_INVALID_NUMBER: (key) => `\u914D\u7F6E\u9879 ${key} \u4E3A\u6570\u5B57\u7C7B\u578B\uFF0C\u8BF7\u8F93\u5165\u6709\u6548\u7684\u6570\u5B57`,
+  /** 枚举类型配置项值无效（通用版） */
+  CONFIG_INVALID_ENUM: (key, validValues) => `\u914D\u7F6E\u9879 ${key} \u4EC5\u63A5\u53D7\u4EE5\u4E0B\u503C: ${validValues.join(", ")}`,
+  /** 交互式选择配置项提示 */
+  CONFIG_SELECT_PROMPT: "\u9009\u62E9\u8981\u4FEE\u6539\u7684\u914D\u7F6E\u9879",
+  /** 交互式输入新值提示 */
+  CONFIG_INPUT_PROMPT: (key) => `\u8F93\u5165 ${key} \u7684\u65B0\u503C`,
+  /** 缺少 value 参数提示 */
+  CONFIG_MISSING_VALUE: (key) => `\u7F3A\u5C11\u914D\u7F6E\u503C\uFF0C\u7528\u6CD5: clawt config set ${key} <value>`
 };
 
 // src/constants/messages/status.ts
@@ -272,6 +291,24 @@ var STATUS_MESSAGES = {
   STATUS_SNAPSHOT_ORPHANED: "(\u5BF9\u5E94 worktree \u5DF2\u4E0D\u5B58\u5728)"
 };
 
+// src/constants/messages/alias.ts
+var ALIAS_MESSAGES = {
+  /** 别名列表为空 */
+  ALIAS_LIST_EMPTY: "(\u65E0\u522B\u540D)",
+  /** 别名设置成功 */
+  ALIAS_SET_SUCCESS: (alias, command) => `\u2713 \u5DF2\u8BBE\u7F6E\u522B\u540D: ${alias} \u2192 ${command}`,
+  /** 别名移除成功 */
+  ALIAS_REMOVE_SUCCESS: (alias) => `\u2713 \u5DF2\u79FB\u9664\u522B\u540D: ${alias}`,
+  /** 别名不存在 */
+  ALIAS_NOT_FOUND: (alias) => `\u522B\u540D "${alias}" \u4E0D\u5B58\u5728`,
+  /** 别名与内置命令冲突 */
+  ALIAS_CONFLICTS_BUILTIN: (alias) => `\u522B\u540D "${alias}" \u4E0E\u5185\u7F6E\u547D\u4EE4\u51B2\u7A81\uFF0C\u4E0D\u5141\u8BB8\u8986\u76D6\u5185\u7F6E\u547D\u4EE4`,
+  /** 目标命令不存在 */
+  ALIAS_TARGET_NOT_FOUND: (command) => `\u76EE\u6807\u547D\u4EE4 "${command}" \u4E0D\u5B58\u5728\uFF0C\u8BF7\u6307\u5B9A\u5DF2\u6CE8\u518C\u7684\u5185\u7F6E\u547D\u4EE4\u540D`,
+  /** 别名列表标题 */
+  ALIAS_LIST_TITLE: "\u5F53\u524D\u522B\u540D\u5217\u8868\uFF1A"
+};
+
 // src/constants/messages/index.ts
 var MESSAGES = {
   ...COMMON_MESSAGES,
@@ -284,9 +321,13 @@ var MESSAGES = {
   ...REMOVE_MESSAGES,
   ...RESET_MESSAGES,
   ...CONFIG_CMD_MESSAGES,
-  ...STATUS_MESSAGES
+  ...STATUS_MESSAGES,
+  ...ALIAS_MESSAGES
 };
 
+// src/constants/terminal.ts
+var VALID_TERMINAL_APPS = ["auto", "iterm2", "terminal"];
+
 // src/constants/config.ts
 var CONFIG_DEFINITIONS = {
   autoDeleteBranch: {
@@ -311,7 +352,12 @@ var CONFIG_DEFINITIONS = {
   },
   terminalApp: {
     defaultValue: "auto",
-    description: "\u6279\u91CF resume \u4F7F\u7528\u7684\u7EC8\u7AEF\u5E94\u7528\uFF1Aauto\uFF08\u81EA\u52A8\u68C0\u6D4B\uFF09\u3001iterm2\u3001terminal\uFF08macOS\uFF09"
+    description: "\u6279\u91CF resume \u4F7F\u7528\u7684\u7EC8\u7AEF\u5E94\u7528\uFF1Aauto\uFF08\u81EA\u52A8\u68C0\u6D4B\uFF09\u3001iterm2\u3001terminal\uFF08macOS\uFF09",
+    allowedValues: VALID_TERMINAL_APPS
+  },
+  aliases: {
+    defaultValue: {},
+    description: "\u547D\u4EE4\u522B\u540D\u6620\u5C04\uFF08\u901A\u8FC7 clawt alias \u547D\u4EE4\u7BA1\u7406\uFF09"
   }
 };
 function deriveDefaultConfig(definitions) {