kody

Kody is your assistant's home—the memory, keys, code, and automations your AIagent keeps, portable across every MCP host. Built on Cloudflare Workers and theModel Context Protocol (MCP), it ships a Remix UI, Worker-based request routing,package runtime plumbing, and OAuth-protected MCP endpoints. The project favorsa compact MCP surface with powerful search and Code Mode execute flows overa large static tool catalog.

Kody is a multi-user personal assistant: each signed-in user gets a fullyisolated assistant (packages, jobs, secrets, values, memories, and relatedstate). Tests and fixtures may seed deterministic local accounts, but no accountis privileged at runtime. The repo follows severalepicflare starter conventions.

The repo is organized as an Nx monorepo, with shared modules inpackages/shared (@kody-internal/shared), the main app worker underpackages/worker, and mock Workers under packages/mock-servers/*.

Quick Start

npm install
npm run dev

The dev server runs at localhost:3742 by default (the CLI picks the next freeport and prints the resolved URL). Wrangler handles the local Cloudflare Workersruntime and D1 database automatically.

To scaffold a new project from the epicflare template instead, runnpx create-epicflare.

Seedocs/contributing/getting-started.mdfor the full setup paths and expectations. Contributors and agents should startwith AGENTS.md for repo-specific guidance.

If you are trying to understand what this repository is for, start withdocs/contributing/project-intent.md.

Tech Stack

Scope

• Fair Source personal assistant platform, 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 fromother MCP hosts where practical

How It Works

Request → packages/worker/src/index.ts
              │
              ├─→ OAuth handlers
              ├─→ MCP endpoints
              ├─→ Static assets (`packages/worker/public/`)
              └─→ Server router → Remix components

• packages/worker/src/index.ts is the entrypoint for Cloudflare Workers
• OAuth requests are handled first, then MCP requests, then static assets
• Non-asset requests fall through to the server handler and router
• Client assets are bundled into packages/worker/public/ and served via theASSETS binding

Documentation

License

Kody is licensed under theFunctional Source License, Version 1.1, ALv2 Future License(FSL-1.1-ALv2). You can use, copy, modify, createderivative works from, publicly perform, publicly display, and redistribute thesoftware for any purpose other than Competing Use. Competing Use means makingthe software available to others in a commercial product or service thatsubstitutes for Kody, substitutes for another product or service the licensoroffers using Kody that existed when the version was made available, or offersthe same or substantially similar functionality. Each version becomes availableunder the Apache License 2.0 on the second anniversary of the date that versionwas made available.

Community packages published through Kody remain MIT-licensed; that requirementis separate from this repository's license.