Celorga：本地优先的 AI 智能体工作区

项目简介

Celorga 是一个开源工作区，用于在你的笔记、任务、会议和数据上运行 AI 智能体。所有内容都以普通的 .org 文件保存，这些文件归你所有；桌面应用、编辑器、CLI 和智能体都通过同一套共享运行时读取它们。

仓库中包含：

• Celorga 应用：原生 Mac 应用（智能体、议程、笔记、会议、数据、发布）、iPhone 应用，以及用于常驻智能体的无头服务器。
• Celorga 运行时：独立规范的 Org 解析器与语义配置、celorga CLI、MCP server、language server，以及 VS Code 和 Vim/Neovim 编辑器插件。它不依赖 Emacs。

官方网站同时充当文档，包含入门、功能与开发者参考。

主要功能

• 本地优先：数据是你能直接打开、版本管理的纯文本 Org 文件，而不是锁在某个服务里的数据库。
• 多端应用：Mac 应用覆盖智能体、议程、笔记、会议、数据与发布；另有 iPhone 应用和无头服务器。
• 统一的运行时：CLI、MCP server、language server 与编辑器插件共享同一套 Org 解析与语义实现。
• 面向智能体：智能体可以查询当前安装版本支持的能力。
• 技能安装：可把 Celorga 的通用智能体技能装入语料库，先预览再应用。
• 发布：可以把 Org 源文件发布成站点。

安装与使用

从官网下载 Mac 应用，或在 macOS / Linux 上安装 CLI：

npm i -g celorga
celorga agenda --dir ~/notes --recursive
celorga mcp serve --dir ~/notes

智能体可以查看当前版本支持的能力：

celorga agent capabilities

把通用智能体技能加入语料库（先预览，再使用 --apply 实际应用）：

celorga skill install --dir ~/notes

从源码开发

需要 Node.js 22；Mac 应用还需要 Xcode 与 Swift，运行环境为 macOS 14 或更高版本。

npm ci
npm run build
npm run celorga -- --help      # 在当前检出目录运行 CLI

测试与检查：

npm test                       # 完整 Node 测试套件（并行，可用 --jobs N 调整）
node test/test-NAME.mjs        # 运行单个测试，需先 npm run build
npm run test:macos             # 原生 macOS 测试套件
npm run docs:check             # 文档与能力清单检查

构建 Mac 应用：

npm run build:macos-app:codex  # 构建并安装隔离的预览版应用，带独立 bundle 标识与一次性演示语料
npm run open:macos-app:codex   # 启动该预览应用
make macos-app                 # 构建并替换日常使用的应用

网站源码位于 docs/site/（Org 格式），不要直接修改生成的 site/ 目录，重新生成方式：

npm run celorga -- publish docs-site --config celorga.json

推送到 main 分支会自动部署站点。

注意事项

• 项目采用 Apache License 2.0 许可。
• Celorga 曾用名 OpenOrg 和 Org2。
• 语言与自动化行为应放在 TypeScript 运行时中，应用和编辑器消费运行时，而不是各自解析 Org；这是仓库的贡献约定。

---

本作品整理自 GitHub 开源项目 aviaviavi/celorga，原作者 @aviaviavi，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。