AI导哈

会话管理工具

claude-sesh是一款用于管理和组织Claude Code会话的工具，提供会话探索、全文搜索、使用分析和AI增强功能。

  • by abracadabra50
  • TypeScript
  • 本地部署
  • 16 星标
  • 更新于
在 GitHub 查看 abracadabra50/claude-sesh

使用说明

🗂️ 克劳德·塞什

你的克劳德代码会议，有组织。


Claude Code将您的会话埋在 ~/.claude/projects/. 祝你好运找到上周的对话。



npx claude-sesh web

一个命令。零配置。您的整个克劳德代码历史。


特性 · 快速开始 · 仪表盘 · 命令行界面 · 主控程序




特性

🔍 会话资源管理器

立即找到任何对话。

通过按项目、日期、型号等强大的过滤功能浏览完整的Claude代码历史记录。永远不要再忘记那个完美的解决方案。

🔎 全文检索

搜索一切。

通过代码片段、错误消息或任何文本查找会话。搜索涵盖您的所有对话、工具调用和输出。

📊 使用情况分析

知道你的代币去了哪里。

跟踪所有会话的成本、令牌使用和编码时间。按项目、型号和时间段查看细分。

🔄 轻松简历

从你停止的地方继续。

获取丰富的上下文摘要以继续任何会话。复制简历提示或使用Claude的原生简历功能。

🏷️ 人工智能丰富

自动生成的见解。

让AI总结会话，提取关键决策，并添加可搜索的标签。由您的Anthropic API键提供动力。

🧠 MCP集成

给克劳德回忆。

让克劳德直接搜索你过去的会话。问“我以前是怎么解决这个问题的？”并得到真实的答案。


快速开始

⚡ 立即尝试

npx claude-sesh web

打开 http://localhost:3847 完整的Claude Code历史记录。

不安装。没有配置。没有API密钥。

📦 全局安装

npm install -g claude-sesh

然后在任何地方使用CLI：

sesh list          # List sessions
sesh search "bug"  # Search conversations
sesh stats         # View analytics
sesh web           # Launch dashboard


🖥️ 网络仪表盘

sesh web

📈

Stats at a Glance
Total tokens, cost, hours coded

📅

Activity Heatmap
GitHub-style contribution graph

⏱️

Session Timeline
Visual history of all your work

🏆

Leaderboards
Top projects, tools, models

🔍

Deep Search
Find by content, project, date

📋

Session Details
Full context for any session


💻 CLI命令

浏览会话

sesh list              # Recent sessions
sesh ls -n 50          # Last 50 sessions
sesh show <id>         # Session details
sesh projects          # List all projects

搜索和查找

sesh search "auth"     # Full-text search
sesh continue          # Find resumable sessions
sesh stats             # Overall statistics

恢复工作

sesh resume <id>           # Get resume context
sesh resume <id> --copy    # Copy to clipboard
sesh resume <id> --native  # Use Claude's resume

AI功能

sesh enrich            # Generate AI summaries
sesh enrich --limit 20 # Enrich 20 sessions
sesh enrich --stats    # Check progress


🧠 MCP集成

让克劳德访问您的会话历史记录。

claude mcp add claude-sesh --scope user -- npx claude-sesh mcp

重新启动克劳德代码。现在问这样的问题：

“我在这个项目中做了什么？” “我以前是如何解决缓存问题的？” “最近更改了哪些文件？”


Available MCP Tools
工具 说明
search_sessions 在所有会话中进行全文搜索
get_session 获取特定会话的详细信息
get_project_context 最近的会议、决定、项目待办事项
get_pending_todos 跨会话查找未完成的任务
search_decisions 查找过去的架构决策
search_knowledge 搜索学习和解决方案
get_file_history 跟踪特定文件的更改
get_recent_activity 近期编码活动总结


🏷️ 人工智能丰富

自动生成摘要和标签，以便更好地搜索。

export ANTHROPIC_API_KEY=your-key
sesh enrich
📝 Summary
What was accomplished		 🎯 Decisions
Key choices made		 🐛 Problems
Issues & solutions		 🏷️ Tags
Auto-categorization


运作原理

┌────────────────────────────────────────────────────────────────┐
│  Claude Code writes sessions to ~/.claude/projects/           │
│  ↓                                                             │
│  claude-sesh parses & aggregates session data                  │
│  • Token counts, costs, duration                               │
│  • Tool usage breakdown                                        │
│  • File changes tracked                                        │
│  ↓                                                             │
│  AI Enrichment (optional)                                      │
│  • Auto-generate summaries                                     │
│  • Extract key decisions                                       │
│  • Add searchable tags                                         │
│  ↓                                                             │
│  Web Dashboard & CLI                                           │
│  • Search all sessions                                         │
│  • View analytics & trends                                     │
│  • Resume past work                                            │
└────────────────────────────────────────────────────────────────┘

您的数据将保留在本地。 克劳德·塞什读取克劳德现有的会话文件。没有任何东西上传到任何地方。



🔒 隐私和安全

💾
100% Local
All data stays on your machine		 👀
Read-Only
Never modifies Claude's files		 📡
No Telemetry
Zero data collection


配置

Change Dashboard Port 
sesh web --port 8080
Data Locations

Claude代码会话：

~/.claude/projects/[project-path]/[session-id].jsonl

丰富数据（可选）：

~/.claude-sesh/enriched/[session-id].json
Troubleshooting

仪表板未加载？

lsof -i :3847        # Check if port in use
sesh web --port 8080 # Try different port

搜索未返回任何内容？

  • 尝试更广泛的搜索词
  • 跑 sesh enrich 提高可搜索性

MCP不工作？

  • 添加MCP服务器后重新启动Claude Code
  • 证实 claude mcp list


贡献

我们欢迎捐款！看 贡献.md 了解指导方针和我们的路线图。



专为Claude Code社区打造 ❤️

报告错误 · 请求功能 · 讨论


MIT许可证· 克劳德代码 · 模型上下文协议

相关 MCP