Kody

---

Kody 是属于你的 Agent 云端空间：AI Agent 留存的记忆、密钥、代码和自动化，可在所有 MCP 主机之间移植。Kody 基于 Cloudflare Workers 和模型上下文协议（MCP）构建，提供 TanStack Start 网站、基于 Worker 的请求路由、包运行时支持，以及受 OAuth 保护的 MCP 端点。该项目采用精简的 MCP 接口，侧重强大的 search 和 Code Mode execute 工作流，而非庞大的静态工具目录。

Kody 面向个人和团队（组织、团队、资助项目）：每个账户都拥有相互隔离的包、作业、凭据、记忆及相关状态。测试和 fixture 可以预置确定性的本地账户，但运行时没有任何账户享有特殊权限。此代码库遵循若干 epicflare 起步项目约定。

此代码库采用 Nx 单体仓库结构，共享模块位于 packages/shared（@kody-internal/shared），源站应用 Worker 位于 packages/worker，同级 Worker 位于 packages/platform-worker、 packages/runtime-worker 和 packages/jobs-worker，模拟 Worker 位于 packages/mock-servers/*。生产环境拓扑见 docs/contributing/architecture/index.md。

快速开始

npm install
npm run dev

开发服务器默认运行在 localhost:3742（CLI 会选择下一个可用端口并打印解析后的 URL）。Wrangler 会自动处理本地 Cloudflare Workers 运行时和 D1 数据库。

若要改为从 epicflare 模板搭建一个新项目，请运行 npx create-epicflare。

有关完整的设置流程和预期要求，请参阅 docs/contributing/getting-started.md。 贡献者和 Agent 应从 AGENTS.md 开始了解此代码库的具体指南。

如果你想了解此代码库的用途，请先阅读 docs/contributing/project-intent.md。

技术栈

层级	技术
运行时	Cloudflare Workers
UI 框架	TanStack Start
包管理器	npm
工作区	Nx + npm workspaces
数据库	Cloudflare D1
会话/OAuth	Cloudflare KV
MCP 状态	kody-platform 上的 Durable Objects
E2E 测试	Playwright
打包工具	Vite

范围

• 面向个人和团队的 Fair Source 平台，而非通用 Agent 框架
• 采用 MCP 优先架构，旨在兼容各种 AI Agent 宿主
• 优先采用紧凑的 MCP 接口，而非大量静态工具清单
• ChatGPT 可能是主要宿主目标，同时也尽可能确保服务可供其他 MCP 宿主使用

工作原理

kody.codes  → kody-production (origin: TanStack Start, /mcp HTTP, OAuth, email, queues)
                 ├─→ kody-platform  (MCP / mailbox / meter / repo-session DOs)
                 ├─→ kody-runtime   (package apps, invoke API, StorageRunner)
                 └─→ kody-jobs      (cron + JobManager; calls back via JobsHost)

kody.run    → kody-runtime (package-app zone routes)

• packages/worker/src/index.ts 是源站入口；平台、运行时和作业各有独立的同级入口（参见架构）
• 先处理 OAuth 请求，再处理 MCP 请求，最后处理静态资源
• Webhook 入口（包括 GET 订阅验证请求）在 TanStack Start 之前由 Worker 的 fetch 路径处理
• 其余网站请求由 TanStack Start 处理 （packages/worker/start/http-entry.ts）
• 客户端资源会打包到 packages/worker/public/，并通过 ASSETS 绑定提供

文档

文档	说明
docs/contributing/getting-started.md	设置、环境变量、部署
docs/contributing/environment-variables.md	添加新的环境变量
docs/contributing/cloudflare-offerings.md	可选的 Cloudflare 集成
docs/contributing/project-intent.md	范围、目标和非目标
docs/contributing/index.md	开发和扩展 Kody
docs/use/index.md	通过 MCP 使用 Kody
docs/contributing/setup/	本地开发与验证

贡献

向本仓库提交外部 Pull Request 需要签署贡献者许可协议。 公共包不使用该 CLA。

请参阅 CONTRIBUTING.md 和 docs/contributing/index.md。

许可

Kody 根据 Functional Source License, Version 1.1, ALv2 Future License （FSL-1.1-ALv2）授权。除竞争性使用外，你可以出于任何目的使用、复制、修改该软件，基于该软件创作衍生作品，公开表演、公开展示该软件，以及重新分发该软件。竞争性使用是指在商业产品或服务中向他人提供该软件，且该产品或服务替代 Kody、替代许可方在该版本发布时提供的、使用 Kody 的其他产品或服务，或提供相同或基本相似的功能。每个版本自发布之日起满两周年后，将根据 Apache License 2.0 提供。

通过 Kody 发布的公共软件包不使用本仓库的 CLA，也没有许可门槛；这与本仓库的许可证相互独立。

---