How kody-hq/kody works
Kody is a Cloudflare-based cloud for AI agents, centered on OAuth-protected MCP access to account-scoped packages, storage, credentials, and automations. A host reaches the origin Worker, which routes MCP and website traffic; MCP capabilities authorize access and invoke package storage. The repository also contains jobs, backup, status, desktop, and CLI subsystems. Relationships are limited to README topology and the sampled source references/calls; several major feature implementations are unsampled, so their internal connections are not inferred.
Main entry points: worker Origin Worker · storage-query.ts Storage capability · immutable-storage.ts Immutable backup storage · worker.ts Status service
Components 25
Entry and clients
- Origin Worker
packages/worker - TanStack website
packages/worker/start - Developer CLI
packages/cli/src/cli.ts - Desktop app
packages/desktop/main.cjs
MCP and storage
- MCP OAuth client
packages/worker/src/mcp-client/client-id-metadata.ts - Sealed OAuth storage
packages/worker/src/mcp-client/sealed-oauth-storage.ts - Storage capability
packages/worker/src/mcp/capabilities/storage/storage-query.ts - Storage runner
packages/worker/src/storage-runner.ts - SQL read policy
packages/shared/src/storage-sql-read-policy.ts - Package codemods
packages/worker/src/package-codemods/engine.ts - Codemod ledger
packages/worker/src/package-codemods/ledger.ts
Platform operations
- Job scheduler
packages/jobs-worker/src/manager-do.ts - Job store
packages/jobs-worker/src/store.ts
Reliability services
- Backup control plane
packages/backup-control-plane/worker.ts - Backup policy
packages/backup-control-plane/backup-policy.ts - Backup types
packages/backup-control-plane/backup-types.ts - Immutable backup storage
packages/backup-control-plane/immutable-storage.ts - Status service
packages/status/worker.ts - Status page
packages/status/status-page.ts - Status store
packages/status/status-store.ts
Runtime internals
- Execution context
packages/cli/src/execution-context/service.ts - Auto update
packages/cli/src/execution-context/auto-update.ts - Credential keystore
packages/cli/src/execution-context/keystore.ts - Desktop execution
packages/desktop/execution.cjs
Other components
- MCP host
Connections 17
- MCP host → Origin Worker: sends MCP requests
README.md - Origin Worker → TanStack website: routes web requests
README.md - Origin Worker → MCP OAuth client: handles OAuth requests
README.md - Origin Worker → Storage capability: routes MCP requests
README.md - Storage capability → Storage runner: invokes storage RPC
packages/worker/src/mcp/capabilities/storage/storage-query.ts - Storage capability → SQL read policy: applies read policy
- Sealed OAuth storage → MCP OAuth client: loads client metadata
packages/worker/src/mcp-client/sealed-oauth-storage.ts - Package codemods → Codemod ledger: records runs
packages/worker/src/package-codemods/engine.ts - Job scheduler → Job store: finds runnable jobs
packages/jobs-worker/src/manager-do.ts - Backup control plane → Backup policy: uses policy
- Immutable backup storage → Backup policy: raises backup errors
packages/backup-control-plane/immutable-storage.ts - Immutable backup storage → Backup types: uses backup types
packages/backup-control-plane/backup-types.ts - Status service → Status page: serves status page
packages/status/worker.ts - Status service → Status store: uses status store
packages/status/worker.ts - Execution context → Auto update: manages updates
packages/cli/src/execution-context/service.ts - Execution context → Credential keystore: uses keystore
packages/cli/src/execution-context/service.ts - Desktop app → Desktop execution: coordinates execution
packages/desktop/main.cjs