关于 Sesame
Sesame 是一款 macOS 应用和 Claude Code 插件,用于查找并打开 Claude Code 与 Codex 创建的成果。它从两者的历史记录建立本地索引,让搜索直接定位成果,而不只是相关对话。
主要功能
- 01为 AI 成果建立本地索引
- 02按短语搜索
- 03通过快捷键语音搜索
- 04打开匹配的成果
- 05Claude Code 插件
适用场景
- 01查找先前会话创建的仪表板
- 02重新打开报告或演示文稿
- 03在 Claude Code 中搜索成果历史
MCP 相关
Sesame 可通过 `va mcp` 作为 MCP 服务运行,并向 MCP 客户端提供 `search_artifacts`、`open_artifact` 和 `artifact_stats` 工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Sesame
不必再翻找聊天记录。
你的 AI 创作库:说一句话,就能找回 Claude Code 或 Codex 交付的任何内容。
两行命令即可安装(macOS 13+):
brew install qiwei66/tap/sesame
sesame
以前:翻遍 20 段聊天记录,寻找昨天的仪表板。现在:说“昨天的仪表板”。
你的 AI 会创建仪表板、报告、演示文稿、网站和拉取请求。一周后,它们就被埋在冗长的聊天记录里。 Sesame 会在本地保存 AI 交付的所有成果,说几个字就能找回来:找回的是成果本身,而不是它所在的聊天记录。
会话查看器让你查看对话。Sesame 则打开对话的产物。
功能
开始输入,结果即刻呈现输入首字母,结果就会出现。按 ↑ ↓ 选择,按 ↵ 打开。如果本地没有匹配项,按 ↵ 即可让 Sesame 搜索所有内容。 |
|
|
按住快捷键,说出你要找的内容快捷键:⌥⇧Space(可在 Settings 中切换为 ⌘Space)。轻按即可输入;按住即可说话,松开即可发送。“打开上周的交易仪表板”会直接打开仪表板。 |
安装后立即可用首次启动时,它会读取你已有的 Claude Code 和 Codex 历史记录,并统计 AI 交付的所有成果。 |
|
|
有多个匹配项?选一个如果有多个名称符合条件,你会看到一份简短列表,而不是一个猜测结果;如果没有匹配项,它会如实告知,而不是提供无关内容。本地服务、Claude 页面、文件、PR、网站和在线文档都在搜索范围内。 |
分享你的数字在首次运行面板中点击 Share,即可将你的数字制作成 1200×675 图片,保存到 Downloads 并复制到剪贴板,方便粘贴到帖子中。图片只显示数量,不包含标题、路径或名称。 |
|
安装
brew install qiwei66/tap/sesame
sesame
sesame 会将 Sesame.app 放入 ~/Applications 并启动它;随时可以再次运行(通过 make install 安装的旧副本会保留为
Sesame.app.bak-<time>)。Homebrew 会安装 Node.js,在你的 Mac 上从源代码构建应用并进行临时签名:不会出现 Gatekeeper 警告,也不需要 Apple
Developer 帐户。首次安装会编译应用,需要几分钟;安装需要 Xcode Command Line Tools
(xcode-select --install),而 Homebrew 本身也需要这些工具。
也可以从源代码安装(需要 Node.js 22.18+ 和 Xcode Command Line Tools,xcode-select --install):
git clone https://github.com/qiwei66/sesame.git
cd sesame
make install
open ~/Applications/Sesame.app
make uninstall 会移除应用并保留你的设置。快捷键为 ⌥⇧Space;可在 Settings › Hot key 中切换为 ⌘Space。
在 Claude Code 中使用
Sesame 也可以作为插件在 Claude Code 中运行。在任意会话中用普通语言提问,Claude 就会在你的 资料库中查找,然后在 Mac 上打开。桌面应用是可选的:没有它,插件也会根据你的 Claude Code 和 Codex 历史记录建立相同的本地索引;有了它,两者就会共用一个索引。
claude plugin marketplace add qiwei66/sesame && claude plugin install sesame@sesame
在会话中,依次运行 /plugin marketplace add qiwei66/sesame 和 /plugin install sesame@sesame,效果相同。
它需要 Node.js 22.18+ 和 npm,Claude Code 会用它们安装插件的依赖包。
你: 上周的交易仪表板在哪里?
Claude: (search_artifacts → open_artifact) 找到了:你的 交易仪表板 是一个本地 Web 服务,地址为 http://127.0.0.1:8787,最后一次见到它是在 9 月 27 日。现在正在浏览器中打开。
你: 打开我昨天做的报告
Claude: (search_artifacts → open_artifact) 找到了昨天的报告——第三季度销售报告(Markdown 文件), 并已打开。
已经通过 Homebrew 或 make install 安装了应用?它的 va 也可以作为 MCP 服务使用:
claude mcp add sesame -- va mcp。
三个工具:search_artifacts(每个匹配项的标题、类型、链接、时间和来源会话)、open_artifact 和
artifact_stats。其他 MCP 客户端也可以用 va mcp 运行同一服务;详见 docs/mcp.md。
隐私
- 索引保存在你的 Mac 上(
~/Library/Application Support/Sesame),绝不会上传。 - Sesame 只读取
~/.claude/projects和~/.codex/sessions,绝不会写入其中。 - 模型是可选的。如果你设置了模型,它会收到你的句子、应用名称;如果本地搜索无法确定,还会收到每个候选项的类型、标题和少量关键词。绝不会收到完整链接、文件路径或剪贴板内容。
- 在 Claude Code 中,你询问的匹配项(标题、类型、链接、时间)会发送给该对话使用的模型,也就是你正在交谈的模型。不会发送到其他地方。
更多信息
系统操作(磁盘空间、将文件移到废纸篓)、自定义命令、技能和模型设置:请参阅 docs/advanced.md。
如果 Sesame 帮你少翻查了一次旧聊天记录,点个星标就能帮助其他人找到它。
许可证
MIT,详见 LICENSE。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。