dear-agent

亲爱的 Agent

你的 AI Agent 替你记日记。你不必打开应用，也不必写一个字。

你每天都在和 AI Agent 交谈。Dear Agent 能让 Agent 悄悄帮你记录个人生活——把你告诉它的事、发送的照片和录制的语音备忘，按日期妥善归档。不必打开应用，不必面对空白页面，也不必养成习惯。你只管过好自己的生活，并提起重要的事；写日记就交给 Agent。

它由一个本地优先的 MCP 服务和一个技能组成，因此可接入任何支持 MCP 的 Agent：Claude Code、Claude Desktop、Cursor、OpenClaw 等。

与众不同之处

• 你不用写，Agent 来写。 其他所有日记工具——Day One、Obsidian、Notion、纸质笔记本——都需要你打开并输入内容。Dear Agent 则反其道而行：你来讲，它来记。
• 跨 Agent 使用。 无论你使用哪个 Agent，都能读取和写入同一本日记。
• 支持文本、照片和语音。 发送照片或语音备忘，它就会归档到当天的条目中。
• 本地优先，归你所有。 日记以纯 Markdown 格式保存在你自己的磁盘上。无需账户、无需云端，也不会被锁定。删除文件夹，所有内容也随之删除。
• 与你一同记住。 “这一天”功能会重新呈现过去的日记条目；每周摘要则让 Agent 为你写下一段简短回顾。

安装

npm install -g dear-agent

也可以直接通过 npx 运行（无需安装）：

npx dear-agent

Claude Code / Claude Desktop

claude mcp add dear-agent -- npx -y dear-agent

也可以添加到 MCP 配置中：

{
  "mcpServers": {
    "dear-agent": {
      "command": "npx",
      "args": ["-y", "dear-agent"]
    }
  }
}

Cursor / OpenClaw / 其他 MCP 客户端

将客户端指向 dear-agent 命令（stdio 传输）。如果想将日记存放在 ~/.dear-agent 以外的位置，请设置 DEAR_AGENT_DIR。

然后将 SKILL.md 放入 Agent 的技能目录，让它知道要主动为你记日记。

使用方法

你不必亲自调用工具，只要和 Agent 交谈：

“记一下，我今天签完了公寓租约，感觉如释重负。” “把这张照片存到今天的日记里——在新家吃的第一顿晚餐。”（发送照片） “一年前的今天，我在做什么？” “给我总结一下这周的情况。”

Agent 会调用合适的工具，让日记保持更新。

它会记住你，也会回应你

Dear Agent 不只是存储工具。它具备两项能力，能让日记成为你生活中鲜活的记忆：

• recall——Agent 可以向日记询问：“你对这个人了解多少——包括他身边的人、行为模式和待完成的承诺？” 随后获取综合画像。Agent 终于能记住你的生活，让每次对话都基于真实的你展开。
• reflect——一个主动运行的循环，会呈现行为模式、进展、未完成的事项和“这一天”的回忆，让日记把你的生活映照给你，而不是静静躺在文件夹里。

Obsidian 保存你的笔记。Dear Agent 记住你的生活，并回应你。 而且它的内容从不离开你的设备，因此你可以在这里完全坦诚。

适用于任何 Agent、运行框架或界面

界面	用法
MCP 工具	通过 stdio 提供 11 个工具（见下文）。
MCP 提示词	daily_checkin、weekly_reflection——可作为斜杠命令使用。
MCP 资源	diary://today、diary://index。
技能	SKILL.md，适用于基于技能的运行框架（Claude Code、OpenClaw）。
CLI	dear-agent add "..."、recall、reflect 等——适用于任何能运行 shell 的 Agent。

CLI 示例：

dear-agent add "Closed the interview, felt good." --mood hopeful --tags job,win
dear-agent recall Sarah
dear-agent reflect week
dear-agent on-this-day

工具

工具	功能
add_entry	为某一天保存一段文字记录（可选心情和标签）。
add_photo	为某一天保存一张照片（本地路径或 base64），并附上说明。
add_voice_note	为某一天保存一段语音笔记，可选择附上转录文本。
get_day	读取某一天的完整记录。
get_range	读取两个日期之间的记录。
search	查找包含某个词语或短语的日期。
recall	查看日记中关于某个人或主题的信息，或获取完整人生档案摘要。
reflect	查看模式、进展、待办事项和「历史上的今天」，用于主动签到。
on_this_day	重新浏览往年这一天的记录。
weekly_digest	调取最近 7 天的记录，用于回顾。
list_days	列出所有有记录的日期。

日期可使用 today、yesterday 或 YYYY-MM-DD。

日记存储位置

~/.dear-agent/
  entries/
    2026-06-29.md
  media/
    2026-06-29/
      first-dinner.jpg
      morning-thought.ogg

设置 DEAR_AGENT_DIR 可选择其他位置。

参与贡献

欢迎提交问题和拉取请求。Dear Agent 有意保持轻量，并尽量减少依赖——请专注于必要的更改，将数据保存为用户拥有的纯文件，并确保所有内容始终在本地处理且保持私密。请参阅 ROADMAP.md，了解未来计划。

许可证

MIT © BitmapAsset。任何人都可以在任何地方、任何 Agent 中免费使用。