Skip to content

mang0cola/session-dashboard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Claude Code Session Dashboard

Claude Code会话管理仪表板,帮助您跟踪、恢复和管理Claude Code的对话会话。

✨ 功能特性

  • 项目会话管理:自动扫描Claude项目目录,按项目分组展示所有会话历史
  • 实时会话状态:实时检测会话运行状态,区分运行中、已结束的会话
  • 一键恢复会话:点击按钮即可在iTerm或Terminal中恢复任何会话
  • 会话分支:基于现有会话创建分支,开启新的对话线
  • iTerm会话映射:自动映射iTerm会话ID,支持一键激活iTerm窗口
  • 会话详情分析:查看会话完整消息历史,分析工具使用情况

🚀 快速开始

基础使用

在终端开启开启一个 claude code 会话,并输入

  1. 将项目克隆到本地:
/plugin marketplace add mang0cola/session-dashboard

/plugin install session-dashboard

重启claude code,session dashboard服务会自动启动在,http://localhost:30080

  1. 打开浏览器访问:http://localhost:30080

进阶使用

搭配 iTerm2 自动激活 cc 会话窗口

打开以下配置 iTerm2 -> Settings -> General -> Magic -> Enable Python API

在 session dashboard 中,查看运行中的会话时,点击 Active 按钮,即可激活对应的iTerm窗口

安装飞书机器人插件,claude code 交互消息及时提醒

  1. 创建飞书 webhook 机器人

  2. 配置环境变量 打开 ~/.bashrc 或 ~/.zshrc 文件,添加以下内容:

export LARK_WEBHOOK_URL='https://open.feishu.cn/open-apis/bot/v2/hook/your-webhook-token'
  1. 安装notify-with-lark插件:

打开一个 Claude Code 会话,安装插件

/plugin install notify-with-lark
  1. 重启Claude Code

上述配置完成后,notify-with-lark 会在以后的 claude code 会话中自动生效,需要用户交互时,会收到飞书机器人消息提醒

📖 使用说明

  1. 访问仪表板:启动服务后,打开浏览器访问 http://localhost:30080
  2. 查看项目:首页显示所有Claude项目及其会话统计
  3. 管理会话:点击项目查看详细会话列表,进行恢复、分支等操作
  4. 实时监控:仪表板实时更新会话状态,无需手动刷新

🏗️ 项目结构

session-dashboard/
├── plugin/session-dashboard/
│   ├── .claude-plugin/
│   │   └── plugin.json          # 插件配置文件
│   ├── skills/
│   │   └── session-dashboard/
│   │       └── scripts/
│   │           ├── server.js    # 主服务器文件
│   │           └── utils/
│   │               ├── active_shell.py      # iTerm激活脚本
│   │               └── session_start_hook.py # 会话启动钩子
├── .gitignore                   # Git忽略文件
└── README.md                    # 项目说明文档

About

Claude Code会话管理仪表板,帮助您跟踪、恢复和管理Claude Code的对话会话。

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors