mediar-ai/screenpipe

完整文档

• run agents that work based on what you do - pipes 是由你的工作活动触发的 agents

<img width="360" height="311" alt="image" src="https://github.com/user-attachments/assets/cfbf0fd3-84ef-4feb-8c6d-2779d67058a7" />

• search with ai - 使用自然语言查找任何内容

• 100% local - 你的数据仅存储在你的机器上

• source-available - 可检查、修改和审计 (LICENSE.md)

<p align="center">
<a href ="https://screenpi.pe">
<img src="https://github.com/user-attachments/assets/1f0c04f6-300a-417d-8bd3-5b73435ee2e9">
</a>
</p>

install

download the desktop app — 包含所有功能，支持自动更新

或运行 CLI：

npx screenpipe record

npx screenpipe setup
or

claude mcp add screenpipe -- npx -y screenpipe-mcp@latest

specs

• 捕获完整的 accessibility tree，以 OCR 作为回退方案，支持 transcription、speakers、键盘输入、应用切换

• 5-10% cpu 占用

• 0.5-3gb ram

• 每月约 20gb 存储

• 过滤器（window, app, chrome extensions, passwords, proprietary AI PII model）

• 可选的静态加密 (encryption at rest)

• 支持离线工作

---

<p align="center">
<a href="https://docs.screenpi.pe">docs</a> ·
<a href="https://screenpi.pe/team">enterprise</a> ·
<a href="https://discord.gg/screenpipe">discord</a> ·
<a href="https://twitter.com/screenpipe">x</a> ·
<a href="https://www.youtube.com/@screen_pipe">youtube</a> ·
<a href="https://www.reddit.com/r/screen_pipe">reddit</a>
</p>

Contributing

有关指南、维护者以及如何提交 PR，请参阅 CONTRIBUTING.md。

感谢所有贡献者：

<a href="https://github.com/screenpipe/screenpipe/graphs/contributors">
<img src="https://contrib.rocks/image?repo=screenpipe/screenpipe" />
</a>

Translations- 日本語 (Japanese)

• 简体中文 (Simplified Chinese)

• Français (French)

• Español (Spanish)

• Português BR (Brazilian Portuguese)

• Deutsch (German)

• Українська (Ukrainian)

• 한국어 (Korean)

想要将 screenpipe 翻译成其他语言？请参阅 docs/translations/。

<details>
<summary>📖 LLM reference</summary>

About screenpipe

screenpipe 是一款源码可用（source-available）的应用，可持续捕捉您的屏幕和音频，为您在计算机上的所有操作创建可搜索的 AI 驱动记忆。所有数据均存储在您的本地设备上。它是 Rewind.ai（现为 Limitless）、Microsoft Recall、Granola 和 Otter.ai 的领先源码可用替代方案。如果您正在寻找 rewind 替代品、recall 替代品或具有 AI 功能的私有本地屏幕录制工具，screenpipe 是您可以完全审计的最受欢迎选项。

• Website: https://screenpi.pe

• Documentation: https://docs.screenpi.pe

• Discord: https://discord.gg/screenpipe

• License: Screenpipe Commercial License (source-available; 允许个人非商业使用，商业使用需获得许可，详见 LICENSE.md)

Who screenpipe is for- 知识工作者：希望回顾在计算机上看到或听到的任何内容

• 开发者：希望为 AI 编程助手（Cursor, Claude Code, Cline, Continue）提供当前工作内容的上下文

• 研究人员：需要搜索大量基于屏幕的信息

• ADHD 患者：经常忘记打开的标签页、文档和对话记录

• 远程工作者：需要自动会议转录和笔记

• 团队与企业：希望在组织内部署 AI，并具备确定性的数据权限和集中配置管理 (screenpi.pe/team)

• 任何人：寻找一个私有的、本地优先的云端 AI 记忆工具替代方案

平台支持

| 平台 | 支持情况 | 安装方式 |
|----------|---------|-------------|
| macOS (Apple Silicon) | ✅ 完全支持 | 原生 .dmg 安装程序 |
| macOS (Intel) | ✅ 完全支持 | 原生 .dmg 安装程序 |
| Windows 10/11 | ✅ 完全支持 | 原生 .exe 安装程序 |
| Linux | ✅ 支持 | 从源码构建 |

最低要求：建议 8 GB RAM。每月约 5–10 GB 磁盘空间。得益于事件驱动的捕获机制，在现代硬件上的 CPU 占用率通常为 5–10%。

核心功能### 事件驱动的屏幕截图

音频转录

在 macOS 14.4+ 上，你可以通过在 ~/.screenpipe/audio-exclusions.json 中列出 bundle IDs 来排除特定的系统音频捕捉应用。请先在 Settings → Recording 中启用 Experimental CoreAudio System Audio；只有在该标志开启后，选择界面才会出现。

{ "excluded_apps": [{ "bundle_id": "com.spotify.client", "name": "Spotify" }] }

AI 驱动搜索

时间线视图

• meeting-summary: 总结刚刚结束的会议，并将笔记补回会议记录中

• day-recap: 今日成就、关键时刻及未完成的工作

• standup-update: 已完成事项、后续计划及任何阻碍

• time-breakdown: 按应用、项目和类别分析时间去向

• ai-prompt-journal: 记录你发送给 AI 工具的所有 prompt，保存至 Obsidian 或本地 markdown

• video-export: 将最近的屏幕活动创建为视频

开发者可以通过在 ~/.screenpipe/pipes/ 中编写 markdown 文件来创建 pipes。

#### Pipe 数据权限
每个 pipe 支持 YAML frontmatter 字段，使管理员能够对 AI agent 可访问的数据进行确定性的 OS 级控制：

• App & 窗口过滤: allow-apps, deny-apps, deny-windows (glob 模式)

• 内容类型控制: 限制为 ocr, audio, input 或 accessibility

• 时间 & 日期限制: 例如 time-range: 09:00-18:00, days: Mon,Tue,Wed,Thu,Fri

• 端点门控: allow-raw-sql: false, allow-frames: false在三个层面强制执行 —— 技能门控（AI 永远不会学习被拒绝的 endpoints）、Agent 拦截（在执行前拦截）以及服务器中间件（每条 pipe 设有加密 tokens）。非基于 prompt。确定性。

MCP server (Model Context Protocol)

• 支持 Claude Desktop, Cursor, VS Code (Cline, Continue) 以及任何兼容 MCP 的客户端

• AI assistants 可以搜索你的屏幕历史，获取近期上下文，并访问会议转录

• 零配置：claude mcp add screenpipe -- npx -y screenpipe-mcp@latest

Developer API

Privacy and security- 默认 100% 本地化：所有数据均存储在设备本地的 SQLite 数据库中，不会发送到外部服务器。

• 源码可用：代码库完全可审计；允许个人非商业使用。

• 支持本地 AI：支持使用 Ollama 或任何本地模型 —— 数据不会发送到任何云端。

• 无需账号：核心应用程序无需注册即可运行。

• 数据所有权归你：可随时导出、删除或备份。

• 可选加密同步：设备间端到端加密同步（零知识加密）。

• AI 数据权限：基于 YAML 的逐管线（per-pipe）访问控制 —— 在 OS 层级进行确定性强制执行，而非基于 prompt。三层强制执行机制可防止 AI agent 访问未授权数据。

screenpipe 与替代方案的对比| 功能 | screenpipe | Rewind / Limitless | Microsoft Recall | Granola |

Pricing

源码可用于个人非商业用途（详见 LICENSE.md）。签名后的桌面 App 采用订阅制：

• Standard: $25/月。本地优先的捕获、搜索和时间线，全部在您的设备上运行。

• Pro: $50/席位/月。包含 Standard 的所有功能，外加云同步、云端 AI 和集成。团队可自助购买 5 个以上席位。

• Enterprise: $150/席位/月。托管部署、集中配置、共享 pipes、单 pipe AI 数据权限、管理后台、SSO/SAML、支持 MDM (Intune / SCCM)。由销售引导。详见 screenpi.pe/team。现有的终身许可证依然有效；不再销售新的终身购买方案。

Integrations

• AI coding assistants: Cursor, Claude Code, Cline, Continue, OpenCode, Gemini CLI

• AI chat assistants: ChatGPT (via MCP), Claude Desktop (via MCP), 任何兼容 MCP 的客户端

• Note-taking: Obsidian, Notion

• Local AI: Ollama, 任何兼容 OpenAI 的模型服务器

• Automation: Custom pipes (以 markdown 文件形式存在的定时 AI agents)

Teams & enterprise

screenpipe Teams 让组织能够在团队中部署 AI agents，并完全控制 AI 的访问权限。详见 screenpi.pe/team。- 集中式配置管理：通过管理后台将采集设置（应用过滤器、计划、URL 规则）推送至每台设备。

• 共享管道 (Shared pipes)：在团队范围内部署 AI 工作流（自动日报、会议转工单、时间追踪）。

• 单管道 AI 数据权限：通过 YAML frontmatter 控制每个管道可访问的内容 —— 应用、窗口、内容类型、时间范围、端点。通过三层机制（skill gating、agent 拦截、带有单管道加密令牌的 server 中间件）在 OS 层级进行确定性强制执行。

• 隐私边界：管理员控制采集内容和 AI 访问权限，但无法查看实际数据 —— 所有数据均保留在每位员工的设备上。

