摘要
一句话总结
Claude Task Viewer 是一款专为 Claude Code 打造的本地可视化实时看板，通过无干预的监控方式直观展示任务状态、依赖关系及 AI 执行过程。
核心要点
- 运行机制：默认在本地 3456 端口启动，自动扫描并解析
~/.claude/tasks/目录下的会话 JSON 文件。 - 核心功能：提供全局状态监控、任务依赖关系（阻塞关系）可视化，以及任务完成时的音效（C5到E5）与桌面通知提醒。
- 设计理念：采用“观察优于控制”的只读模式，仅展示 Claude 的实际操作而不干预任务状态，避免人机状态混淆。
- 技术实现：通过监视文件系统变化并推送 Server-Sent Events (SSE) 实现前端界面的实时刷新。
- 数据结构：利用
blocks和blockedBy字段映射依赖关系，通过activeForm字段显示当前具体操作，且能处理重试和子任务而不重复创建卡片。 - 扩展特性：内置时间线（甘特图）模式、闲置超 7 天会话自动归档功能，以及支持依赖检查的快捷键操作。
- 安装与配置：通过
npx claude-task-viewer命令即可安装运行，支持自定义端口和多账户配置。 - 开源协议：项目代码采用 MIT 协议在 GitHub 开源。
风险与不足
- 生态局限性：该工具目前仅专注于 Claude Code，暂不支持其他 AI 编码助手。
正文
当Claude Code把复杂工作拆分成任务时，用户往往只能在终端里零散地看到它的思考过程。为了将这些碎片拼成完整的画面，Claude Task Viewer 应运而生。
核心功能与解决的痛点
Claude Task Viewer 会在本地3456端口启动一个实时看板，自动扫描 ~/.claude/tasks/ 目录下的所有会话。通过这个工具，你可以直观地看到每个任务卡片的当前状态、依赖关系，甚至是Claude正在执行的具体操作。
该工具主要解决了以下几个具体痛点：
- 全局状态监控：实时查看所有会话的任务状态。
- 依赖关系可视化：清晰展示任务之间的阻塞关系。
- 任务完成提醒：当任务从“进行中”变为“已完成”时，系统会自动播放C5到E5的音效，并弹出桌面通知。
设计理念与技术实现
项目采用了**“观察优于控制”**的设计理念。看板仅用于显示Claude实际在做什么，绝不干预任务状态，从而有效避免了人为操作和AI执行之间的状态混淆。
在技术实现方面：
- 实时更新：工具通过监视文件系统变化，并推送 Server-Sent Events (SSE) 来实现界面的实时刷新。
- 数据结构：任务数据结构中包含
blocks和blockedBy字段来映射任务间的依赖关系，同时通过activeForm字段显示Claude当前正在执行的具体操作。 - 任务解析：任务ID映射是通过解析会话文件夹中的JSON文件实现的，能够完美处理重试和子任务，不会重复创建任务卡片。
更多实用特性
除了基础的看板视图，Claude Task Viewer 还提供了丰富的辅助功能：
- 时间线模式：支持以类似甘特图的形式展示任务的持续时间。
- 自动清理：闲置超过7天的会话会被自动归档，始终保持界面整洁。
- 快捷键支持：提供键盘快捷键操作，支持快速删除任务（自带依赖检查）以及查看帮助文档。
注：该工具目前专注于Claude Code，暂不支持其他AI编码助手。
安装与开源信息
工具的安装非常简单，只需在终端执行以下命令即可：
npx claude-task-viewer此外，它还支持自定义端口和多账户配置。
项目代码已在GitHub上开源，采用MIT协议。
欢迎关注公众号并回复“进群”，加入我们的讨论群交流更多AI工程化心得。