How kentcdodds/kody works
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: worker Origin worker · worker.ts Backup control plane · index.ts Jobs worker · mcp MCP endpoints
Components 23
User interaction
- Origin worker
packages/worker - Remix web UI
packages/worker/client
Assistant capabilities
- OAuth endpoints
packages/worker/src/mcp - MCP endpoints
packages/worker/src/mcp - Storage query
packages/worker/src/mcp/capabilities/storage/storage-query.ts - Package runtime
packages/worker/src/storage-runner.ts - Package codemods
packages/worker/src/package-codemods/engine.ts
Execution services
- Runtime worker
packages/runtime-worker - Platform worker
packages/platform-worker - Jobs worker
packages/jobs-worker/src/index.ts - Job manager
packages/jobs-worker/src/manager-do.ts - Job store
packages/jobs-worker/src/store.ts
Data protection
- Backup control plane
packages/backup-control-plane/worker.ts - Backup workflows
packages/backup-control-plane/backup-workflow.ts - Restore workflows
packages/backup-control-plane/restore-workflow.ts - Backup sealing
packages/backup-control-plane/seal-full-backup.ts - Backup object store
packages/backup-control-plane/immutable-storage.ts
Other components
- Assistant user
- MCP host
- Cloudflare D1
- Cloudflare KV
- Durable Objects
- Cloudflare R2
Connections 26
- Assistant user → Origin worker: sends requests
README.md - MCP host → OAuth endpoints: authorizes with
README.md - MCP host → MCP endpoints: uses MCP
README.md - Origin worker → OAuth endpoints: routes requests
README.md - Origin worker → MCP endpoints: routes requests
README.md - Origin worker → Remix web UI: serves assets
README.md - Assistant user → Remix web UI: uses
- MCP endpoints → Storage query: dispatches capability
packages/worker/src/mcp/capabilities/storage/storage-query.ts - Storage query → Package runtime: calls storage RPC
packages/worker/src/mcp/capabilities/storage/storage-query.ts - Assistant user → Package runtime: runs packages
- Package runtime → Runtime worker: runs on
README.md - Origin worker → Runtime worker: routes package apps
README.md - Origin worker → Platform worker: uses platform services
README.md - Origin worker → Jobs worker: dispatches jobs
- Jobs worker → Job manager: manages schedules
packages/jobs-worker/src/manager-do.ts - Job manager → Job store: reads runnable jobs
packages/jobs-worker/src/manager-do.ts - Jobs worker → Origin worker: calls back via JobsHost
README.md - Origin worker → Cloudflare D1: stores app data
- Origin worker → Cloudflare KV: stores sessions
README.md - Platform worker → Durable Objects: hosts state
README.md - Backup control plane → Backup workflows: enqueues backups
packages/backup-control-plane/worker.ts - Backup control plane → Backup sealing: seals complete days
packages/backup-control-plane/worker.ts - Backup control plane → Restore workflows: routes restore workflow
packages/backup-control-plane/worker.ts - Backup workflows → Backup object store: stores backup data
- Backup sealing → Backup object store: writes sealed backups
packages/backup-control-plane/seal-full-backup.ts - Backup object store → Cloudflare R2: writes objects