/threads

name: threads
description: List all conversation threads

List Threads Command

List all available conversation threads with their status and statistics.

Usage

/threads [options]

Options

• `--sort [field]`: Sort by `updatedAt`, `createdAt`, or `messageCount` (default: `updatedAt`)
• `--order [asc|desc]`: Sort order (default: `desc`)
• `--tags [tag1,tag2]`: Filter by tags
• `--limit [number]`: Limit the number of results (default: 50)

Implementation Details for Claude

⚠️ 前置检查（最高优先级）

**在执行任何操作之前，必须先检查 `thread-manager` MCP 服务器是否可用。**

判断方法：检查当前可用的工具列表中是否包含 `mcp__thread-manager__list_threads` 工具。

**如果 MCP 工具不可用，必须立即输出以下错误信息并停止，不要尝试调用任何工具：**

❌ thread-manager MCP 服务器未配置

当前项目未配置 thread-manager MCP 服务器，无法使用线程管理功能。

🔧 解决方案：

方案 1：全局安装（推荐，一次配置全局可用）
   claude mcp add thread-manager -s user -- node <path-to-thread-manager>/dist/index.js

方案 2：项目级安装
   claude mcp add thread-manager -s project -- node <path-to-thread-manager>/dist/index.js

方案 3：切换到已配置该服务的项目目录

添加后需要重启 Claude Code 会话才能生效。

**🔴 重要：绝对不要在 MCP 不可用时尝试调用工具，这会导致命令卡住无响应！**

---

正常流程

When the user invokes `/threads`, call the `thread-manager.list_threads` tool.

**Example:** If user types: `/threads --sort messageCount` You call:

use_mcp_tool({
  server_name: "thread-manager",
  tool_name: "list_threads",
  arguments: {
    sortBy: "messageCount"
  }
});

**Output Format:** Please format the output as a **compact table** with the following structure:

 状态  标题                          ID         消息   文件   更新时间
────────────────────────────────────────────────────────────────────────
 ✅   [当前线程标题]                 [short-id]  [n]    [n]   [时间]
      [其他线程标题]                 [short-id]  [n]    [n]   [时间]
      [描述] (如果有)
      ...
────────────────────────────────────────────────────────────────────────
总计: [n] 个线程

**格式要求:**

• 当前活跃线程用 ✅ 标记
• ID 显示前 8 位短 ID
• 如果线程有描述，在标题下方缩进显示
• 消息列显示消息数量
• 文件列显示文件变更数量
• 更新时间使用相对时间（如：刚刚、3分钟前、1小时前）
• 表格使用 ASCII 字符分隔线