Penpal — Development skill for Claude Code

Penpal（笔友）

**给你所有 AI 共用的本地记忆。** Penpal 在你的 Mac 上记下你看过、写过、问过的东西，通过 MCP 交给 Claude Code、Codex、Cursor 查询，每条结果都能打开出处，每个 AI 能看到什么由你授权。

[English](README.en.md) · [快速开始](#快速开始) · [记什么不记什么](#记什么不记什么) · [现在做到哪](#现在做到哪)

[](https://www.python.org/downloads/) [](https://www.apple.com/macos/) [](tests/) [](LICENSE)

---

它解决什么

你在 Claude Code 里问："上周我看过一个讲 MCP 鉴权的网页，在哪？" 它答不上来。它没见过你的浏览器；就算让它跑 bash 去翻，浏览器历史 90 天后会过期，剪贴板、切过的窗口、在网页输入框里打过的字，本来就没落盘，事后谁也找不回。

装了 Penpal 之后，同一个问题，AI 调用 `search_context`，返回那条网页记录、你当时在哪个 App 里、前后在做什么，再用 `get_evidence` 打开原始出处，你自己核对是不是它。

Penpal 不做聊天入口，也不内置大模型。你继续在自己常用的 AI 里提问，Penpal 只负责"记得"和"给得准"。

为什么不直接让 AI 用 bash

AI 自己能读本机文件，只给已有文件建个索引，没必要单独装一个工具。Penpal 存在的理由只有下面三条，每个功能都要落在其中一条上，并且在对照评测里比"AI + bash"答得好：

	AI + bash	Penpal
本来不落盘的信息：窗口切换、剪贴板、网页里打过的字	找不回	采集时就记下
超过来源保留期的记录：Claude Code 会话约 30 天、Chrome 历史约 90 天	过期就没了	入库后一直保留，直到你删
受控访问	给 AI bash 等于开放整盘读取；Claude Desktop、沙箱里的 Codex 根本没有 bash	按 AI 单独授权、按分类限定范围、入库前脱敏、可撤销、每次查询有记录

两档安装，按需选

	CLI（必装的最小集）	桌面 App（可选，尚未发布）
给谁	只用终端的开发者	想直观看采集状态、做管理的人
包含	后台采集 + MCP 服务 + 全部控制命令	菜单栏控制中心：状态、来源开关、AI 授权、删除
核心能力	装好就能在 AI 里用全部核心能力	不多不少，同一套核心换一种用法

App 能做的事，CLI 都能做。只装 CLI 也不会"坏了没人知道"：采集停了、磁盘满了、权限丢了，AI 下次查询时会在结果里收到提醒并转告你。

快速开始

# 1. 安装 CLI，初始化运行环境，注册开机自启的后台服务
curl -fsSL https://raw.githubusercontent.com/Longfellow1/penpal/main/install.sh | bash
# 或手动：brew install longfellow1/penpal/penpal && penpal install init

# 2. 检查系统权限：缺哪个、该给哪个程序授权、去哪个设置面板，doctor 都会列出来
penpal doctor

# 3. 授权一个 AI，并按提示把配置加进去（命令会直接打印 Claude Code / Codex / Cursor 的配置）
penpal mcp grant claude --buckets Work,Personal

然后在 Claude Code 里正常提问，比如"我昨天下午在研究什么"。