[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-83943":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":11,"stars7d":15,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":16,"compositeScore":17,"rankGlobal":8,"rankLanguage":8,"license":8,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":8,"pushedAt":8,"updatedAt":22,"readmeContent":23,"aiSummary":8,"trendingCount":14,"starSnapshotCount":14,"syncStatus":24,"lastSyncTime":25,"discoverSource":26},83943,"agent-session-search","zszz3\u002Fagent-session-search","zszz3",null,"TypeScript",58,4,51,3,0,7,15,48.3,false,"main",true,[],"2026-06-12 04:01:42","\u003Ch1 align=\"center\">Agent-Session-Search\u003C\u002Fh1>\n\n\u003Cp align=\"center\">本地桌面工具 · 一处搜索、整理、分析与恢复 Claude Code \u002F Codex \u002F CodeBuddy 的本地和 SSH 远程会话\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  简体中文 ｜ \u003Ca href=\".\u002Fdocs\u002FREADME.en.md\">English\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-macOS%20%7C%20Windows-555555\" alt=\"platform\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FElectron-42-47848F?logo=electron&logoColor=white\" alt=\"Electron\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FReact-19-61DAFB?logo=react&logoColor=white\" alt=\"React\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FNode-%E2%89%A5%2022.13-339933?logo=nodedotjs&logoColor=white\" alt=\"Node\">\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\".\u002Fassets\u002Fshow.png\" alt=\"Agent-Session-Search 界面预览\" width=\"860\">\n\u003C\u002Fp>\n\nAgent-Session-Search 是一个本地桌面工具，用来搜索、整理、分析和恢复 Claude Code 与 Codex 的历史会话。\n\n它会读取本机已有的 Claude \u002F Codex session 文件，也可以通过 SSH 读取远程机器上的 session，建立本地搜索索引，并允许你给每个 session 添加自定义标题、标签、置顶和隐藏状态。这些额外信息都存放在独立的本地 SQLite 数据库里；索引和整理默认不会修改原始 session 文件，只有用户确认删除 session 时才会删除对应源文件。此外还接入了 CodeBuddy CLI 等，设置中可打开。\n\n## 功能\n\n- 在一个桌面应用里统一搜索 Claude Code、Codex 和可选 CodeBuddy CLI 会话。\n- 支持全文搜索：自定义标题、原始标题、首个用户问题、会话正文和项目路径。\n- 支持首屏分页加载，长列表只先展示一部分 session，继续点击再加载更多。\n- 支持给 session 添加自定义标题、标签、收藏、置顶、隐藏状态，也支持删除 tag 和本地 session 源文件。\n- 支持按项目、环境、标签、来源、打开\u002F关闭状态、置顶状态、隐藏状态过滤。\n- 支持按最近活动、创建时间、更新时间排序。\n- 支持本地环境和 SSH 远程环境；远程环境可手动刷新，也可通过远端文件监听自动同步。\n- 支持从 Terminal、iTerm、Ghostty、WezTerm 或 Warp 恢复会话。\n- 支持把已经打开的终端前置、复制 resume 命令，或导出 Markdown。\n- 支持详情页 Markdown \u002F code block 渲染、tool call 轨迹折叠、按 user \u002F assistant \u002F tool 过滤消息。\n- 支持按 Today \u002F 7D \u002F 30D \u002F All time 统计消息数和 token 使用量。\n- 支持显示 Codex 订阅额度；Claude Code 额度可通过 statusline 快照桥接显示，设置中可隐藏。\n- 支持从菜单栏或界面按钮刷新本地索引和用量统计。\n- 支持 Skills 管理：查看 Codex \u002F Claude Code 已安装的 skills、搜索、预览、按来源过滤、复制路径、打开所在目录、删除用户 skill。\n- 支持 Skill 使用统计：Claude Code 通过 PostToolUse hook 记录，Codex 从本地 session 中推断读取过的 `SKILL.md`；统计索引写入本地 SQLite，点击刷新按钮增量更新。\n- 支持 Codex \u002F Claude Code API Provider 切换，内置 CodexZH、DeepSeek、GLM、LongCat、Kimi、MiMo 等常用预设，也支持自定义 base URL、model 和 API key。\n- 支持明暗主题和中英文界面切换。\n- macOS 下默认使用 `Option+Space` 唤起窗口，可在 Settings 里修改或关闭。\n\n## 支持的数据源\n\n| 来源 | 本地文件 |\n| --- | --- |\n| Codex CLI | `~\u002F.codex\u002Fsessions\u002F**\u002F*.jsonl` |\n| Codex Desktop | `~\u002F.codex\u002Fsessions\u002F**\u002F*.jsonl`，通过 session metadata 识别 |\n| Claude Code CLI | `~\u002F.claude\u002Fprojects\u002F*\u002F*.jsonl`，以及可选的 `~\u002F.claude\u002Fsessions\u002F*.json` 元数据 |\n| Claude Desktop app | `~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude-code-sessions\u002F**\u002Flocal_*.json`，以及 Claude Code 项目日志 |\n| CodeBuddy CLI | 可在设置中开启，读取 `~\u002F.codebuddy\u002Fprojects\u002F**\u002F*.jsonl` |\n| SSH 远程环境 | 通过 SSH 读取远端用户目录下同样的 Codex \u002F Claude Code session 路径 |\n\n当 `~\u002F.codex\u002Fsession_index.jsonl` 存在时，应用会读取 Codex 的标题元数据。没有上游标题时，会使用第一个有效用户问题作为默认标题。\n\n## SSH 远程会话\n\nSSH 远程环境不需要在远端安装 Agent-Session-Search，也不会在远端写入数据库。应用会在本机通过系统 `ssh` 连接远端，在远端执行一个临时 Python collector，读取远端 `~\u002F.codex` 和 `~\u002F.claude` 下的 session 摘要，再把摘要写入本机 SQLite。\n\n远程同步方式：\n\n- 添加或启用 SSH 环境后，会先完整同步一次最近 session 摘要。\n- 如果远端有 `inotifywait`，会通过 SSH 长连接监听 `~\u002F.codex\u002Fsessions`、`~\u002F.codex\u002Fsession_index.jsonl`、`~\u002F.claude\u002Fprojects`、`~\u002F.claude\u002Fsessions`。\n- 如果没有 `inotifywait` 但有 `fswatch`，会使用 `fswatch` 监听 `~\u002F.codex` 和 `~\u002F.claude`。\n- 如果两者都没有，会退化为每 60 秒轮询同步。\n- 远程详情按需加载：列表默认只保存摘要，点开某个远程 session 时才通过 SSH 拉取对应原始文件内容。\n\n远程机器需要：\n\n- 能从本机通过 `ssh` 非交互连接。\n- 安装 `python3`。\n- 想要实时监听时安装 `inotifywait` 或 `fswatch`；没有也能使用轮询。\n\n## 快捷键\n\n| 快捷键 | 作用 |\n| --- | --- |\n| `Option+Space` | macOS 下唤起或隐藏搜索窗口 |\n| `Cmd\u002FCtrl+K` | 聚焦并选中搜索框 |\n| `↑` \u002F `↓` | 在主界面会话列表中移动选中项 |\n| `Space` | 打开当前选中会话详情 |\n| `Enter` | 搜索框聚焦时打开当前选中会话详情 |\n| `Cmd\u002FCtrl+Enter` | 在默认终端中恢复当前选中会话 |\n| `Cmd\u002FCtrl+,` | 打开 Settings |\n\n## 数据边界\n\nAgent-Session-Search 会把两类数据分开处理：\n\n- Claude \u002F Codex 的原始 session 文件在索引、搜索、标注时只作为只读输入；显式确认删除 session 时会删除对应源文件。\n- SSH 远程 session 文件也只作为只读输入，通过 SSH 拉取摘要和按需详情。\n- 自定义标题、标签、收藏、置顶、隐藏状态、搜索索引、远程环境配置、Skill 使用索引和 API Provider key 存放在 Electron `userData` 目录下的本地 SQLite 数据库中。\n- 应用 Codex \u002F Claude Code Provider 时，会按对应 CLI 的配置格式修改本机 `~\u002F.codex\u002Fconfig.toml` 或 `~\u002F.claude\u002Fsettings.json`，并先写入备份。\n\n## 安装使用\n\n### macOS\n\n要求 Node.js 22.13+（含 npm）。进入仓库目录后，执行下面命令即可安装依赖、构建并注册全局命令：\n\n```bash\nnvm install 22 && nvm use 22 && npm ci && npm run build && npm install -g .\n```\n\n如果你不用 nvm，只要本机 `node --version` 是 22.13 或更高版本，可以直接从 `npm ci` 开始执行。\n\n装好后，在任意终端运行 `agent-session-search` 即可启动。应用常驻后台（菜单栏有图标），默认按 **⌥ Option + Space** 唤起搜索窗口；如果和 Raycast 等工具冲突，可以在 Settings 里修改或关闭全局快捷键。\n\nSettings 也可以通过 `Cmd+,` 打开；在 Appearance 里可以切换明暗主题和 English \u002F 中文界面。\n\n后续日常启动不需要重新执行安装命令，也不需要重新 build，直接运行：\n\n```bash\nagent-session-search\n```\n\n如果新终端提示 `agent-session-search: command not found`，通常是因为全局命令安装在 nvm 的 Node 22 目录下，但当前 shell 没有选中 Node 22。可以先运行：\n\n```bash\nnvm use 22\nagent-session-search\n```\n\n也可以一次性设置默认 Node 版本，之后新终端就不需要手动 `nvm use 22`：\n\n```bash\nnvm alias default 22\n```\n\n### Windows\n\n确认 Node.js 22.13+ 后，在仓库目录里用 PowerShell 执行：\n\n```powershell\nnpm ci && npm run build && npm install -g .\n```\n\n装好后，在任意终端运行 `agent-session-search` 即可启动。应用常驻后台（任务栏\u002F托盘有图标），默认按 **Ctrl + Alt + Space** 唤起搜索窗口。\n\n更新、卸载、从源码克隆、网络镜像等详情见 [Install.md](.\u002FInstall.md)。\n\n## 开发环境\n\n要求：\n\n- macOS 或 Windows\n- Node.js 22.13 或更高版本\n- npm\n\n安装依赖：\n\n```bash\nnpm install\n```\n\n运行测试：\n\n```bash\nnpm test\n```\n\n启动开发版桌面应用：\n\n```bash\nnpm run dev\n```\n\n构建应用：\n\n```bash\nnpm run build\n```\n\n## 仓库文档\n\n- `README.md`：中文项目说明，面向普通读者和开发者。\n- `docs\u002FREADME.en.md`：英文项目说明。\n- `Install.md`：安装、更新、卸载说明，也包含给 Coding Agent 安全初始化项目环境的执行文档。\n\n有任何问题，请提交issue。如果觉得我们的项目还不错，欢迎star✨。\n",2,"2026-06-11 04:11:53","CREATED_QUERY"]