# kentcdodds/kody architecture

> Architecture diagram of the GitHub repository kentcdodds/kody, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kentcdodds/kody
- Repository: https://github.com/kentcdodds/kody

## Overview

Kody is a multi-user assistant platform that exposes personal packages, memories, secrets, and automations to AI hosts through MCP, alongside a web UI. The documented request path leads through the origin worker to MCP/OAuth or the app router; packages also run through a separate runtime, while scheduled jobs use a sibling worker. The repository additionally contains backup and restore workflows. Edges follow sampled calls or README topology; several product areas are documented but their implementation was not sampled, so those links are identified as documented rather than inferred from module names.

Main entry points: [`packages/worker`](https://github.com/kentcdodds/kody/tree/main/packages/worker) (Origin worker), [`packages/backup-control-plane/worker.ts`](https://github.com/kentcdodds/kody/blob/main/packages/backup-control-plane/worker.ts) (Backup control plane), [`packages/jobs-worker/src/index.ts`](https://github.com/kentcdodds/kody/blob/main/packages/jobs-worker/src/index.ts) (Jobs worker), [`packages/worker/src/mcp`](https://github.com/kentcdodds/kody/tree/main/packages/worker/src/mcp) (MCP endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User interaction"]
  node_origin["Origin worker"]
  node_web["Remix web UI"]
end

subgraph group_assistant["Assistant capabilities"]
  node_oauth["OAuth endpoints"]
  node_mcp["MCP endpoints"]
  node_capability["Storage query<br/>[storage-query.ts]"]
  node_package["Package runtime<br/>[storage-runner.ts]"]
  node_codemods["Package codemods<br/>[engine.ts]"]
end

subgraph group_execution["Execution services"]
  node_runtime["Runtime worker"]
  node_platform["Platform worker"]
  node_jobs["Jobs worker<br/>[index.ts]"]
  node_manager["Job manager<br/>[manager-do.ts]"]
  node_jobstore[("Job store<br/>[store.ts]")]
end

subgraph group_reliability["Data protection"]
  node_backup["Backup control plane<br/>[worker.ts]"]
  node_backupflow["Backup workflows<br/>[backup-workflow.ts]"]
  node_restore["Restore workflows"]
  node_seal["Backup sealing"]
  node_objectstore[("Backup object store")]
end

node_user(("Assistant user"))
node_host(("MCP host"))
node_d1[("Cloudflare D1")]
node_kv[("Cloudflare KV")]
node_durable[("Durable Objects")]
node_r2[("Cloudflare R2")]

node_user -->|"sends requests"| node_origin
node_host -->|"authorizes with"| node_oauth
node_host -->|"uses MCP"| node_mcp
node_origin -->|"routes requests"| node_oauth
node_origin -->|"routes requests"| node_mcp
node_origin -->|"serves assets"| node_web
node_user -.->|"uses"| node_web
node_mcp -.->|"dispatches capability"| node_capability
node_capability -->|"calls storage RPC"| node_package
node_user -.->|"runs packages"| node_package
node_package -->|"runs on"| node_runtime
node_origin -->|"routes package apps"| node_runtime
node_origin -->|"uses platform services"| node_platform
node_origin -.->|"dispatches jobs"| node_jobs
node_jobs -->|"manages schedules"| node_manager
node_manager -->|"reads runnable jobs"| node_jobstore
node_jobs -->|"calls back via JobsHost"| node_origin
node_origin -.->|"stores app data"| node_d1
node_origin -->|"stores sessions"| node_kv
node_platform -->|"hosts state"| node_durable
node_backup -->|"enqueues backups"| node_backupflow
node_backup -->|"seals complete days"| node_seal
node_backup -->|"routes restore workflow"| node_restore
node_backupflow -.->|"stores backup data"| node_objectstore
node_seal -.->|"writes sealed backups"| node_objectstore
node_objectstore -.->|"writes objects"| node_r2

click node_origin "https://github.com/kentcdodds/kody/tree/main/packages/worker"
click node_web "https://github.com/kentcdodds/kody/tree/main/packages/worker/client"
click node_oauth "https://github.com/kentcdodds/kody/tree/main/packages/worker/src/mcp"
click node_mcp "https://github.com/kentcdodds/kody/tree/main/packages/worker/src/mcp"
click node_capability "https://github.com/kentcdodds/kody/blob/main/packages/worker/src/mcp/capabilities/storage/storage-query.ts"
click node_package "https://github.com/kentcdodds/kody/blob/main/packages/worker/src/storage-runner.ts"
click node_codemods "https://github.com/kentcdodds/kody/blob/main/packages/worker/src/package-codemods/engine.ts"
click node_runtime "https://github.com/kentcdodds/kody/tree/main/packages/runtime-worker"
click node_platform "https://github.com/kentcdodds/kody/tree/main/packages/platform-worker"
click node_jobs "https://github.com/kentcdodds/kody/blob/main/packages/jobs-worker/src/index.ts"
click node_manager "https://github.com/kentcdodds/kody/blob/main/packages/jobs-worker/src/manager-do.ts"
click node_jobstore "https://github.com/kentcdodds/kody/blob/main/packages/jobs-worker/src/store.ts"
click node_backup "https://github.com/kentcdodds/kody/blob/main/packages/backup-control-plane/worker.ts"
click node_backupflow "https://github.com/kentcdodds/kody/blob/main/packages/backup-control-plane/backup-workflow.ts"
click node_restore "https://github.com/kentcdodds/kody/blob/main/packages/backup-control-plane/restore-workflow.ts"
click node_seal "https://github.com/kentcdodds/kody/blob/main/packages/backup-control-plane/seal-full-backup.ts"
click node_objectstore "https://github.com/kentcdodds/kody/blob/main/packages/backup-control-plane/immutable-storage.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_origin,node_web,node_user toneBlue
class node_oauth,node_mcp,node_capability,node_package,node_codemods,node_d1,node_kv,node_durable,node_r2 toneAmber
class node_runtime,node_platform,node_jobs,node_manager,node_jobstore toneMint
class node_backup,node_backupflow,node_restore,node_seal,node_objectstore toneRose
class node_host toneIndigo
```

## Components

### User interaction

- [Origin worker](https://github.com/kentcdodds/kody/tree/main/packages/worker): `packages/worker`
- [Remix web UI](https://github.com/kentcdodds/kody/tree/main/packages/worker/client): `packages/worker/client`

### Assistant capabilities

- [OAuth endpoints](https://github.com/kentcdodds/kody/tree/main/packages/worker/src/mcp): `packages/worker/src/mcp`
- [MCP endpoints](https://github.com/kentcdodds/kody/tree/main/packages/worker/src/mcp): `packages/worker/src/mcp`
- [Storage query](https://github.com/kentcdodds/kody/blob/main/packages/worker/src/mcp/capabilities/storage/storage-query.ts): `packages/worker/src/mcp/capabilities/storage/storage-query.ts`
- [Package runtime](https://github.com/kentcdodds/kody/blob/main/packages/worker/src/storage-runner.ts): `packages/worker/src/storage-runner.ts`
- [Package codemods](https://github.com/kentcdodds/kody/blob/main/packages/worker/src/package-codemods/engine.ts): `packages/worker/src/package-codemods/engine.ts`

### Execution services

- [Runtime worker](https://github.com/kentcdodds/kody/tree/main/packages/runtime-worker): `packages/runtime-worker`
- [Platform worker](https://github.com/kentcdodds/kody/tree/main/packages/platform-worker): `packages/platform-worker`
- [Jobs worker](https://github.com/kentcdodds/kody/blob/main/packages/jobs-worker/src/index.ts): `packages/jobs-worker/src/index.ts`
- [Job manager](https://github.com/kentcdodds/kody/blob/main/packages/jobs-worker/src/manager-do.ts): `packages/jobs-worker/src/manager-do.ts`
- [Job store](https://github.com/kentcdodds/kody/blob/main/packages/jobs-worker/src/store.ts): `packages/jobs-worker/src/store.ts`

### Data protection

- [Backup control plane](https://github.com/kentcdodds/kody/blob/main/packages/backup-control-plane/worker.ts): `packages/backup-control-plane/worker.ts`
- [Backup workflows](https://github.com/kentcdodds/kody/blob/main/packages/backup-control-plane/backup-workflow.ts): `packages/backup-control-plane/backup-workflow.ts`
- [Restore workflows](https://github.com/kentcdodds/kody/blob/main/packages/backup-control-plane/restore-workflow.ts): `packages/backup-control-plane/restore-workflow.ts`
- [Backup sealing](https://github.com/kentcdodds/kody/blob/main/packages/backup-control-plane/seal-full-backup.ts): `packages/backup-control-plane/seal-full-backup.ts`
- [Backup object store](https://github.com/kentcdodds/kody/blob/main/packages/backup-control-plane/immutable-storage.ts): `packages/backup-control-plane/immutable-storage.ts`

### Other components

- **Assistant user**
- **MCP host**
- **Cloudflare D1**
- **Cloudflare KV**
- **Durable Objects**
- **Cloudflare R2**

## Connections

- Assistant user → Origin worker: sends requests (evidence: `README.md`)
- MCP host → OAuth endpoints: authorizes with (evidence: `README.md`)
- MCP host → MCP endpoints: uses MCP (evidence: `README.md`)
- Origin worker → OAuth endpoints: routes requests (evidence: `README.md`)
- Origin worker → MCP endpoints: routes requests (evidence: `README.md`)
- Origin worker → Remix web UI: serves assets (evidence: `README.md`)
- Assistant user → Remix web UI: uses
- MCP endpoints → Storage query: dispatches capability (evidence: `packages/worker/src/mcp/capabilities/storage/storage-query.ts`)
- Storage query → Package runtime: calls storage RPC (evidence: `packages/worker/src/mcp/capabilities/storage/storage-query.ts`)
- Assistant user → Package runtime: runs packages
- Package runtime → Runtime worker: runs on (evidence: `README.md`)
- Origin worker → Runtime worker: routes package apps (evidence: `README.md`)
- Origin worker → Platform worker: uses platform services (evidence: `README.md`)
- Origin worker → Jobs worker: dispatches jobs
- Jobs worker → Job manager: manages schedules (evidence: `packages/jobs-worker/src/manager-do.ts`)
- Job manager → Job store: reads runnable jobs (evidence: `packages/jobs-worker/src/manager-do.ts`)
- Jobs worker → Origin worker: calls back via JobsHost (evidence: `README.md`)
- Origin worker → Cloudflare D1: stores app data
- Origin worker → Cloudflare KV: stores sessions (evidence: `README.md`)
- Platform worker → Durable Objects: hosts state (evidence: `README.md`)
- Backup control plane → Backup workflows: enqueues backups (evidence: `packages/backup-control-plane/worker.ts`)
- Backup control plane → Backup sealing: seals complete days (evidence: `packages/backup-control-plane/worker.ts`)
- Backup control plane → Restore workflows: routes restore workflow (evidence: `packages/backup-control-plane/worker.ts`)
- Backup workflows → Backup object store: stores backup data
- Backup sealing → Backup object store: writes sealed backups (evidence: `packages/backup-control-plane/seal-full-backup.ts`)
- Backup object store → Cloudflare R2: writes objects
