
Sesame
io.github.qiwei66v0.2.1更新于 Oct 3, 2026
Search and open dashboards, reports, decks and PRs that Claude Code and Codex made on your Mac.
概览
Sesame 为 AI 编程工具在你 Mac 上产出的仪表盘、报告、演示文稿、站点和 PR 建立索引,让助手可以搜索并重新打开它们。
- 功能
- Sesame 通过读取你已有的会话历史,为 Claude Code 和 Codex 交付的产物维护一个本地库。它提供三个工具:search_artifacts 返回每个匹配项的标题、类型、链接、时间和来源会话;open_artifact 在你的 Mac 上打开所选项目;artifact_stats 报告数量。配套桌面应用可通过输入或语音热键完成同样的查找。
- 适用场景
- 当你积累了大量 AI 生成的仪表盘、报告、演示文稿、站点或 PR,希望用一句话描述就能找回,而不是翻找旧聊天记录时,值得添加。它面向使用 Claude Code 或 Codex 的 Mac 用户,目标是产物本身,而不是产生它的对话。
- 运行要求
- 在 macOS 上以 stdio 本地进程运行,通过命令 va mcp 启动,或作为 Claude Code 插件安装。插件方式需要 Node.js 22.18+ 及 npm;Homebrew 应用安装也会引入 Node.js 并从源码构建。未声明任何账号、API 密钥或环境变量。模型为可选项。
安装
在 SourceWeft 中
- 打开 控制台中的 Sesame,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
Sesame
Stop digging through chats.
Your library of AI creations: say a sentence and get back anything Claude Code or Codex delivered.
[MIT license] [macOS 13+] [Release] [Index stays on your Mac]
Your AI builds dashboards, reports, decks, sites and pull requests. A week later they are buried in long chats. Sesame keeps a local library of every artifact your AI delivered, so a few words bring it back: the artifact itself, not the chat it came from.
What it does
Install
sesame puts Sesame.app in ~/Applications and starts it; run it again any time (an older copy from make install is kept as
Sesame.app.bak-<time>). Homebrew brings Node.js, builds the app from source on your Mac and ad-hoc signs it: no Gatekeeper warning, no Apple
Developer account needed.
Or install from source (Node.js 22.18+ and the Xcode Command Line Tools, xcode-select --install):
make uninstall removes it and keeps your settings. The hot key is ⌥⇧Space; switch to ⌘Space in Settings › Hot key.
Use it in Claude Code
Sesame also runs inside Claude Code as a plugin. Ask in plain words in any session and Claude looks it up in your library, then opens it on your Mac. The app is optional: without it, the plugin builds the same local index from your Claude Code and Codex history; with it, both share one index.
Inside a session, /plugin marketplace add qiwei66/sesame and then /plugin install sesame@sesame do the same.
It needs Node.js 22.18+ with npm, which Claude Code uses to install the plugin's packages.
You: Where is the trading dashboard from last week?
Claude: (search_artifacts → open_artifact) Found it: your Trading Dashboard is a local web service at http://127.0.0.1:8787, last seen on September 27. It's opening in your browser now.
You: Open the report I made yesterday
Claude: (search_artifacts → open_artifact) Found yesterday's report, Q3 sales report (a Markdown file), and opened it.
Already installed the app with Homebrew or make install? Its va works as an MCP server too:
claude mcp add sesame -- va mcp.
Three tools: search_artifacts (title, type, link, time and source session of each match), open_artifact and
artifact_stats. Any other MCP client can run the same server with va mcp; see docs/mcp.md.
Privacy
- The index stays on your Mac (
~/Library/Application Support/Sesame) and is never uploaded. - Sesame only reads
~/.claude/projectsand~/.codex/sessions, and never writes to them. - A model is optional. If you set one up, it gets your sentence, your app names and, when local search can't decide, each candidate's type, title and a few keywords. Never full links, file paths or your clipboard.
- In Claude Code, the matches you ask about (title, type, link, time) go to the model of that conversation, the same one you are already talking to. Nothing goes anywhere else.
More
System actions (disk space, moving files to the Trash), custom commands, skills and model setup: docs/advanced.md.
License
MIT, see LICENSE.
来源:README.md,提交 8c1b782
工具
0版本历史
1- v0.2.1最新Oct 3, 2026


