clawt 1.1.0 → 1.2.0

package/.claude/agent-memory/docs-sync-updater/MEMORY.md

@@ -4,16 +4,18 @@
 
 ### docs/spec.md
 - 完整的软件规格说明，包含 7 大章节
-- 命令流程在 `5. 需求场景详细设计` 下，每个命令一个子章节（5.1-5.10）
+- 命令流程在 `5. 需求场景详细设计` 下，每个命令一个子章节（5.1-5.11）
 - run 命令对应 `5.2 批量创建 Worktree + 执行 Claude Code 任务`，流程按步骤编号描述
 - merge 命令对应 `5.6 合并验证过的分支`，流程按步骤编号描述
 - config 命令对应 `5.10 查看全局配置`，只读展示配置
+- resume 命令对应 `5.11 在已有 Worktree 中恢复会话`，查找已有 worktree 并启动交互式界面
 - 配置项说明在 `5.7 默认配置文件` 章节的表格中
 - 更新模式：新增步骤时追加编号，配置项影响范围变化时更新说明列
 
 ### CLAUDE.md
 - 面向 Claude Code 的项目架构指引，精简扼要
 - run 命令流程在 `核心流程（run 命令）` 章节，编号列表描述
+- resume 命令流程在独立的 `### resume 命令流程` 章节，编号列表描述
 - merge 和 run 中断清理在 `validate + merge 工作流` 章节，一行式描述用箭头连接流程
 - utils 目录描述用括号内逗号分隔列举功能模块
 - 更新模式：编号列表追加步骤，箭头链追加阶段，括号内追加关键词
@@ -30,6 +32,7 @@
 - run 的中断清理在所有子进程退出后执行
 - 文档中文风格，技术术语保留英文（worktree, merge, branch, SIGINT 等）
 - cleanupWorktrees 是 merge 和 run 共用的公共清理函数（在 src/utils/worktree.ts）
+- `launchInteractiveClaude` 是 run（交互式模式）和 resume 共用的公共函数（在 src/utils/claude.ts）
 - killAllChildProcesses 是 run 专用的子进程终止函数（在 src/utils/shell.ts）
 
 ## 配置项同步检查点
@@ -55,6 +58,10 @@ run 命令有两种模式（自 claudeCodeCommand 特性后）：
 - 传 `--tasks`：并行任务模式（多 worktree + `executeClaudeTask` + spawnProcess）
 - CLAUDE.md 中的核心流程按模式分段描述
 
-## 命令清单（7 个）
+## 命令清单（8 个）
 
-`create`、`run`、`list`、`remove`、`validate`、`merge`、`config`
+`create`、`run`、`resume`、`list`、`remove`、`validate`、`merge`、`config`
+
+Notes:
+- resume 和 run（交互式模式）共用 `launchInteractiveClaude()`，该函数从 run.ts 提取到 src/utils/claude.ts
+- `claudeCodeCommand` 配置项同时影响 run 交互式模式和 resume 命令

package/CLAUDE.md

@@ -24,7 +24,7 @@ npm i -g .        # 本地全局安装进行测试
 
 每个命令为独立文件 `src/commands/<name>.ts`，导出 `registerXxxCommand(program)` 函数，在 `src/index.ts` 中统一注册到 Commander。命令内部逻辑封装在对应的 `handleXxx` 函数中。
 
-七个命令：`create`、`run`、`list`、`remove`、`validate`、`merge`、`config`。
+八个命令：`create`、`run`、`resume`、`list`、`remove`、`validate`、`merge`、`config`。
 
 ### 核心流程（run 命令）
 
@@ -46,6 +46,13 @@ run 命令有两种模式：
 5. 每个任务完成时实时输出通知，全部完成后输出汇总
 6. SIGINT（Ctrl+C）中断处理：`killAllChildProcesses()` 终止所有子进程 → 等待退出 → `handleInterruptCleanup()` 根据 `autoDeleteBranch` 配置自动或交互式清理 worktree 和分支
 
