clawt 2.17.1 → 2.19.0

package/dist/index.js

@@ -15,6 +15,7 @@ var LOGS_DIR = join(CLAWT_HOME, "logs");
 var WORKTREES_DIR = join(CLAWT_HOME, "worktrees");
 var VALIDATE_SNAPSHOTS_DIR = join(CLAWT_HOME, "validate-snapshots");
 var CLAUDE_PROJECTS_DIR = join(homedir(), ".claude", "projects");
+var UPDATE_CHECK_PATH = join(CLAWT_HOME, "update-check.json");
 
 // src/constants/branch.ts
 var INVALID_BRANCH_CHARS = /[\/\\.\s~:*?[\]^]+/g;
@@ -372,6 +373,32 @@ var ALIAS_MESSAGES = {
   ALIAS_LIST_TITLE: "\u5F53\u524D\u522B\u540D\u5217\u8868\uFF1A"
 };
 
+// src/constants/messages/projects.ts
+var PROJECTS_MESSAGES = {
+  /** projects 命令全局概览标题 */
+  PROJECTS_OVERVIEW_TITLE: "\u9879\u76EE\u6982\u89C8",
+  /** projects 命令指定项目详情标题 */
+  PROJECTS_DETAIL_TITLE: (projectName) => `\u9879\u76EE\u8BE6\u60C5: ${projectName}`,
+  /** 无项目提示 */
+  PROJECTS_NO_PROJECTS: "(\u6682\u65E0\u9879\u76EE\uFF0Cworktrees \u76EE\u5F55\u4E3A\u7A7A)",
+  /** 项目不存在提示 */
+  PROJECTS_NOT_FOUND: (name) => `\u9879\u76EE ${name} \u4E0D\u5B58\u5728`,
+  /** worktree 数量标签 */
+  PROJECTS_WORKTREE_COUNT: (count) => `${count} \u4E2A worktree`,
+  /** 最近活跃时间标签 */
+  PROJECTS_LAST_ACTIVE: (relativeTime) => `\u6700\u8FD1\u6D3B\u8DC3: ${relativeTime}`,
+  /** 磁盘占用标签 */
+  PROJECTS_DISK_USAGE: (size) => `\u78C1\u76D8\u5360\u7528: ${size}`,
+  /** 总磁盘占用标签 */
+  PROJECTS_TOTAL_DISK_USAGE: (size) => `\u603B\u5360\u7528: ${size}`,
+  /** projects 详情无 worktree */
+  PROJECTS_DETAIL_NO_WORKTREES: "(\u8BE5\u9879\u76EE\u4E0B\u65E0 worktree)",
+  /** 路径标签 */
+  PROJECTS_PATH: (path2) => `\u8DEF\u5F84: ${path2}`,
+  /** 最后修改时间标签 */
+  PROJECTS_LAST_MODIFIED: (relativeTime) => `\u6700\u540E\u4FEE\u6539: ${relativeTime}`
+};
+
 // src/constants/messages/completion.ts
 var COMPLETION_MESSAGES = {
   /** completion 命令的主描述 */
@@ -394,6 +421,19 @@ var COMPLETION_MESSAGES = {
   COMPLETION_INSTALL_WRITE_ERROR: (filePath) => `\u65E0\u6CD5\u5199\u5165\u6587\u4EF6 ${filePath}\uFF0C\u8BF7\u68C0\u67E5\u6587\u4EF6\u6743\u9650\u6216\u624B\u52A8\u914D\u7F6E\u3002`
 };
 
+// src/constants/messages/update.ts
+var UPDATE_COMMANDS = {
+  npm: "npm i -g clawt",
+  pnpm: "pnpm add -g clawt",
+  yarn: "yarn global add clawt"
+};
+var UPDATE_MESSAGES = {
+  /** 版本更新提示 */
+  UPDATE_AVAILABLE: (currentVersion, latestVersion) => `clawt \u6709\u65B0\u7248\u672C\u53EF\u7528: ${currentVersion} \u2192 ${latestVersion}`,
+  /** 更新操作提示 */
+  UPDATE_HINT: (command) => `\u6267\u884C ${command} \u8FDB\u884C\u66F4\u65B0`
+};
+
 // src/constants/messages/index.ts
 var MESSAGES = {
   ...COMMON_MESSAGES,
@@ -408,6 +448,7 @@ var MESSAGES = {
   ...CONFIG_CMD_MESSAGES,
   ...STATUS_MESSAGES,
   ...ALIAS_MESSAGES,
+  ...PROJECTS_MESSAGES,
   ...COMPLETION_MESSAGES
 };
 
@@ -456,6 +497,10 @@ var CONFIG_DEFINITIONS = {
   aliases: {
     defaultValue: {},
     description: "\u547D\u4EE4\u522B\u540D\u6620\u5C04"
+  },
+  autoUpdate: {
+    defaultValue: true,
+    description: "\u662F\u5426\u542F\u7528\u81EA\u52A8\u66F4\u65B0\u68C0\u67E5\uFF08\u6BCF 24 \u5C0F\u65F6\u68C0\u67E5\u4E00\u6B21 npm registry\uFF09"
   }
 };
 function deriveDefaultConfig(definitions) {
@@ -479,6 +524,12 @@ var AUTO_SAVE_COMMIT_MESSAGE = "chore: auto-save before sync";
 // src/constants/logger.ts
 var DEBUG_TIMESTAMP_FORMAT = "HH:mm:ss.SSS";
 
+// src/constants/update.ts
+var UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+var NPM_REGISTRY_URL = "https://registry.npmjs.org/clawt/latest";
+var NPM_REGISTRY_TIMEOUT_MS = 5e3;
+var PACKAGE_NAME = "clawt";
+
 // src/constants/progress.ts
 var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
 var SPINNER_INTERVAL_MS = 100;
@@ -943,6 +994,32 @@ function formatRelativeTime(isoDateString) {
   const years = Math.floor(diffDays / 365);
   return `${years} \u5E74\u524D`;
 }
+function formatDiskSize(bytes) {
+  const KB = 1024;
+  const MB = KB * 1024;
+  const GB = MB * 1024;
+  if (bytes >= GB) {
+    return `${(bytes / GB).toFixed(1)} GB`;
+  }
+  if (bytes >= MB) {
+    return `${(bytes / MB).toFixed(1)} MB`;
+  }
+  if (bytes >= KB) {
+    return `${(bytes / KB).toFixed(1)} KB`;
+  }
+  return `${bytes} B`;
+}
+function formatLocalISOString(date) {
+  const tzOffsetMs = date.getTimezoneOffset() * 60 * 1e3;
+  const localDate = new Date(date.getTime() - tzOffsetMs);
+  const iso = localDate.toISOString().slice(0, -1);
+  const totalMinutes = -date.getTimezoneOffset();
+  const sign = totalMinutes >= 0 ? "+" : "-";
+  const absMinutes = Math.abs(totalMinutes);
+  const hours = String(Math.floor(absMinutes / 60)).padStart(2, "0");
+  const minutes = String(absMinutes % 60).padStart(2, "0");
+  return `${iso}${sign}${hours}:${minutes}`;
+}
 
 // src/utils/branch.ts
 function sanitizeBranchName(branchName) {
@@ -993,11 +1070,12 @@ function validateClaudeCodeInstalled() {
 }
 
 // src/utils/worktree.ts
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 import { existsSync as existsSync3, readdirSync as readdirSync2 } from "fs";
 
 // src/utils/fs.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, rmdirSync } from "fs";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, rmdirSync, statSync } from "fs";
+import { join as join2 } from "path";
 function ensureDir(dirPath) {
   if (!existsSync2(dirPath)) {
     mkdirSync2(dirPath, { recursive: true });
@@ -1014,11 +1092,30 @@ function removeEmptyDir(dirPath) {
   }
   return false;
 }
+function calculateDirSize(dirPath) {
+  let totalSize = 0;
+  try {
+    const entries = readdirSync(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = join2(dirPath, entry.name);
+      try {
+        if (entry.isDirectory()) {
+          totalSize += calculateDirSize(fullPath);
+        } else if (entry.isFile()) {
+          totalSize += statSync(fullPath).size;
+        }
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return totalSize;
+}
 
 // src/utils/worktree.ts
 function getProjectWorktreeDir() {
   const projectName = getProjectName();
-  return join2(WORKTREES_DIR, projectName);
+  return join3(WORKTREES_DIR, projectName);
 }
 function createWorktrees(branchName, count) {
   const sanitized = sanitizeBranchName(branchName);
@@ -1028,7 +1125,7 @@ function createWorktrees(branchName, count) {
   ensureDir(projectDir);
   const results = [];
   for (const name of branchNames) {
-    const worktreePath = join2(projectDir, name);
+    const worktreePath = join3(projectDir, name);
     createWorktree(name, worktreePath);
     results.push({ path: worktreePath, branch: name });
     logger.info(`worktree \u521B\u5EFA\u5B8C\u6210: ${worktreePath} (\u5206\u652F: ${name})`);
@@ -1041,7 +1138,7 @@ function createWorktreesByBranches(branchNames) {
   ensureDir(projectDir);
   const results = [];
   for (const name of branchNames) {
-    const worktreePath = join2(projectDir, name);
+    const worktreePath = join3(projectDir, name);
     createWorktree(name, worktreePath);
     results.push({ path: worktreePath, branch: name });
     logger.info(`worktree \u521B\u5EFA\u5B8C\u6210: ${worktreePath} (\u5206\u652F: ${name})`);
@@ -1063,7 +1160,7 @@ function getProjectWorktrees() {
     if (!entry.isDirectory()) {
       continue;
     }
-    const fullPath = join2(projectDir, entry.name);
+    const fullPath = join3(projectDir, entry.name);
     if (registeredPaths.has(fullPath)) {
       worktrees.push({
         path: fullPath,
@@ -1149,7 +1246,7 @@ import Enquirer from "enquirer";
 // src/utils/claude.ts
 import { spawnSync as spawnSync2 } from "child_process";
 import { existsSync as existsSync6, readdirSync as readdirSync3 } from "fs";
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 
 // src/utils/terminal.ts
 import { execFileSync as execFileSync2 } from "child_process";
@@ -1228,7 +1325,7 @@ function encodeClaudeProjectPath(absolutePath) {
 }
 function hasClaudeSessionHistory(worktreePath) {
   const encodedName = encodeClaudeProjectPath(worktreePath);
-  const projectDir = join3(CLAUDE_PROJECTS_DIR, encodedName);
+  const projectDir = join4(CLAUDE_PROJECTS_DIR, encodedName);
   if (!existsSync6(projectDir)) {
     return false;
   }
@@ -1285,13 +1382,13 @@ function launchInteractiveClaudeInNewTerminal(worktree, hasPreviousSession) {
 }
 
 // src/utils/validate-snapshot.ts
-import { join as join4 } from "path";
-import { existsSync as existsSync7, readFileSync as readFileSync2, writeFileSync as writeFileSync2, unlinkSync, readdirSync as readdirSync4, rmdirSync as rmdirSync2, statSync } from "fs";
+import { join as join5 } from "path";
+import { existsSync as existsSync7, readFileSync as readFileSync2, writeFileSync as writeFileSync2, unlinkSync, readdirSync as readdirSync4, rmdirSync as rmdirSync2, statSync as statSync2 } from "fs";
 function getSnapshotPath(projectName, branchName) {
-  return join4(VALIDATE_SNAPSHOTS_DIR, projectName, `${branchName}.tree`);
+  return join5(VALIDATE_SNAPSHOTS_DIR, projectName, `${branchName}.tree`);
 }
 function getSnapshotHeadPath(projectName, branchName) {
-  return join4(VALIDATE_SNAPSHOTS_DIR, projectName, `${branchName}.head`);
+  return join5(VALIDATE_SNAPSHOTS_DIR, projectName, `${branchName}.head`);
 }
 function hasSnapshot(projectName, branchName) {
   return existsSync7(getSnapshotPath(projectName, branchName));
@@ -1299,7 +1396,7 @@ function hasSnapshot(projectName, branchName) {
 function getSnapshotModifiedTime(projectName, branchName) {
   const snapshotPath = getSnapshotPath(projectName, branchName);
   if (!existsSync7(snapshotPath)) return null;
-  const stat = statSync(snapshotPath);
+  const stat = statSync2(snapshotPath);
   return stat.mtime.toISOString();
 }
 function readSnapshot(projectName, branchName) {
@@ -1313,7 +1410,7 @@ function readSnapshot(projectName, branchName) {
 function writeSnapshot(projectName, branchName, treeHash, headCommitHash) {
   const snapshotPath = getSnapshotPath(projectName, branchName);
   const headPath = getSnapshotHeadPath(projectName, branchName);
-  const snapshotDir = join4(VALIDATE_SNAPSHOTS_DIR, projectName);
+  const snapshotDir = join5(VALIDATE_SNAPSHOTS_DIR, projectName);
   ensureDir(snapshotDir);
   writeFileSync2(snapshotPath, treeHash, "utf-8");
   writeFileSync2(headPath, headCommitHash, "utf-8");
@@ -1332,7 +1429,7 @@ function removeSnapshot(projectName, branchName) {
   }
 }
 function getProjectSnapshotBranches(projectName) {
-  const projectDir = join4(VALIDATE_SNAPSHOTS_DIR, projectName);
+  const projectDir = join5(VALIDATE_SNAPSHOTS_DIR, projectName);
   if (!existsSync7(projectDir)) {
     return [];
   }
@@ -1340,13 +1437,13 @@ function getProjectSnapshotBranches(projectName) {
   return files.filter((f) => f.endsWith(".tree")).map((f) => f.replace(/\.tree$/, ""));
 }
 function removeProjectSnapshots(projectName) {
-  const projectDir = join4(VALIDATE_SNAPSHOTS_DIR, projectName);
+  const projectDir = join5(VALIDATE_SNAPSHOTS_DIR, projectName);
   if (!existsSync7(projectDir)) {
     return;
   }
   const files = readdirSync4(projectDir);
   for (const file of files) {
-    unlinkSync(join4(projectDir, file));
+    unlinkSync(join5(projectDir, file));
   }
   try {
     rmdirSync2(projectDir);
@@ -2145,7 +2242,7 @@ async function executeBatchTasks(worktrees, tasks, concurrency) {
 
 // src/utils/dry-run.ts
 import chalk4 from "chalk";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 var DRY_RUN_TASK_DESC_MAX_LENGTH = 80;
 function truncateTaskDesc(task) {
   const oneLine = task.replace(/\n/g, " ").trim();
@@ -2173,7 +2270,7 @@ function printDryRunPreview(branchNames, tasks, concurrency) {
   let hasConflict = false;
   for (let i = 0; i < branchNames.length; i++) {
     const branch = branchNames[i];
-    const worktreePath = join5(projectDir, branch);
+    const worktreePath = join6(projectDir, branch);
     const exists = checkBranchExists(branch);
     if (exists) hasConflict = true;
     const indexLabel = `[${i + 1}/${branchNames.length}]`;
@@ -2299,8 +2396,139 @@ async function promptStringValue(key, currentValue) {
   }).run();
 }
 
-// src/commands/list.ts
+// src/utils/update-checker.ts
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
+import { execSync as execSync3 } from "child_process";
+import { request } from "https";
 import chalk6 from "chalk";
+import stringWidth2 from "string-width";
+function readUpdateCache() {
+  try {
+    const raw = readFileSync4(UPDATE_CHECK_PATH, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function writeUpdateCache(cache) {
+  try {
+    writeFileSync3(UPDATE_CHECK_PATH, JSON.stringify(cache, null, 2), "utf-8");
+  } catch {
+  }
+}
+function isCacheExpired(cache, currentVersion) {
+  if (cache.currentVersion !== currentVersion) {
+    return true;
+  }
+  return Date.now() - cache.lastCheck > UPDATE_CHECK_INTERVAL_MS;
+}
+function isNewerVersion(latest, current) {
+  const latestParts = latest.split(".").map(Number);
+  const currentParts = current.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const l = latestParts[i] || 0;
+    const c = currentParts[i] || 0;
+    if (l > c) return true;
+    if (l < c) return false;
+  }
+  return false;
+}
+function fetchLatestVersion() {
+  return new Promise((resolve3) => {
+    const req = request(NPM_REGISTRY_URL, { timeout: NPM_REGISTRY_TIMEOUT_MS }, (res) => {
+      let data = "";
+      res.on("data", (chunk) => {
+        data += chunk.toString();
+      });
+      res.on("end", () => {
+        try {
+          const parsed = JSON.parse(data);
+          resolve3(parsed.version ?? null);
+        } catch {
+          resolve3(null);
+        }
+      });
+    });
+    req.on("error", () => resolve3(null));
+    req.on("timeout", () => {
+      req.destroy();
+      resolve3(null);
+    });
+    req.end();
+  });
+}
+function detectPackageManager() {
+  const checks = [
+    { name: "pnpm", command: `pnpm list -g --depth=0 ${PACKAGE_NAME}` },
+    { name: "yarn", command: `yarn global list --depth=0 2>/dev/null` }
+  ];
+  for (const { name, command } of checks) {
+    try {
+      const output = execSync3(command, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+      if (output.includes(PACKAGE_NAME)) {
+        return name;
+      }
+    } catch {
+    }
+  }
+  return "npm";
+}
+function printUpdateNotification(currentVersion, latestVersion) {
+  const updateText = UPDATE_MESSAGES.UPDATE_AVAILABLE(
+    chalk6.red(currentVersion),
+    chalk6.green(latestVersion)
+  );
+  const pm = detectPackageManager();
+  const updateCommand = UPDATE_COMMANDS[pm] || UPDATE_COMMANDS.npm;
+  const commandText = UPDATE_MESSAGES.UPDATE_HINT(chalk6.cyan(updateCommand));
+  const updateTextWidth = stringWidth2(updateText);
+  const commandTextWidth = stringWidth2(commandText);
+  const innerWidth = Math.max(updateTextWidth, commandTextWidth) + 4;
+  const padLine = (text) => {
+    const textWidth = stringWidth2(text);
+    const leftPad = Math.floor((innerWidth - textWidth) / 2);
+    const rightPad = innerWidth - textWidth - leftPad;
+    return `\u2502${" ".repeat(leftPad)}${text}${" ".repeat(rightPad)}\u2502`;
+  };
+  const top = `\u256D${"\u2500".repeat(innerWidth)}\u256E`;
+  const bottom = `\u2570${"\u2500".repeat(innerWidth)}\u256F`;
+  const emptyLine = `\u2502${" ".repeat(innerWidth)}\u2502`;
+  console.log();
+  console.log(top);
+  console.log(emptyLine);
+  console.log(padLine(updateText));
+  console.log(padLine(commandText));
+  console.log(emptyLine);
+  console.log(bottom);
+  console.log();
+}
+async function checkForUpdates(currentVersion) {
+  try {
+    const cache = readUpdateCache();
+    if (cache && !isCacheExpired(cache, currentVersion)) {
+      if (isNewerVersion(cache.latestVersion, currentVersion)) {
+        printUpdateNotification(currentVersion, cache.latestVersion);
+      }
+      return;
+    }
+    const latestVersion = await fetchLatestVersion();
+    if (!latestVersion) {
+      return;
+    }
+    writeUpdateCache({
+      lastCheck: Date.now(),
+      latestVersion,
+      currentVersion
+    });
+    if (isNewerVersion(latestVersion, currentVersion)) {
+      printUpdateNotification(currentVersion, latestVersion);
+    }
+  } catch {
+  }
+}
+
+// src/commands/list.ts
+import chalk7 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);
@@ -2337,12 +2565,12 @@ function printListAsText(projectName, worktrees) {
     for (const wt of worktrees) {
       const status = getWorktreeStatus(wt);
       const isIdle = status ? isWorktreeIdle(status) : false;
-      const pathDisplay = isIdle ? chalk6.hex("#FF8C00")(wt.path) : wt.path;
+      const pathDisplay = isIdle ? chalk7.hex("#FF8C00")(wt.path) : wt.path;
       printInfo(`  ${pathDisplay}   [${wt.branch}]`);
       if (status) {
         printInfo(`    ${formatWorktreeStatus(status)}`);
       } else {
-        printInfo(`    ${chalk6.yellow(MESSAGES.WORKTREE_STATUS_UNAVAILABLE)}`);
+        printInfo(`    ${chalk7.yellow(MESSAGES.WORKTREE_STATUS_UNAVAILABLE)}`);
       }
       printInfo("");
     }
@@ -3025,7 +3253,7 @@ async function handleMerge(options) {
 }
 
 // src/commands/config.ts
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 import Enquirer5 from "enquirer";
 function registerConfigCommand(program2) {
   const configCmd = program2.command("config").description("\u4EA4\u4E92\u5F0F\u67E5\u770B\u548C\u4FEE\u6539\u5168\u5C40\u914D\u7F6E").action(async () => {
@@ -3086,7 +3314,7 @@ async function handleInteractiveConfigSet() {
     const isObject = typeof DEFAULT_CONFIG[k] === "object";
     return {
       name: k,
-      message: `${k}: ${isObject ? chalk7.dim(JSON.stringify(config2[k])) : formatConfigValue(config2[k])}  ${chalk7.dim(`\u2014 ${CONFIG_DESCRIPTIONS[k]}`)}`,
+      message: `${k}: ${isObject ? chalk8.dim(JSON.stringify(config2[k])) : formatConfigValue(config2[k])}  ${chalk8.dim(`\u2014 ${CONFIG_DESCRIPTIONS[k]}`)}`,
       ...isObject && { disabled: CONFIG_ALIAS_DISABLED_HINT }
     };
   });
@@ -3141,7 +3369,7 @@ async function handleReset() {
 }
 
 // src/commands/status.ts
-import chalk8 from "chalk";
+import chalk9 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);
@@ -3161,7 +3389,7 @@ function collectStatus() {
   const projectName = getProjectName();
   const currentBranch = getCurrentBranch();
   const isClean = isWorkingDirClean();
-  const main = {
+  const main2 = {
     branch: currentBranch,
     isClean,
     projectName
@@ -3170,7 +3398,7 @@ function collectStatus() {
   const worktreeStatuses = worktrees.map((wt) => collectWorktreeDetailedStatus(wt, projectName));
   const snapshots = collectSnapshots(projectName, worktrees);
   return {
-    main,
+    main: main2,
     worktrees: worktreeStatuses,
     snapshots,
     totalWorktrees: worktrees.length
@@ -3254,7 +3482,7 @@ function printStatusAsJson(result) {
 }
 function printStatusAsText(result) {
   printDoubleSeparator();
-  printInfo(`  ${chalk8.bold.cyan(MESSAGES.STATUS_TITLE(result.main.projectName))}`);
+  printInfo(`  ${chalk9.bold.cyan(MESSAGES.STATUS_TITLE(result.main.projectName))}`);
   printDoubleSeparator();
   printInfo("");
   printMainSection(result.main);
@@ -3266,18 +3494,18 @@ function printStatusAsText(result) {
   printSnapshotsSection(result.snapshots);
   printDoubleSeparator();
 }
-function printMainSection(main) {
-  printInfo(`  ${chalk8.bold("\u25C6")} ${chalk8.bold(MESSAGES.STATUS_MAIN_SECTION)}`);
-  printInfo(`    \u5206\u652F: ${chalk8.bold(main.branch)}`);
-  if (main.isClean) {
-    printInfo(`    \u72B6\u6001: ${chalk8.green("\u2713 \u5E72\u51C0")}`);
+function printMainSection(main2) {
+  printInfo(`  ${chalk9.bold("\u25C6")} ${chalk9.bold(MESSAGES.STATUS_MAIN_SECTION)}`);
+  printInfo(`    \u5206\u652F: ${chalk9.bold(main2.branch)}`);
+  if (main2.isClean) {
+    printInfo(`    \u72B6\u6001: ${chalk9.green("\u2713 \u5E72\u51C0")}`);
   } else {
-    printInfo(`    \u72B6\u6001: ${chalk8.yellow("\u2717 \u6709\u672A\u63D0\u4EA4\u4FEE\u6539")}`);
+    printInfo(`    \u72B6\u6001: ${chalk9.yellow("\u2717 \u6709\u672A\u63D0\u4EA4\u4FEE\u6539")}`);
   }
   printInfo("");
 }
 function printWorktreesSection(worktrees, total) {
-  printInfo(`  ${chalk8.bold("\u25C6")} ${chalk8.bold(MESSAGES.STATUS_WORKTREES_SECTION)} (${total} \u4E2A)`);
+  printInfo(`  ${chalk9.bold("\u25C6")} ${chalk9.bold(MESSAGES.STATUS_WORKTREES_SECTION)} (${total} \u4E2A)`);
   printInfo("");
   if (worktrees.length === 0) {
     printInfo(`    ${MESSAGES.STATUS_NO_WORKTREES}`);
@@ -3289,56 +3517,56 @@ function printWorktreesSection(worktrees, total) {
 }
 function printWorktreeItem(wt) {
   const statusLabel = formatChangeStatusLabel(wt.changeStatus);
-  printInfo(`  ${chalk8.bold("\u25CF")} ${chalk8.bold(wt.branch)}   [${statusLabel}]`);
+  printInfo(`  ${chalk9.bold("\u25CF")} ${chalk9.bold(wt.branch)}   [${statusLabel}]`);
   if (wt.insertions > 0 || wt.deletions > 0) {
-    printInfo(`    ${chalk8.green(`+${wt.insertions}`)} ${chalk8.red(`-${wt.deletions}`)}`);
+    printInfo(`    ${chalk9.green(`+${wt.insertions}`)} ${chalk9.red(`-${wt.deletions}`)}`);
   }
   if (wt.commitsAhead > 0) {
-    printInfo(`    ${chalk8.yellow(`${wt.commitsAhead} \u4E2A\u672C\u5730\u63D0\u4EA4`)}`);
+    printInfo(`    ${chalk9.yellow(`${wt.commitsAhead} \u4E2A\u672C\u5730\u63D0\u4EA4`)}`);
   }
   if (wt.commitsBehind > 0) {
-    printInfo(`    ${chalk8.yellow(`\u843D\u540E\u4E3B\u5206\u652F ${wt.commitsBehind} \u4E2A\u63D0\u4EA4`)}`);
+    printInfo(`    ${chalk9.yellow(`\u843D\u540E\u4E3B\u5206\u652F ${wt.commitsBehind} \u4E2A\u63D0\u4EA4`)}`);
   } else {
-    printInfo(`    ${chalk8.green("\u4E0E\u4E3B\u5206\u652F\u540C\u6B65")}`);
+    printInfo(`    ${chalk9.green("\u4E0E\u4E3B\u5206\u652F\u540C\u6B65")}`);
   }
   if (wt.createdAt) {
     const relativeTime = formatRelativeTime(wt.createdAt);
     if (relativeTime) {
-      printInfo(`    ${chalk8.gray(MESSAGES.STATUS_CREATED_AT(relativeTime))}`);
+      printInfo(`    ${chalk9.gray(MESSAGES.STATUS_CREATED_AT(relativeTime))}`);
     }
   }
   if (wt.snapshotTime) {
     const relativeTime = formatRelativeTime(wt.snapshotTime);
     if (relativeTime) {
-      printInfo(`    ${chalk8.green(MESSAGES.STATUS_LAST_VALIDATED(relativeTime))}`);
+      printInfo(`    ${chalk9.green(MESSAGES.STATUS_LAST_VALIDATED(relativeTime))}`);
     }
   } else {
-    printInfo(`    ${chalk8.red(MESSAGES.STATUS_NOT_VALIDATED)}`);
+    printInfo(`    ${chalk9.red(MESSAGES.STATUS_NOT_VALIDATED)}`);
   }
   printInfo("");
 }
 function formatChangeStatusLabel(status) {
   switch (status) {
     case "committed":
-      return chalk8.green(MESSAGES.STATUS_CHANGE_COMMITTED);
+      return chalk9.green(MESSAGES.STATUS_CHANGE_COMMITTED);
     case "uncommitted":
-      return chalk8.yellow(MESSAGES.STATUS_CHANGE_UNCOMMITTED);
+      return chalk9.yellow(MESSAGES.STATUS_CHANGE_UNCOMMITTED);
     case "conflict":
-      return chalk8.red(MESSAGES.STATUS_CHANGE_CONFLICT);
+      return chalk9.red(MESSAGES.STATUS_CHANGE_CONFLICT);
     case "clean":
-      return chalk8.gray(MESSAGES.STATUS_CHANGE_CLEAN);
+      return chalk9.gray(MESSAGES.STATUS_CHANGE_CLEAN);
   }
 }
 function printSnapshotsSection(snapshots) {
-  printInfo(`  ${chalk8.bold("\u25C6")} ${chalk8.bold(MESSAGES.STATUS_SNAPSHOTS_SECTION)} (${snapshots.total} \u4E2A)`);
+  printInfo(`  ${chalk9.bold("\u25C6")} ${chalk9.bold(MESSAGES.STATUS_SNAPSHOTS_SECTION)} (${snapshots.total} \u4E2A)`);
   if (snapshots.orphaned > 0) {
-    printInfo(`    ${chalk8.yellow(MESSAGES.STATUS_SNAPSHOT_ORPHANED(snapshots.orphaned))}`);
+    printInfo(`    ${chalk9.yellow(MESSAGES.STATUS_SNAPSHOT_ORPHANED(snapshots.orphaned))}`);
   }
   printInfo("");
 }
 
 // src/commands/alias.ts
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 function getRegisteredCommandNames(program2) {
   return program2.commands.map((cmd) => cmd.name());
 }
@@ -3359,7 +3587,7 @@ ${MESSAGES.ALIAS_LIST_TITLE}
 `);
   printSeparator();
   for (const [alias, command] of entries) {
-    printInfo(`  ${chalk9.bold(alias)} \u2192 ${chalk9.cyan(command)}`);
+    printInfo(`  ${chalk10.bold(alias)} \u2192 ${chalk10.cyan(command)}`);
   }
   printInfo("");
   printSeparator();
@@ -3405,8 +3633,187 @@ function registerAliasCommand(program2) {
   });
 }
 
+// src/commands/projects.ts
+import { existsSync as existsSync9, readdirSync as readdirSync5, statSync as statSync3 } from "fs";
+import { join as join7 } from "path";
+import chalk11 from "chalk";
+function registerProjectsCommand(program2) {
+  program2.command("projects [name]").description("\u5C55\u793A\u6240\u6709\u9879\u76EE\u7684 worktree \u6982\u89C8\uFF0C\u6216\u67E5\u770B\u6307\u5B9A\u9879\u76EE\u7684 worktree \u8BE6\u60C5").option("--json", "\u4EE5 JSON \u683C\u5F0F\u8F93\u51FA").action((name, options) => {
+    handleProjects({ name, json: options.json });
+  });
+}
+function handleProjects(options) {
+  if (options.name) {
+    handleProjectDetail(options.name, options.json);
+  } else {
+    handleProjectsOverview(options.json);
+  }
+}
+function handleProjectsOverview(json) {
+  const result = collectProjectsOverview();
+  logger.info(`projects \u547D\u4EE4\u6267\u884C\uFF0C\u5171 ${result.totalProjects} \u4E2A\u9879\u76EE`);
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  printProjectsOverviewAsText(result);
+}
+function handleProjectDetail(name, json) {
+  const projectDir = join7(WORKTREES_DIR, name);
+  if (!existsSync9(projectDir)) {
+    printError(MESSAGES.PROJECTS_NOT_FOUND(name));
+    process.exit(1);
+  }
+  const result = collectProjectDetail(name, projectDir);
+  logger.info(`projects \u547D\u4EE4\u6267\u884C\uFF0C\u9879\u76EE: ${name}\uFF0C\u5171 ${result.worktrees.length} \u4E2A worktree`);
+  if (json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  printProjectDetailAsText(result);
+}
+function collectProjectsOverview() {
+  if (!existsSync9(WORKTREES_DIR)) {
+    return { projects: [], totalProjects: 0, totalDiskUsage: 0 };
+  }
+  const entries = readdirSync5(WORKTREES_DIR, { withFileTypes: true });
+  const projects = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) {
+      continue;
+    }
+    const projectDir = join7(WORKTREES_DIR, entry.name);
+    const overview = collectSingleProjectOverview(entry.name, projectDir);
+    projects.push(overview);
+  }
+  sortByLastActiveTimeDesc(projects);
+  const totalDiskUsage = projects.reduce((sum, p) => sum + p.diskUsage, 0);
+  return {
+    projects,
+    totalProjects: projects.length,
+    totalDiskUsage
+  };
+}
+function collectSingleProjectOverview(name, projectDir) {
+  const subEntries = readdirSync5(projectDir, { withFileTypes: true });
+  const worktreeDirs = subEntries.filter((e) => e.isDirectory());
+  const worktreeCount = worktreeDirs.length;
+  const diskUsage = calculateDirSize(projectDir);
+  const lastActiveTime = resolveProjectLastActiveTime(projectDir, worktreeDirs.map((e) => join7(projectDir, e.name)));
+  return {
+    name,
+    worktreeCount,
+    lastActiveTime,
+    diskUsage
+  };
+}
+function collectProjectDetail(name, projectDir) {
+  const subEntries = readdirSync5(projectDir, { withFileTypes: true });
+  const worktrees = [];
+  for (const entry of subEntries) {
+    if (!entry.isDirectory()) {
+      continue;
+    }
+    const wtPath = join7(projectDir, entry.name);
+    const detail = collectSingleWorktreeDetail(entry.name, wtPath);
+    worktrees.push(detail);
+  }
+  worktrees.sort((a, b) => new Date(b.lastModifiedTime).getTime() - new Date(a.lastModifiedTime).getTime());
+  const totalDiskUsage = worktrees.reduce((sum, wt) => sum + wt.diskUsage, 0);
+  return {
+    name,
+    projectDir,
+    worktrees,
+    totalDiskUsage
+  };
+}
+function collectSingleWorktreeDetail(branch, wtPath) {
+  const stat = statSync3(wtPath);
+  const diskUsage = calculateDirSize(wtPath);
+  return {
+    branch,
+    path: wtPath,
+    lastModifiedTime: formatLocalISOString(stat.mtime),
+    diskUsage
+  };
+}
+function resolveProjectLastActiveTime(projectDir, worktreePaths) {
+  let latestTime = statSync3(projectDir).mtime;
+  for (const wtPath of worktreePaths) {
+    try {
+      const wtStat = statSync3(wtPath);
+      if (wtStat.mtime > latestTime) {
+        latestTime = wtStat.mtime;
+      }
+    } catch {
+    }
+  }
+  return formatLocalISOString(latestTime);
+}
+function sortByLastActiveTimeDesc(projects) {
+  projects.sort((a, b) => new Date(b.lastActiveTime).getTime() - new Date(a.lastActiveTime).getTime());
+}
+function printProjectsOverviewAsText(result) {
+  printDoubleSeparator();
+  printInfo(`  ${chalk11.bold.cyan(MESSAGES.PROJECTS_OVERVIEW_TITLE)}`);
+  printDoubleSeparator();
+  printInfo("");
+  if (result.projects.length === 0) {
+    printInfo(`  ${MESSAGES.PROJECTS_NO_PROJECTS}`);
+    printInfo("");
+    printDoubleSeparator();
+    return;
+  }
+  for (const project of result.projects) {
+    printProjectOverviewItem(project);
+  }
+  printSeparator();
+  printInfo("");
+  printInfo(`  \u5171 ${chalk11.bold(String(result.totalProjects))} \u4E2A\u9879\u76EE   ${chalk11.gray(MESSAGES.PROJECTS_TOTAL_DISK_USAGE(formatDiskSize(result.totalDiskUsage)))}`);
+  printInfo("");
+  printDoubleSeparator();
+}
+function printProjectOverviewItem(project) {
+  const relativeTime = formatRelativeTime(project.lastActiveTime);
+  const activeLabel = relativeTime ? MESSAGES.PROJECTS_LAST_ACTIVE(relativeTime) : "";
+  const diskLabel = MESSAGES.PROJECTS_DISK_USAGE(formatDiskSize(project.diskUsage));
+  printInfo(`  ${chalk11.bold("\u25CF")} ${chalk11.bold(project.name)}`);
+  printInfo(`    ${MESSAGES.PROJECTS_WORKTREE_COUNT(project.worktreeCount)}   ${chalk11.gray(activeLabel)}   ${chalk11.gray(diskLabel)}`);
+  printInfo("");
+}
+function printProjectDetailAsText(result) {
+  printDoubleSeparator();
+  printInfo(`  ${chalk11.bold.cyan(MESSAGES.PROJECTS_DETAIL_TITLE(result.name))}`);
+  printDoubleSeparator();
+  printInfo("");
+  printInfo(`  ${chalk11.bold("\u25C6")} ${chalk11.bold(MESSAGES.PROJECTS_PATH(result.projectDir))}`);
+  printInfo(`    ${MESSAGES.PROJECTS_TOTAL_DISK_USAGE(formatDiskSize(result.totalDiskUsage))}`);
+  printInfo("");
+  printSeparator();
+  printInfo("");
+  if (result.worktrees.length === 0) {
+    printInfo(`  ${MESSAGES.PROJECTS_DETAIL_NO_WORKTREES}`);
+    printInfo("");
+    printDoubleSeparator();
+    return;
+  }
+  for (const wt of result.worktrees) {
+    printWorktreeDetailItem(wt);
+  }
+  printDoubleSeparator();
+}
+function printWorktreeDetailItem(wt) {
+  const relativeTime = formatRelativeTime(wt.lastModifiedTime);
+  const modifiedLabel = relativeTime ? MESSAGES.PROJECTS_LAST_MODIFIED(relativeTime) : "";
+  const diskLabel = MESSAGES.PROJECTS_DISK_USAGE(formatDiskSize(wt.diskUsage));
+  printInfo(`  ${chalk11.bold("\u25CF")} ${chalk11.bold(wt.branch)}`);
+  printInfo(`    ${wt.path}`);
+  printInfo(`    ${chalk11.gray(modifiedLabel)}   ${chalk11.gray(diskLabel)}`);
+  printInfo("");
+}
+
 // src/commands/completion.ts
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync3, existsSync as existsSync10 } from "fs";
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync4, existsSync as existsSync11 } from "fs";
 import { resolve as resolve2 } from "path";
 import { homedir as homedir2 } from "os";
 
@@ -3457,25 +3864,25 @@ compdef _clawt_completion clawt
 }
 
 // src/utils/completion-engine.ts
-import { existsSync as existsSync9, readdirSync as readdirSync5, statSync as statSync2 } from "fs";
-import { join as join6, dirname, basename as basename2 } from "path";
+import { existsSync as existsSync10, readdirSync as readdirSync6, statSync as statSync4 } from "fs";
+import { join as join8, dirname, basename as basename2 } from "path";
 function completeFilePath(partial) {
   const cwd = process.cwd();
   const hasDir = partial.includes("/");
-  const searchDir = hasDir ? join6(cwd, dirname(partial)) : cwd;
+  const searchDir = hasDir ? join8(cwd, dirname(partial)) : cwd;
   const prefix = hasDir ? basename2(partial) : partial;
-  if (!existsSync9(searchDir)) {
+  if (!existsSync10(searchDir)) {
     return [];
   }
-  const entries = readdirSync5(searchDir);
+  const entries = readdirSync6(searchDir);
   const results = [];
   const dirPrefix = hasDir ? dirname(partial) + "/" : "";
   for (const entry of entries) {
     if (!entry.startsWith(prefix)) continue;
     if (entry.startsWith(".")) continue;
-    const fullPath = join6(searchDir, entry);
+    const fullPath = join8(searchDir, entry);
     try {
-      const stat = statSync2(fullPath);
+      const stat = statSync4(fullPath);
       if (stat.isDirectory()) {
         results.push(dirPrefix + entry + "/");
       } else if (stat.isFile()) {
@@ -3562,15 +3969,15 @@ function generateCompletions(program2, args) {
 
 // src/commands/completion.ts
 function appendToFile(filePath, content) {
-  if (existsSync10(filePath)) {
-    const current = readFileSync4(filePath, "utf-8");
+  if (existsSync11(filePath)) {
+    const current = readFileSync5(filePath, "utf-8");
     if (current.includes("clawt completion")) {
       printInfo(MESSAGES.COMPLETION_INSTALL_EXISTS + ": " + filePath);
       return;
     }
     content = current + content;
   }
-  writeFileSync3(filePath, content, "utf-8");
+  writeFileSync4(filePath, content, "utf-8");
   printSuccess(MESSAGES.COMPLETION_INSTALL_SUCCESS + ": " + filePath);
   printInfo(MESSAGES.COMPLETION_INSTALL_RESTART(filePath));
 }
@@ -3640,6 +4047,7 @@ registerSyncCommand(program);
 registerResetCommand(program);
 registerStatusCommand(program);
 registerAliasCommand(program);
+registerProjectsCommand(program);
 registerCompletionCommand(program);
 var config = loadConfig();
 applyAliases(program, config.aliases);
@@ -3665,4 +4073,10 @@ process.on("unhandledRejection", (reason) => {
   logger.error(`\u672A\u5904\u7406\u7684 Promise \u62D2\u7EDD: ${error.message}`);
   process.exit(EXIT_CODES.ERROR);
 });
-program.parse(process.argv);
+async function main() {
+  await program.parseAsync(process.argv);
+  if (config.autoUpdate) {
+    await checkForUpdates(version);
+  }
+}
+main();