README.md

AI Session Viewer

简体中文 | English

Claude Code、Codex CLI、Grok CLI 与 Oh My Pi 本地会话的统一可视化浏览器

---

AI Session Viewer 是一个轻量级应用，让你可以在一个统一界面中浏览、搜索来自 Claude Code、OpenAI Codex CLI、Grok CLI 和 Oh My Pi 的本地会话。四种来源均支持浏览、搜索、导出、标签/别名、删除、分叉与一键恢复（Resume）；Claude 与 Codex 还支持在应用内继续对话（调用本机安装的 CLI）。

本应用仅处理本地会话文件，不上传任何数据；删除、标签、别名等写操作只在用户主动触发时执行。

What's New（v3.2.0）：回收站「扫描孤儿目录」支持 Codex，一键清理 rollout 归档或删除后遗留的空日期目录；删除 Codex 项目时整个项目合并为一条回收站记录，可整体还原。Linux 续聊修复 xterm 参数并支持 GNOME Console（kgx），应用启动后才创建的会话目录也会自动加入文件监听；删除失败时保留对话框并显示原因，回收站移动失败时回滚更稳妥。感谢 @AquanSpring 的贡献。v3.1.x 起支持本机项目搬家与跨机会话迁移。详见 CHANGELOG.md。

⚠️ 从 2.x 升级：3.0.0 包含不兼容变更（Web 默认监听地址、令牌、续聊范围），详见 CHANGELOG.md。

截图

更多截图（搜索、设置、Codex、暗色主题等）见 docs/screenshots.md。截图使用虚构演示数据生成。

快速开始

桌面应用（推荐）

前往 Releases 下载对应平台的安装包：

平台	安装包
Windows	.msi（安装版）或 .zip（便携版）
macOS (Universal)	.dmg（同时支持 Intel 和 Apple Silicon）
Linux	.deb / .AppImage

安装后打开即可使用，应用会自动扫描本地的 Claude / Codex / Grok / Oh My Pi 会话数据。

前提：至少使用过一种受支持 CLI，对应的 ~/.claude/projects/、~/.codex/sessions/、$GROK_HOME/sessions/（默认 ~/.grok/sessions/）或 Oh My Pi 的 ~/.omp/agent/sessions/ 目录存在。

Web 服务器

在无 GUI 的服务器上运行，通过浏览器访问：

./session-web                                  # 仅本机：http://127.0.0.1:3000
./session-web --host 0.0.0.0 --token my-secret  # 局域网 / 公网（必须设置令牌）

参数、Docker、安全建议与多机节点见 docs/deployment.md。

功能概览

功能	说明
四种来源	Claude Code、Codex CLI、Grok CLI、Oh My Pi 的本地会话，一处浏览
阅读会话	Markdown 与代码高亮、工具调用查看器、提问目录与位置条、提问汇总、Codex 轨迹
整理	别名、标签、收藏、导出（JSON / Markdown / HTML）、批量删除进回收站
继续工作	终端一键恢复、从任意提问分叉；Claude 与 Codex 可在应用内续聊
会话迁移	整个数据源或指定项目导出为一个 .zip，在另一台电脑导入；支持路径映射、冲突跳过 / 备份覆盖；本机项目搬家，会话随文件夹迁移
搜索与统计	跨项目全文搜索；Claude / Codex 的 Token、花费与逐请求账单
多机与 Web	session-web 浏览器访问，多节点切换，令牌与来源校验
其他	Skills / MCP / 插件管理、Codex Provider 同步与旧会话修复、无效项清理、中英文界面、应用内更新

每项功能的完整说明见 docs/features.md。

文档

文档	内容
截图	全部界面截图
功能详解	每项功能的完整说明
Web 服务器与部署	参数、Docker、安全、多机节点
开发指南	本地开发、构建、技术栈、架构、REST API、发布、路线图
CHANGELOG	版本历史

Star History

贡献

欢迎提交 Issue 和 Pull Request。

许可证

MIT。第三方许可见 THIRD_PARTY_NOTICES.md。