jot

jot

为每个 AI Agent 提供共享的本地优先记忆。

告诉 Claude Code 你使用 pnpm，明天 Cursor 就会知道。jot 是你机器上的一份记忆，所有支持 MCP 的 Agent 都能读取和写入。它以纯 Markdown 格式存储，并通过 git 进行版本管理。

$ jot add -k preference -t js "Use pnpm, never npm"
remembered 20261103-134832-fb9e (global)

$ jot search "package manager"
20261103-134832-fb9e  preference global  Use pnpm, never npm  #js

为什么选择 jot

• 一份记忆，所有 Agent 共享。 Claude Code、Cursor、Codex 和任何 MCP 客户端都能共享它。
• 属于你，存储在本地。 每份记忆都是易读的 .md 文件。不用云服务、无需账号，也不需要数据库。
• 由 Git 管理版本。 每次更改都会生成一次提交，因此可以免费查看差异、追溯修改记录和撤销更改。
• 零依赖。 一个仅使用标准库的静态 Go 二进制文件。

安装

从 Releases 下载适用于 macOS、Linux 或 Windows 的二进制文件，或使用 Go 1.23+ 构建：

go install github.com/ArpitK24/jot/cmd/jot@latest

它也已收录在 官方 MCP Registry 中，名称为 io.github.ArpitK24/jot，每次发布都会提供一键安装的 .mcpb 包。

然后创建你的记忆库：

jot init

接着按照 docs/setup.md 将 Agent 连接起来。以 Claude Code 为例：

claude mcp add jot --scope user -e JOT_SOURCE=claude-code -- jot serve

工作原理

~/.jot/                      global memory (or $JOT_HOME)
  20261103-134832-fb9e.md
  .git/
<repo>/.jot/                 optional project memory (jot init --project)

记忆文件示例：

---
id: 20261103-134832-fb9e
kind: preference
tags: [js, tooling]
source: claude-code
created: 2026-11-03T13:48:32Z
updated: 2026-11-03T13:48:32Z
---

Use pnpm, never npm.

检索时会使用 BM25 排序，并提高标签匹配项和近期更新项的排名；搜索范围先覆盖项目记忆，再覆盖全局记忆。

MCP 工具

工具	功能
remember	保存一条偏好、决策、事实或备注
recall	搜索与当前任务相关的记忆
update	重写已更改的记忆
forget	删除一条记忆
list	按类型或标签筛选并查看最新记忆

命令行

jot init [--project]     jot search <query>     jot show <id>     jot log
jot add [-k -t -p] text  jot ls [-k -t]         jot edit <id>     jot where
jot serve                jot rm <id>            jot version

路线图

• 合并近似重复的记忆，而不是不断堆积
• 为过时信息添加过期机制和审核功能
• 可选的本地嵌入（Ollama），用于语义检索
• 通过 git 远程仓库跨机器使用 jot sync
• TUI 浏览器

许可证

MIT