# claude-session-manager

**Repository Path**: zh_f/claude-session-manager

## Basic Information

- **Project Name**: claude-session-manager
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-11
- **Last Updated**: 2026-08-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude 会话管理器

一个本地可视化工具，用来管理本机所有 Claude Code 命令行会话。

> 零依赖、纯 Node.js 标准库实现，数据只存在本地，不上传任何内容。

## 它能做什么

- 📋 **列出所有会话**：按项目路径分组 / 表格展示，显示最近活动时间、工作目录、首个问题、消息数、文件大小、git 分支、会话摘要
- 🔍 **搜索 / 排序 / 筛选**：按会话 ID、路径、内容关键字搜索，按最近活动 / 消息数 / 大小 / 路径排序，按项目过滤
- ⧉ **复制恢复命令**：一键复制 `claude --resume <会话ID>`，在终端粘贴即可恢复该会话
- 👁 **查看会话**：弹出对话窗口，按时间线查看用户与助手的完整对话
- ☑️ **多选批量操作**：勾选复选框（或表头全选），批量「移入回收站」或「永久删除」
- 🗑 **删除会话**：先移入回收站（可恢复），支持从回收站恢复、永久删除、**一键清空回收站**
- ⚡ 本地服务带缓存，刷新秒开

## 快速开始

方式一（推荐）：双击 `start.bat`，会自动启动服务并打开浏览器。

方式二（手动）：

```bash
cd C:\Users\zhang\claude-session-manager
node server.js
```

方式三（从源码运行 / 任意位置）：

```bash
git clone https://github.com/qq0901001/claude-session-manager.git
# 或国内镜像：git clone https://gitee.com/zh_f/claude-session-manager.git
cd claude-session-manager
npm start        # 等价于 node server.js
```

浏览器访问 http://127.0.0.1:8777

## 如何恢复一个会话

在列表中点击某行的「⧉ 复制命令」，得到：

```
claude --resume 4254ffcf-96e5-4c62-b274-bd2df58b7bcd
```

把它粘贴到终端（任意目录）执行，即可恢复那个会话继续对话。

## 数据与安全性

- 服务只绑定 `127.0.0.1`（仅本机可访问），不向外网开放。
- 只读取/删除 `~/.claude/projects` 下的会话文件，不触碰其他文件。
- 删除操作是**移动到回收站**（`~/.claude/session-manager-trash/`），可在界面里恢复或永久删除。

## 自定义

| 环境变量 | 说明 | 默认值 |
|---|---|---|
| `PORT` | 监听端口 | `8777` |
| `HOST` | 监听地址 | `127.0.0.1` |
| `OPEN_BROWSER` | 设为 `0` 禁用自动打开浏览器 | 自动打开 |
| `CLAUDE_CONFIG_DIR` | 自定义 Claude 配置目录 | `~/.claude` |

## 常见问题

- **端口被占用**：`PORT=9000 node server.js`
- **看不到某些会话**：确认它们保存在 `~/.claude/projects/` 下（老版本 CLI 的位置可能不同）
- **删除运行中的会话**：建议先退出该会话再删除，避免对正在运行的会话产生影响

## 技术栈

- **运行环境**：Node.js ≥ 18（无需安装任何 npm 依赖）
- **后端**：Node.js 内置 `http` / `fs` 模块，单文件 `server.js`
- **前端**：原生 HTML / CSS / JavaScript，单页 `public/index.html`
- **平台**：Windows / macOS / Linux（自动识别 `~/.claude/projects`）

## 开源

- 本仓库采用 **MIT** 许可证，欢迎自由使用、修改与分发。
- 交流 / 反馈：GitHub Issues 或 Gitee Issues。
- 如果这个工具对你有帮助，欢迎点个 ⭐ 支持一下！