+### resume 命令流程
+
+1. `validateMainWorktree()` 确认在主 worktree 根目录
+2. `validateClaudeCodeInstalled()` 确认 claude CLI 可用
+3. `findWorktreeByBranch()` 在当前项目的 worktree 列表中按分支名查找已有 worktree
+4. `launchInteractiveClaude()` 在目标 worktree 中启动 Claude Code 交互式界面
+
 ### validate + merge 工作流
 
 - `validate`：将目标 worktree 的变更通过 git stash 迁移到主 worktree，便于在主 worktree 中测试
@@ -55,7 +62,7 @@ run 命令有两种模式：
 ### 目录层级
 
 - `src/commands/` — 各命令的注册与处理逻辑
-- `src/utils/` — 工具函数（git 操作、shell 执行与子进程管理、分支名处理、worktree 管理与批量清理、配置、格式化输出、交互式输入）
+- `src/utils/` — 工具函数（git 操作、shell 执行与子进程管理、分支名处理、worktree 管理与批量清理、配置、格式化输出、交互式输入、Claude Code 交互式启动）
 - `src/constants/` — 常量定义（路径、退出码、消息模板、分支规则、配置默认值、终端控制序列）
 - `src/types/` — TypeScript 类型定义
 - `src/errors/` — 自定义 `ClawtError` 错误类（携带退出码）
@@ -65,7 +72,7 @@ run 命令有两种模式：
 
 - 所有命令执行前都会调用 `validateMainWorktree()` 确保在主 worktree 根目录（`git rev-parse --git-common-dir === ".git"`）
 - Worktree 统一存放在 `~/.clawt/worktrees/<projectName>/` 下
-- 全局配置文件 `~/.clawt/config.json`，postinstall 时自动创建/合并，包含 `autoDeleteBranch`（是否自动删除分支）、`claudeCodeCommand`（Claude Code CLI 启动指令）、`autoPullPush`（merge 后是否自动 pull/push）三个配置项。配置项以 `CONFIG_DEFINITIONS` 为单一数据源，`DEFAULT_CONFIG` 和 `CONFIG_DESCRIPTIONS` 均从中派生
+- 全局配置文件 `~/.clawt/config.json`，postinstall 时自动创建/合并，包含 `autoDeleteBranch`（是否自动删除分支）、`claudeCodeCommand`（Claude Code CLI 启动指令，用于 `run` 和 `resume` 的交互式界面）、`autoPullPush`（merge 后是否自动 pull/push）三个配置项。配置项以 `CONFIG_DEFINITIONS` 为单一数据源，`DEFAULT_CONFIG` 和 `CONFIG_DESCRIPTIONS` 均从中派生
 - shell 命令执行有同步（`execCommand` → `execSync`）和异步（`spawnProcess` → `spawn`）两种方式
 - 项目为纯 ESM（`"type": "module"`），模块导入需带 `.js` 后缀
 - 分支名特殊字符会被 `sanitizeBranchName()` 自动清理

package/README.md

@@ -12,7 +12,7 @@ npm i -g clawt
 
 - Node.js >= 18
 - Git >= 2.15
-- Claude Code CLI（仅 `clawt run` 需要）
+- Claude Code CLI（`clawt run` 和 `clawt resume` 需要）
 
 ## 使用前提
 
@@ -73,6 +73,23 @@ clawt run -b feature-scheme \
 clawt run -b feature-login
 ```
 
+### `clawt resume` — 在已有 worktree 中恢复 Claude Code 会话
+
+```bash
+clawt resume -b <branchName>
+```
+
+| 参数 | 必填 | 说明 |
+| ---- | ---- | ---- |
+| `-b` | 是 | 要恢复的分支名 |
+
+在之前通过 `clawt run` 或 `clawt create` 创建的 worktree 中重新打开 Claude Code 交互式界面，继续之前的工作。启动命令由配置项 `claudeCodeCommand` 指定（默认 `claude`）。
+
+```bash
+# 在已有 worktree 中恢复会话
+clawt resume -b feature-login
+```
+
 ### `clawt validate` — 在主 worktree 验证分支变更
 
 ```bash
@@ -162,7 +179,7 @@ clawt config
 | 配置项 | 类型 | 默认值 | 说明 |
 | ------ | ---- | ------ | ---- |
 | `autoDeleteBranch` | `boolean` | `false` | 移除 worktree 时自动删除对应本地分支；merge 成功后自动清理 worktree 和分支；run 中断后自动清理本次创建的 worktree 和分支 |
