Summary

Kody is an experimental personal assistant platform built on Cloudflare Workers and the Model Context Protocol (MCP). It provides a Remix UI, Worker-based request routing, and OAuth-protected MCP endpoints, prioritizing a compact MCP surface with powerful search and Code Mode execution over extensive tool catalogs. Each signed-in user receives a fully isolated assistant environment, including packages, jobs, secrets, values, memories, and related state.

How It Works

The architecture centers on Cloudflare Workers as the runtime, with Remix 3 (alpha) serving as the UI framework. The primary entrypoint, packages/worker/src/index.ts, handles incoming requests by first processing OAuth handlers, then MCP endpoints, and serving static assets before routing non-asset requests to Remix components. State management leverages Cloudflare D1 for databases, KV for session/OAuth data, and Durable Objects for MCP state. This MCP-first design enables robust, isolated user assistants.

Quick Start & Requirements

Install dependencies using npm install and launch the development server with npm run dev. The local development environment utilizes Wrangler, which automatically provisions and manages the Cloudflare Workers runtime and D1 database. To scaffold new projects based on the epicflare template, use npx create-epicflare. Comprehensive setup instructions, environment variable configurations, and deployment details are available in docs/contributing/getting-started.md and docs/contributing/setup.md.

Highlighted Details

• Isolated Multi-User Assistants: Each user operates within a fully isolated environment for packages, jobs, secrets, values, memories, and state.
• MCP-Centric Design: Emphasizes a compact MCP surface area with advanced search and Code Mode execution capabilities.
• Cloudflare Ecosystem Integration: Built entirely on Cloudflare Workers, D1, KV, and Durable Objects.
• Monorepo Structure: Organized using Nx and npm workspaces for modular development and code sharing.

Maintenance & Community

The project is developed by "Epic Web." The provided README does not specify community channels such as Discord or Slack, nor does it detail specific contributors or sponsorships.

Licensing & Compatibility

The license under which this project is distributed is not explicitly stated in the provided README text.

Limitations & Caveats

Kody is explicitly described as an "experimental personal assistant platform" and is not intended to function as a multi-tenant SaaS product. The Remix 3 UI framework is currently in an alpha state.