Your agents' cloud: the memory, keys, code, and automations your AI agent keeps, portable across every MCP host. Built on Cloudflare Workers.
Kody is Your agents' cloud: the memory, keys, code, and automations your AI
agent keeps, portable across every MCP host. Built on Cloudflare Workers and the
Model Context Protocol (MCP), it ships a TanStack Start website, Worker-based
request routing, package runtime plumbing, and OAuth-protected MCP endpoints.
The project favors a compact MCP surface with powerful search and Code Mode
execute flows over a large static tool catalog.
Kody works for individuals and teams (orgs, teams, grants): each account holds isolated packages, jobs, credentials, memories, and related state. Tests and fixtures may seed deterministic local accounts, but no account is privileged at runtime. The repo follows several epicflare starter conventions.
The repo is organized as an Nx monorepo, with shared modules in
packages/shared (@kody-internal/shared), the origin app worker under
packages/worker, sibling workers under packages/platform-worker,
packages/runtime-worker, and packages/jobs-worker, and mock Workers under
packages/mock-servers/*. Production topology lives in
docs/contributing/architecture/index.md.
npm install
npm run devThe dev server runs at localhost:3742 by default (the CLI picks the next free
port and prints the resolved URL). Wrangler handles the local Cloudflare Workers
runtime and D1 database automatically.
To scaffold a new project from the epicflare template instead, run
npx create-epicflare.
See
docs/contributing/getting-started.md
for the full setup paths and expectations. Contributors and agents should start
with AGENTS.md for repo-specific guidance.
If you are trying to understand what this repository is for, start with
docs/contributing/project-intent.md.
| Layer | Technology |
|---|---|
| Runtime | Cloudflare Workers |
| UI Framework | TanStack Start |
| Package Manager | npm |
| Workspace | Nx + npm workspaces |
| Database | Cloudflare D1 |
| Session/OAuth | Cloudflare KV |
| MCP State | Durable Objects on kody-platform |
| E2E Testing | Playwright |
| Bundler | Vite |
- Source-available platform for individuals and teams, not a general-purpose agent harness
- MCP-first architecture intended to work across compatible AI agent hosts
- Compact MCP surface area preferred over a large static tool inventory
- ChatGPT is a likely primary host target, while keeping the server usable from other MCP hosts where practical
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.tsis the origin entrypoint; platform, runtime, and jobs have sibling entrypoints (see architecture)- OAuth requests are handled first, then MCP requests, then static assets
- Webhook ingress (including GET subscription challenges) is handled in the
Worker
fetchpath before TanStack Start - Remaining website requests go through TanStack Start
(
packages/worker/start/http-entry.ts) - Client assets are bundled into
packages/worker/public/and served via theASSETSbinding
| Document | Description |
|---|---|
docs/contributing/getting-started.md |
Setup, environment variables, deploy |
docs/contributing/environment-variables.md |
Adding new env vars |
docs/contributing/cloudflare-offerings.md |
Optional Cloudflare integrations |
docs/contributing/project-intent.md |
Scope, goals, and non-goals |
docs/contributing/index.md |
Developing and extending Kody |
docs/use/index.md |
Using Kody over MCP |
docs/contributing/setup/ |
Local development and verification |
Outside pull requests to this repository need a signed inbound Contributor License Agreement. Public packages do not use that CLA.
See CONTRIBUTING.md and
docs/contributing/index.md.
Free for personal, family, nonprofit, and classroom use. For any other use, email support@kody.codes.
Kody is source-available under the Kody License
(LicenseRef-Kody-FSL-1.1-ALv2-Personal), the same license as the self-hosted
kody-hq/kody-celld. It is a modified
Functional Source License 1.1 that limits the free
Permitted Purposes to personal, family, nonprofit, and classroom use, including
self-hosted deployments and modified forks you run on infrastructure you
control. It keeps the FSL competing-use restriction, and each version becomes
available under the Apache License 2.0 on the second anniversary of its release.
Code published before this change stays under the standard
FSL-1.1-ALv2, the license it was released under,
including its two-year Apache 2.0 conversion. Directories with their own LICENSE
file, such as packages/cli and
packages/dev-runtime, use that license
(MIT). Third-party files keep their original licenses.
Public packages published through Kody do not use this repository's CLA and have no license gate; that is separate from this repository's license.