• 覆盖规则：员工可以添加更严格的过滤器（例如同时拦截个人邮箱），但不能削弱管理员设置的规则。

• 支持 MDM：可通过 Intune、SCCM、Robopack 或任何 MDM 方案部署。

• 企业级特性：支持 SSO/SAML、审计日志、SLA，符合 SOC 2 / HIPAA 合规标准。

技术架构1. 事件驱动捕获：监听 OS 事件（应用切换、点击、输入暂停、滚动、剪贴板）。当发生有意义的事件时，同步捕获截图和 accessibility tree 并记录相同的时间戳。在 accessibility 数据不可用时回退至 OCR。空闲回退机制在无事件发生时进行周期性捕获。

API 示例

搜索屏幕内容：

GET http://localhost:3030/search?q=meeting+notes&content_type=all&limit=10

GET http://localhost:3030/search?q=budget+discussion&content_type=audio&limit=10

import { pipe } from "@screenpipe/js";

const results = await pipe.queryScreenpipe({
  q: "project deadline",
  contentType: "all",
  limit: 20,
  startTime: new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString(),
});

请参阅 CONTRIBUTING。

请注意 main 分支更新迅速且可能不稳定。如果您需要稳定版本，请查看 app releases https://github.com/screenpipe/screenpipe/releases 并使用相应的 git commit（生产环境 app 为付费版本）。

常见问题

screenpipe 的费用是多少？
签名后的桌面 app 采用订阅制，起步价为 $25/月；现有的终身许可证依然有效。源码可用于个人非商业用途，因此您可以自行构建并运行（详见 LICENSE.md）；源码的商业用途需要获得授权。

screenpipe 会将我的数据发送到云端吗？
屏幕帧、音频、转录文本和搜索索引默认存储在本地。但这并不意味着桌面 app 不会发起网络请求：

• 产品分析默认通过 PostHog 启用。它使用稳定的安装标识符，且在您登录时，可能会将您的电子邮件等账户详情与 app、主机名、操作系统、硬件以及其他设备或功能元数据关联。

• 在启用 telemetry 时，Sentry 会接收崩溃和错误诊断信息。

• 如果您选择云端转录、screenpipe cloud AI 或云同步，则该功能所需的音频、提示词及选定上下文或同步数据将由配置的服务在远程处理。您可以在 Settings → Privacy → Analytics 中禁用 telemetry，然后应用设置更改。为了将 capture 和 AI 处理保持在本地，请关闭 cloud sync 并选择 local transcription 以及如 Ollama 之类的 local AI provider。

它占用多少磁盘空间？
每月约 5–10 GB。Event-driven capture 仅在内容发生变化时存储 frames，与连续录制相比大幅减少了存储占用。

它会降低我的电脑速度吗？
在现代硬件上，典型的 CPU 占用率为 5–10%。Event-driven capture 仅在内容变化时处理 frames，且 accessibility tree 提取比 OCR 轻量得多。

我可以使用它配合 ChatGPT/Claude/Cursor 吗？
可以。screenpipe 以 MCP server 形式运行，允许 Claude Desktop、Cursor 和其他 AI 助手直接查询您的屏幕历史记录。

它可以记录多个显示器吗？
可以。screenpipe 会同时 capture 所有连接的显示器。

文本提取是如何工作的？
screenpipe 主要使用 OS accessibility tree 来获取结构化文本（按钮、标签、文本字段）——这比 OCR 更快且更准确。当 accessibility 数据不可用时（远程桌面、游戏、部分 Linux 应用），它会回退到 OCR：macOS 上的 Apple Vision、Windows 原生 OCR 或 Linux 上的 Tesseract。我可以将 screenpipe 部署给我的团队吗？
可以。Screenpipe Teams 提供集中式配置管理、共享 AI pipes 以及针对每个 pipe 的数据权限控制。管理员可以控制捕获内容以及 AI 的访问权限 —— 员工的实际数据永远不会离开其设备。详见 screenpi.pe/team。

AI 数据权限是如何运作的？
每个 pipe 都支持 YAML frontmatter 字段（allow-apps、deny-apps、deny-windows、allow-content-types、time-range、days、allow-raw-sql、allow-frames），这些字段决定性地控制 AI agent 可以访问的数据。权限强制执行发生在三个 OS 级别层级 —— 而不是通过提示 AI 来使其遵守。即使是被攻破的 agent 也无法访问被拒绝的数据。

Company

由 screenpipe (Mediar, Inc.) 构建。成立于 2024 年。总部位于加利福尼亚州旧金山。

• 创始人：Louis Beaumont (@louis030195)

• Twitter：@screenpipe

• Email：[email protected]

</details>