-| `claudeCodeCommand` | `string` | `"claude"` | Claude Code CLI 启动指令，用于 `clawt run` 不传 `--tasks` 时在 worktree 中打开交互式界面 |
+| `claudeCodeCommand` | `string` | `"claude"` | Claude Code CLI 启动指令，用于 `clawt run` 不传 `--tasks` 时和 `clawt resume` 在 worktree 中打开交互式界面 |
 | `autoPullPush` | `boolean` | `false` | merge 成功后是否自动执行 git pull 和 git push |
 
 ## 分支名规则

package/dist/index.js

@@ -537,6 +537,34 @@ function ensureClawtDirs() {
 // src/utils/prompt.ts
 import Enquirer from "enquirer";
 
+// src/utils/claude.ts
+import { spawnSync } from "child_process";
+function launchInteractiveClaude(worktree) {
+  const commandStr = getConfigValue("claudeCodeCommand");
+  const parts = commandStr.split(/\s+/).filter(Boolean);
+  const cmd = parts[0];
+  const args = [
+    ...parts.slice(1),
+    "--append-system-prompt",
+    APPEND_SYSTEM_PROMPT
+  ];
+  printInfo(`\u6B63\u5728 worktree \u4E2D\u542F\u52A8 Claude Code \u4EA4\u4E92\u5F0F\u754C\u9762...`);
+  printInfo(`  \u5206\u652F: ${worktree.branch}`);
+  printInfo(`  \u8DEF\u5F84: ${worktree.path}`);
+  printInfo(`  \u6307\u4EE4: ${commandStr}`);
+  printInfo("");
+  const result = spawnSync(cmd, args, {
+    cwd: worktree.path,
+    stdio: "inherit"
+  });
+  if (result.error) {
+    throw new ClawtError(`\u542F\u52A8 Claude Code \u5931\u8D25: ${result.error.message}`);
+  }
+  if (result.status !== null && result.status !== 0) {
+    printWarning(`Claude Code \u9000\u51FA\u7801: ${result.status}`);
+  }
+}
+
 // src/commands/list.ts
 import chalk2 from "chalk";
 function registerListCommand(program2) {
@@ -665,37 +693,11 @@ async function handleRemove(options) {
 }
 
 // src/commands/run.ts
-import { spawnSync } from "child_process";
 function registerRunCommand(program2) {
   program2.command("run").description("\u6279\u91CF\u521B\u5EFA worktree \u5E76\u542F\u52A8 Claude Code \u6267\u884C\u4EFB\u52A1").requiredOption("-b, --branch <branchName>", "\u5206\u652F\u540D").option("--tasks <task...>", "\u4EFB\u52A1\u5217\u8868\uFF08\u53EF\u591A\u6B21\u6307\u5B9A\uFF09\uFF0C\u4E0D\u4F20\u5219\u5728 worktree \u4E2D\u6253\u5F00 Claude Code \u4EA4\u4E92\u5F0F\u754C\u9762").action(async (options) => {
     await handleRun(options);
   });
 }
-function launchInteractiveClaude(worktree) {
-  const commandStr = getConfigValue("claudeCodeCommand");
-  const parts = commandStr.split(/\s+/).filter(Boolean);
-  const cmd = parts[0];
-  const args = [
-    ...parts.slice(1),
-    "--append-system-prompt",
-    APPEND_SYSTEM_PROMPT
-  ];
-  printInfo(`\u6B63\u5728 worktree \u4E2D\u542F\u52A8 Claude Code \u4EA4\u4E92\u5F0F\u754C\u9762...`);
-  printInfo(`  \u5206\u652F: ${worktree.branch}`);
-  printInfo(`  \u8DEF\u5F84: ${worktree.path}`);
-  printInfo(`  \u6307\u4EE4: ${commandStr}`);
-  printInfo("");
-  const result = spawnSync(cmd, args, {
-    cwd: worktree.path,
-    stdio: "inherit"
-  });
-  if (result.error) {
-    throw new ClawtError(`\u542F\u52A8 Claude Code \u5931\u8D25: ${result.error.message}`);
-  }
-  if (result.status !== null && result.status !== 0) {
-    printWarning(`Claude Code \u9000\u51FA\u7801: ${result.status}`);
-  }
-}
 function executeClaudeTask(worktree, task) {
   const child = spawnProcess(
     "claude",
@@ -856,6 +858,28 @@ async function handleRun(options) {
   printTaskSummary(summary);
 }
 
+// src/commands/resume.ts
+function registerResumeCommand(program2) {
+  program2.command("resume").description("\u5728\u5DF2\u6709 worktree \u4E2D\u6062\u590D Claude Code \u4EA4\u4E92\u5F0F\u4F1A\u8BDD").requiredOption("-b, --branch <branchName>", "\u8981\u6062\u590D\u7684\u5206\u652F\u540D").action(async (options) => {
+    await handleResume(options);
+  });
+}
+function findWorktreeByBranch(branchName) {
+  const worktrees = getProjectWorktrees();
+  const matched = worktrees.find((wt) => wt.branch === branchName);
+  if (!matched) {
+    throw new ClawtError(MESSAGES.WORKTREE_NOT_FOUND(branchName));
+  }
+  return matched;
+}
+async function handleResume(options) {
+  validateMainWorktree();
+  validateClaudeCodeInstalled();
+  logger.info(`resume \u547D\u4EE4\u6267\u884C\uFF0C\u5206\u652F: ${options.branch}`);
+  const worktree = findWorktreeByBranch(options.branch);
+  launchInteractiveClaude(worktree);
+}
+
 // src/commands/validate.ts
 import { join as join4 } from "path";
 import { existsSync as existsSync5 } from "fs";
@@ -1017,13 +1041,15 @@ ${chalk3.dim("\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84:")} ${CONFIG_PATH}
 `);
   printSeparator();
   const keys = Object.keys(DEFAULT_CONFIG);
-  for (const key of keys) {
+  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(`  ${chalk3.bold(key)}: ${formattedValue}`);
-    printInfo(`  ${chalk3.dim(description)}
-`);
+    printInfo(`  ${chalk3.dim(description)}`);
+    printInfo("");
   }
   printSeparator();
 }
@@ -1044,6 +1070,7 @@ registerListCommand(program);
 registerCreateCommand(program);
 registerRemoveCommand(program);
 registerRunCommand(program);
+registerResumeCommand(program);
 registerValidateCommand(program);
 registerMergeCommand(program);
 registerConfigCommand(program);

package/docs/spec.md

@@ -22,6 +22,7 @@
   - [5.8 获取当前项目所有 Worktree](#58-获取当前项目所有-worktree)
   - [5.9 日志系统](#59-日志系统)
   - [5.10 查看全局配置](#510-查看全局配置)
+  - [5.11 在已有 Worktree 中恢复会话](#511-在已有-worktree-中恢复会话)
 - [6. 错误处理规范](#6-错误处理规范)
 - [7. 非功能性需求](#7-非功能性需求)
 
@@ -159,6 +160,7 @@ git show-ref --verify refs/heads/<branchName> 2>/dev/null
 | `clawt remove`        | 移除 worktree（支持单个/批量/全部）               | 5.5      |
 | `clawt list`          | 列出当前项目所有 worktree                        | 5.8      |
 | `clawt config`        | 查看全局配置                                     | 5.10     |
+| `clawt resume`        | 在已有 worktree 中恢复 Claude Code 交互式会话      | 5.11     |
 
 所有命令执行前，都必须先执行**主 worktree 校验**（见 [2.1](#21-主-worktree-的定义与定位规则)）。
 
@@ -592,7 +594,7 @@ clawt merge -b <branchName> [-m <commitMessage>]
 | 配置项             | 类型      | 默认值    | 说明                                               |
 | ------------------ | --------- | --------- | -------------------------------------------------- |
 | `autoDeleteBranch` | `boolean` | `false`   | 移除 worktree 时是否自动删除对应本地分支（无需每次确认）；merge 成功后是否自动清理 worktree 和分支；run 任务被中断（Ctrl+C）后是否自动清理本次创建的 worktree 和分支 |
-| `claudeCodeCommand` | `string` | `"claude"` | Claude Code CLI 启动指令，用于 `clawt run` 不传 `--tasks` 时在 worktree 中打开交互式界面 |
+| `claudeCodeCommand` | `string` | `"claude"` | Claude Code CLI 启动指令，用于 `clawt run` 不传 `--tasks` 时和 `clawt resume` 在 worktree 中打开交互式界面 |
 | `autoPullPush` | `boolean` | `false` | merge 成功后是否自动执行 git pull 和 git push |
 
 ---
@@ -706,6 +708,37 @@ clawt config
 
 ---
 
+### 5.11 在已有 Worktree 中恢复会话
+
+**命令：**
+
+```bash
+clawt resume -b <branchName>
+```
+
+**参数：**
+
+| 参数 | 必填 | 说明                                                  |
+| ---- | ---- | ----------------------------------------------------- |
+| `-b` | 是   | 要恢复的分支名（对应已有 worktree 的分支）               |
+
+**使用场景：**
+
+当用户之前通过 `clawt run` 或 `clawt create` 创建了 worktree 但会话已结束，希望在该 worktree 中重新打开 Claude Code 交互式界面继续工作。
+
+**运行流程：**
+
+1. **主 worktree 校验** (2.1)
+2. **Claude Code CLI 校验**：确认 `claude` CLI 可用
+3. **查找目标 worktree**：在当前项目的 worktree 列表中按分支名查找匹配的 worktree
+   - 未找到 → 报错退出
+   - 找到 → 继续
+4. **启动 Claude Code 交互式界面**：通过 `launchInteractiveClaude()` 在目标 worktree 中启动 Claude Code CLI 交互式界面（使用 `spawnSync` + `inherit stdio`）
+
+启动命令通过配置项 `claudeCodeCommand`（默认值 `claude`）指定，与 `clawt run` 不传 `--tasks` 时的交互式界面行为一致。
+
+---
+
 ## 6. 错误处理规范
 
 ### 6.1 通用错误处理
@@ -714,7 +747,7 @@ clawt config
 | --------------------------------- | ---------------------------------------------------------- |
 | 不在主 worktree 根目录执行         | 输出错误提示，退出 (exit code 1)                            |
 | Git 未安装                        | 输出错误提示，退出 (exit code 1)                            |
-| Claude Code CLI 未安装            | 输出错误提示，退出 (exit code 1)（仅 `clawt run` 时检测）    |
+| Claude Code CLI 未安装            | 输出错误提示，退出 (exit code 1)（`clawt run` 和 `clawt resume` 时检测）    |
 | 分支已存在                        | 输出错误提示，退出 (exit code 1)                            |
 | Worktree 路径已存在               | 输出错误提示，退出 (exit code 1)                            |
 | Git 命令执行失败                  | 捕获 stderr，记录日志，输出错误提示，退出 (exit code 1)      |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawt",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "本地并行执行多个Claude Code Agent任务，融合 Git Worktree 与 Claude Code CLI 的命令行工具",
   "type": "module",
   "main": "dist/index.js",

package/src/commands/config.ts

@@ -31,13 +31,18 @@ function handleConfig(): void {
 
   const keys = Object.keys(DEFAULT_CONFIG) as Array<keyof ClawtConfig>;
 
-  for (const key of keys) {
+  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(`  ${chalk.bold(key)}: ${formattedValue}`);
-    printInfo(`  ${chalk.dim(description)}\n`);
+    printInfo(`  ${chalk.dim(description)}`);
+    // 配置项之间及最后一项与下横线之间保持统一空行间距
+    printInfo('');
   }
 
   printSeparator();

package/src/commands/resume.ts

@@ -0,0 +1,60 @@
+import type { Command } from 'commander';
+import { logger } from '../logger/index.js';
+import { ClawtError } from '../errors/index.js';
+import { MESSAGES } from '../constants/index.js';
+import type { ResumeOptions, WorktreeInfo } from '../types/index.js';
+import {
+  validateMainWorktree,
+  validateClaudeCodeInstalled,
+  getProjectWorktrees,
+  launchInteractiveClaude,
+} from '../utils/index.js';
+
+/**
+ * 注册 resume 命令：在已有 worktree 中恢复 Claude Code 会话
+ * @param {Command} program - Commander 实例
+ */
+export function registerResumeCommand(program: Command): void {
+  program
+    .command('resume')
+    .description('在已有 worktree 中恢复 Claude Code 交互式会话')
+    .requiredOption('-b, --branch <branchName>', '要恢复的分支名')
+    .action(async (options: ResumeOptions) => {
+      await handleResume(options);
+    });
+}
+
+/**
+ * 在已有 worktree 列表中按分支名查找对应的 worktree
+ * @param {string} branchName - 目标分支名
+ * @returns {WorktreeInfo} 匹配的 worktree 信息
+ * @throws {ClawtError} 当找不到匹配的 worktree 时抛出
+ */
+function findWorktreeByBranch(branchName: string): WorktreeInfo {
+  const worktrees = getProjectWorktrees();
+  const matched = worktrees.find((wt) => wt.branch === branchName);
+
+  if (!matched) {
+    throw new ClawtError(MESSAGES.WORKTREE_NOT_FOUND(branchName));
+  }
+
+  return matched;
+}
+
+/**
+ * 执行 resume 命令的核心逻辑
+ * 查找已有 worktree 并恢复 Claude Code 会话
+ * @param {ResumeOptions} options - 命令选项
+ */
+async function handleResume(options: ResumeOptions): Promise<void> {
+  validateMainWorktree();
+  validateClaudeCodeInstalled();
+
+  logger.info(`resume 命令执行，分支: ${options.branch}`);
+
+  // 查找目标 worktree
+  const worktree = findWorktreeByBranch(options.branch);
+
+  // 启动 Claude Code 交互式界面
+  launchInteractiveClaude(worktree);
+}

package/src/commands/run.ts

@@ -1,9 +1,8 @@
 import type { Command } from 'commander';
 import type { ChildProcess } from 'node:child_process';
-import { spawnSync } from 'node:child_process';
 import { logger } from '../logger/index.js';
 import { ClawtError } from '../errors/index.js';
-import { MESSAGES, APPEND_SYSTEM_PROMPT } from '../constants/index.js';
+import { MESSAGES } from '../constants/index.js';
 import type { RunOptions, ClaudeCodeResult, TaskResult, TaskSummary } from '../types/index.js';
 import {
   validateMainWorktree,
@@ -20,6 +19,7 @@ import {
   printSeparator,
   printDoubleSeparator,
   confirmAction,
+  launchInteractiveClaude,
 } from '../utils/index.js';
 import type { WorktreeInfo } from '../types/index.js';
 
@@ -38,41 +38,6 @@ export function registerRunCommand(program: Command): void {
     });
 }
 
-/**
- * 在指定 worktree 中启动 Claude Code CLI 交互式界面
- * 使用 spawnSync + inherit stdio，让用户直接与 Claude Code 交互
- * @param {WorktreeInfo} worktree - worktree 信息
- */
-function launchInteractiveClaude(worktree: WorktreeInfo): void {
-  const commandStr = getConfigValue('claudeCodeCommand');
-  const parts = commandStr.split(/\s+/).filter(Boolean);
-  const cmd = parts[0];
-  const args = [
-    ...parts.slice(1),
-    '--append-system-prompt',
-    APPEND_SYSTEM_PROMPT,
-  ];
-
-  printInfo(`正在 worktree 中启动 Claude Code 交互式界面...`);
-  printInfo(`  分支: ${worktree.branch}`);
-  printInfo(`  路径: ${worktree.path}`);
-  printInfo(`  指令: ${commandStr}`);
-  printInfo('');
-
-  const result = spawnSync(cmd, args, {
-    cwd: worktree.path,
-    stdio: 'inherit',
-  });
-
-  if (result.error) {
-    throw new ClawtError(`启动 Claude Code 失败: ${result.error.message}`);
-  }
-
-  if (result.status !== null && result.status !== 0) {
-    printWarning(`Claude Code 退出码: ${result.status}`);
-  }
-}
-
 /** executeClaudeTask 的返回结构，包含子进程引用和结果 Promise */
 interface ClaudeTaskHandle {
   /** 子进程实例，用于在中断时终止 */

package/src/index.ts

@@ -8,6 +8,7 @@ import { registerListCommand } from './commands/list.js';
 import { registerCreateCommand } from './commands/create.js';
 import { registerRemoveCommand } from './commands/remove.js';
 import { registerRunCommand } from './commands/run.js';
+import { registerResumeCommand } from './commands/resume.js';
 import { registerValidateCommand } from './commands/validate.js';
 import { registerMergeCommand } from './commands/merge.js';
 import { registerConfigCommand } from './commands/config.js';
@@ -31,6 +32,7 @@ registerListCommand(program);
 registerCreateCommand(program);
 registerRemoveCommand(program);
 registerRunCommand(program);
+registerResumeCommand(program);
 registerValidateCommand(program);
 registerMergeCommand(program);
 registerConfigCommand(program);

package/src/types/command.ts

@@ -37,3 +37,9 @@ export interface RemoveOptions {
   /** 指定索引 */
   index?: number;
 }
+
+/** resume 命令选项 */
+export interface ResumeOptions {
+  /** 要恢复的分支名 */
+  branch: string;
+}

package/src/types/index.ts

@@ -1,5 +1,5 @@
 export type { ClawtConfig, ConfigItemDefinition, ConfigDefinitions } from './config.js';
-export type { CreateOptions, RunOptions, ValidateOptions, MergeOptions, RemoveOptions } from './command.js';
+export type { CreateOptions, RunOptions, ValidateOptions, MergeOptions, RemoveOptions, ResumeOptions } from './command.js';
 export type { WorktreeInfo, WorktreeStatus } from './worktree.js';
 export type { ClaudeCodeResult } from './claudeCode.js';
 export type { TaskResult, TaskSummary } from './taskResult.js';

package/src/utils/claude.ts

@@ -0,0 +1,41 @@
+import { spawnSync } from 'node:child_process';
+import { ClawtError } from '../errors/index.js';
+import { APPEND_SYSTEM_PROMPT } from '../constants/index.js';
+import { getConfigValue } from './config.js';
+import { printInfo, printWarning } from './formatter.js';
+import type { WorktreeInfo } from '../types/index.js';
+
+/**
+ * 在指定 worktree 中启动 Claude Code CLI 交互式界面
+ * 使用 spawnSync + inherit stdio，让用户直接与 Claude Code 交互
+ * @param {WorktreeInfo} worktree - worktree 信息
+ */
+export function launchInteractiveClaude(worktree: WorktreeInfo): void {
+  const commandStr = getConfigValue('claudeCodeCommand');
+  const parts = commandStr.split(/\s+/).filter(Boolean);
+  const cmd = parts[0];
+  const args = [
+    ...parts.slice(1),
+    '--append-system-prompt',
+    APPEND_SYSTEM_PROMPT,
+  ];
+
+  printInfo(`正在 worktree 中启动 Claude Code 交互式界面...`);
+  printInfo(`  分支: ${worktree.branch}`);
+  printInfo(`  路径: ${worktree.path}`);
+  printInfo(`  指令: ${commandStr}`);
+  printInfo('');
+
+  const result = spawnSync(cmd, args, {
+    cwd: worktree.path,
+    stdio: 'inherit',
+  });
+
+  if (result.error) {
+    throw new ClawtError(`启动 Claude Code 失败: ${result.error.message}`);
+  }
+
+  if (result.status !== null && result.status !== 0) {
+    printWarning(`Claude Code 退出码: ${result.status}`);
+  }
+}

package/src/utils/index.ts

@@ -35,3 +35,4 @@ export { loadConfig, getConfigValue, ensureClawtDirs } from './config.js';
 export { printSuccess, printError, printWarning, printInfo, printSeparator, printDoubleSeparator, confirmAction, formatWorktreeStatus } from './formatter.js';
 export { ensureDir, removeEmptyDir } from './fs.js';
 export { multilineInput } from './prompt.js';
+export { launchInteractiveClaude } from './claude.js';