把笔记留在自己的文件里：Celorga 如何为 AI Agent 提供可检查的工作区
不少 AI 助手能总结一段对话，却很难把任务、会议结论和项目背景稳妥地带到下一次工作中。把所有资料塞进某个应用的专有数据库，又会让迁移、版本控制和人工检查变得麻烦。Celorga 选择了另一条路：把普通 Org 文本文件作为资料的持久来源，再为人和 Agent 提供共享的视图与接口。
这让它值得从「又一个笔记应用」之外来理解。它关注的是个人工作区与 Agent 运行时之间的边界：文件由用户持有，Agent 通过明确配置的接口获取有限上下文，执行结果也可以回到可检查的工作记录中。
核心不是一个常驻自主 Agent
Celorga 的官方入门文档把几个角色区分得很清楚：corpus 是一组普通本地文件，是长期记忆和事实来源；Celorga runtime 负责解析文件、提供 Agenda 等视图并暴露工具；Codex、Claude Code 等 harness 才是实际推理和行动的 Agent 运行时。一次 Agent 调用读取的是当轮选择或授权的上下文，不意味着它会默默吸收整个工作区或持续监视文件夹。
这个边界有两个实际好处。首先，笔记可以用文件管理器、Git 或其他编辑器查看，不必把资料锁进应用私有数据库。其次，聊天不再是唯一存放决策的地方：讨论得到的决定可以落到项目笔记，待办可以写成任务并设定日期，之后仍能从原始上下文追溯。
先从一个任务开始
官方指南建议先安装 macOS 应用并打开初始工作区，在当天笔记中写一条想法，再通过 Capture 添加一个带日期的任务，最后到 Agenda 中确认它出现。Org 文件的结构保持直白，例如：
* 版本发布 发布前确认升级说明与回滚步骤。 ** TODO 整理发布公告 SCHEDULED: <2030-01-15 Tue>
标题、TODO 状态和 SCHEDULED 日期都留在文本文件里；Agenda 则从这些记录生成任务视图。已有 Org 目录也可以作为工作区使用，不必先迁移成另一种专有格式。官方资料特别指出，Celorga 不依赖 Emacs，但仍以普通 Org 文件为中心；用 Emacs 的用户可以继续使用原有文件。
让 Agent 通过 MCP 读取资料
在 macOS 或 Linux 上，README 给出的 CLI 安装和本地 MCP 启动方式是：
npm i -g celorga celorga mcp serve --dir ~/notes
实际部署时建议把路径换成确定的绝对路径，并先在客户端检查 MCP 连接状态。官方 MCP 文档将本地 stdio 作为常见方式：由兼容的 MCP 客户端启动并管理进程，不需要额外开一个长期对外暴露的网络服务。服务只针对指定 corpus 工作；不要把 --dir 指向含有不相关私人资料的上级目录。
Celorga 的文档列出了搜索、读取和组装有引用上下文等工具能力。这样 Agent 可以先找相关笔记，再读取有限范围的内容，而不是把所有文件整体复制进提示词。官方文档还区分本地 stdio 与 headless server 的远程 HTTP MCP：后者的 HTTP listener 是只读接口，绑定到配置的 Tailscale 地址；它不是面向公网的 HTTPS 服务。若要从托管平台远程连接，必须另行评估可达性、认证和 TLS 代理的暴露边界，不能把本地示例直接搬到公网。
更适合什么人，暂时不适合什么人
如果你已经积累 Org 笔记，希望 Agent 能检索项目背景、任务与会议记录，同时保留纯文本和人工审阅能力，Celorga 的文件优先设计很有吸引力。若团队已经依赖另一套格式，或希望开箱即用地把任意目录都交给 Agent，则应先核对格式兼容性、授权范围和当前客户端支持情况。macOS 应用是其完整工作体验的重要部分；CLI 则支持 macOS 与 Linux，不能据此推断完整图形应用也支持 Linux。
可以从一份非敏感的小型笔记目录试起：安装 CLI，连接本地 MCP，询问 Agent 搜索一个确定存在的项目条目；随后检查它引用的文件是否正确、是否越过选定工作区，并确认任何建议改动都能回到普通文件中审阅。先验证访问边界，再逐步加入真实资料，比一次性开放整个主目录稳妥得多。
Celorga 的重点不是让 Agent 自动替你记住一切，而是让长期上下文有一个用户掌控、可以阅读的落点。对重视可迁移性与可追溯性的开发者来说，普通文件、任务视图和受限 MCP 接口组合在一起，提供了一种比「把全部记忆交给聊天记录」更容易检查的工作方式。
相关链接