Keeploop

面向 Claude Code、Cursor、Gemini CLI、Grok Build 和 Grok Bot 的 Keeploop 插件

Keeploop 是面向 AI 的个人上下文层：一款 Mac 菜单栏应用，可让你已在使用的 AI 应用直接在 Mac 上读取你的 Mail、Messages、Calendar、Notes 和 Slack。你的数据会一直留在 Mac 上，直到你连接的 AI 应用请求访问；你可以决定每个 AI 能查看和执行哪些操作。

此仓库是 Keeploop 的插件市场，包含两个插件：

• keeploop 在你的 Mac 上运行，适用于 Claude Code、Cursor、Gemini CLI 和 Grok Build。本地使用免费。
• keeploop-remote 适用于 Grok Bot。它通过 Keeploop 托管的连接器 https://mcp.keeploop.app/mcp 连接，并在 Cursor 编辑器中隐藏。远程使用需要 Keeploop Pro 或其免费试用版；本地使用免费。

本地插件提供：

• Keeploop 工具（邮件、会话和附件、日历和空闲时间、消息、笔记、联系人和 Slack；收到回复时唤醒 Agent 的监视器；以及用你的语气撰写的草稿）。 这些工具由 Keeploop 应用通过一个小型启动器提供；此仓库中的任何内容都不会自行读取你的数据。
• /keep- 命令：

命令	功能
/keep-today	今日日程、你需要回复的邮件，以及今天触发的监视器
/keep-free [length and range]	日历上的空闲时段，例如 /keep-free 30m this week
/keep-brief [account or category]	未读邮件、需要回复的内容，以及今天触发的监视器
/keep-reply	有人在等你回复的会话，每个会话都会附上建议的下一步操作
/keep-thread <subject or mail id>	总结完整对话：决策和未解决的问题
/keep-draft <mail id> <what to say>	撰写符合你风格的会话回复草稿。只保存草稿
/keep-find <description>	通过描述查找别人发给你的文件
/keep-waiting	你发出但尚未收到回复的邮件，按时间从早到晚排列
/keep-settings [what to change]	查看 AI 可以执行的操作，或提出更改建议以供在 Mac 上批准
/keep-help	列出命令

要求

• 搭载 Apple Silicon、运行 macOS 26 或更高版本的 Mac。
• Keeploop 应用，安装在 /Applications（或 ~/Applications）并至少打开过一次。 可从 keeploop.app 获取。没有此应用时，插件的服务会停止运行，并显示“Keeploop is not installed on this Mac. Install Keeploop from https://keeploop.app ...”。

如果你已经安装了 Keeploop，最简单的方法是前往 Keeploop > Settings > Connect，由它为你安装此插件。

安装

Claude Code

/plugin marketplace add keeploopapp/claude-plugin
/plugin install keeploop@keeploop

或者在终端中运行：

claude plugin marketplace add keeploopapp/claude-plugin
claude plugin install keeploop@keeploop

重启 Claude Code，然后输入 /keep-help。

Cursor

在 Customize 中从 Cursor Marketplace 安装 Keeploop，或将此仓库添加为插件来源。插件会向 Keeploop 报告自身为 Cursor，因此 Keeploop 针对各应用的规则会生效。

Grok Build

Grok Build 会读取 Claude Code 市场，因此只需使用上面的 Claude Code 命令即可。

Gemini CLI

gemini extensions install https://github.com/keeploopapp/claude-plugin

此扩展运行的启动器与插件相同（仓库根目录中的 gemini-extension.json 和 GEMINI.md）。重启 Gemini CLI，然后询问“我今天有哪些邮件需要回复？”

Grok Bot

在 Grok Bot 中打开 Connect apps，找到 Keeploop 并添加（即 keeploop-remote 插件）。在弹出的窗口中登录 Keeploop，然后在 Mac 上批准 Grok Bot。

网页和手机 AI 应用（Claude、ChatGPT、Grok、Poke 等）

此插件适用于 Mac 上的 AI 应用。若要从 claude.ai、ChatGPT（包括 dots）、grok.com、Poke 或任何可添加自定义 MCP 连接器的应用使用 Keeploop，请添加以下 URL：

https://mcp.keeploop.app/mcp

在应用打开的窗口中登录 Keeploop，然后在 Mac 上批准该应用。所有用户使用的都是同一个 URL；只有在你于 Mac 上批准后，它才能连接到你的 Mac。在 Keeploop 中允许更多权限之前，远程应用只能读取。网页和手机 AI 应用需要 Keeploop Pro 或免费试用版；Mac 上的插件可在 Free 版中使用。各应用的分步说明： https://keeploop.app/your-ai-apps。

插件包含的内容

• plugins/keeploop/server/keeploop-mcp：一个 shell 启动器，用于在 Keeploop.app 内运行连接器（其签名路径为 Contents/MacOS/keeploop-mcp）。Keeploop 应用会检查该签名，并将你的权限应用于每次调用。
• plugins/keeploop/skills/keep-*：以纯 Markdown 编写的命令。
• plugins/keeploop/hooks/hooks.json：一个 Claude Code SessionStart 钩子，用于告知 Keeploop 当前运行的是哪个会话，让监视器可以唤醒提出请求的会话。应用未安装时，此钩子不执行任何操作。
• plugins/keeploop-remote/：Grok Bot 插件。其 mcp.json 仅包含地址 https://mcp.keeploop.app/mcp，并且包含相同的 skills/keep-*。它不会在你的电脑上运行任何程序。
• .claude-plugin/ 和 .cursor-plugin/：市场清单文件。

本地插件不会建立网络连接、下载代码或安装软件包。启动器只会在 Mac 上运行 Keeploop 应用的连接器；连接器通过本地连接与 Keeploop 应用通信，因此整个过程中不会经过 Keeploop 服务。如果你也通过网页或手机 AI 应用使用 Keeploop，则会建立另一条独立连接：你的数据保留在 Mac 上，Keeploop 的连接服务会将请求传递到 Mac，再把结果传回。它绝不会存储这些数据。应用本身可以发送哪些内容，以及仅在你开启相应功能时发送的内容，请参阅隐私政策。

隐私政策

完整政策请访问 https://keeploop.app/privacy。简而言之：

• **收集：**此插件不收集任何内容。它会启动 Keeploop 应用的连接器；只有在 AI 应用调用工具时，连接器才会读取 Mac 上已有的 Apple Mail 数据（以及你开启的任何其他来源）。
• **使用和存储：**结果会发送给发起请求的 AI 应用，并保留在 Mac 上。Keeploop 仅在 Mac 上保留其设置和监视器。
• **共享：**不会共享。使用此插件时，整个过程中不会经过 Keeploop 服务。如果你也使用上方的网页和手机 URL，我们的连接服务会将请求传递到 Mac，再把结果传回，并且绝不会存储这些数据。
• **保留：**插件不会保留任何数据。连接服务会保留账户、设备和批准记录，直至你将其删除；安全事件元数据则保留 30 天。
• **联系：**[email protected]

支持

• 条款：https://keeploop.app/terms
• 支持：https://keeploop.app/support 或 [email protected]

许可证

此代码库中的文件采用 MIT 许可证（参见 LICENSE）。Keeploop 应用本身是独立的专有软件，不属于此代码库。

此代码库由 Keeploop 发布构建生成；如需提交更改，请创建议题，而非提交拉取请求。