Skip to content
Back to search

kody

🐨 The cloud for your team's agents. Save your agent memory, credentials, code, and automations, portable across every agent with Kody.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/kody-hq/kody with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/kody-hq/kody'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kody-hq--kody/badge.svg)](/listings/kody-hq--kody)

HTML

<a href="/listings/kody-hq--kody"><img src="/api/listings/kody-hq--kody/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npm install
npm run dev

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

To scaffold a **new** project from the epicflare template instead, run `npx create-epicflare`.

See [`docs/contributing/getting-started.md`](./docs/contributing/getting-started.md) for the full setup paths and expectations. Contributors and agents should start with [`AGENTS.md`](./AGENTS.md) for repo-specific guidance.

If you are trying to understand what this repository is for, start with [`docs/contributing/project-intent.md`](./docs/contributing/project-intent.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 156 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <img src="./packages/worker/public/images/brand/kody-logo-outlined.svg" alt="Kody logo" width="400" />
  3. <p>
  4. <strong>Your agents' cloud: the memory, keys, code, and automations your AI agent keeps, portable across every MCP host. Built on Cloudflare Workers.</strong>
  5. </p>
  6. <p>
  7. <a href="https://github.com/kody-hq/kody/actions/workflows/deploy.yml"><img src="https://img.shields.io/github/actions/workflow/status/kody-hq/kody/deploy.yml?branch=main&style=flat-square&logo=github&label=CI" alt="Build Status" /></a>
  8. <a href="https://kcd.im/kody-discord"><img src="https://img.shields.io/badge/Discord-Join-5865F2?style=flat-square&logo=discord&logoColor=white" alt="Join the Discord" /></a>
  9. <img src="https://img.shields.io/badge/TypeScript-6.0-blue?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript" />
  10. <img src="https://img.shields.io/badge/Node-26-5FA04E?style=flat-square&logo=node.js&logoColor=white" alt="Node 26" />
  11. <img src="https://img.shields.io/badge/Cloudflare-Workers-F38020?style=flat-square&logo=cloudflare&logoColor=white" alt="Cloudflare Workers" />
  12. <img src="https://img.shields.io/badge/TanStack_Start-FF5E00?style=flat-square" alt="TanStack Start" />
  13. </p>
  14. </div>
  15. ---
  16. Kody is Your agents' cloud: the memory, keys, code, and automations your AI
  17. agent keeps, portable across every MCP host. Built on Cloudflare Workers and the
  18. Model Context Protocol (MCP), it ships a TanStack Start website, Worker-based
  19. request routing, package runtime plumbing, and OAuth-protected MCP endpoints.
  20. The project favors a compact MCP surface with powerful `search` and Code Mode
  21. `execute` flows over a large static tool catalog.
  22. Kody works for individuals and teams (orgs, teams, grants): each account holds
  23. isolated packages, jobs, credentials, memories, and related state. Tests and
  24. fixtures may seed deterministic local accounts, but no account is privileged at
  25. runtime. The repo follows several
  26. [epicflare](https://github.com/epicweb-dev/epicflare) starter conventions.
  27. The repo is organized as an Nx monorepo, with shared modules in
  28. `packages/shared` (`@kody-internal/shared`), the origin app worker under
  29. `packages/worker`, sibling workers under `packages/platform-worker`,
  30. `packages/runtime-worker`, and `packages/jobs-worker`, and mock Workers under
  31. `packages/mock-servers/*`. Production topology lives in
  32. [`docs/contributing/architecture/index.md`](./docs/contributing/architecture/index.md).
  33. ## Quick Start
  34. ```bash
  35. npm install
  36. npm run dev
  37. ```
  38. The dev server runs at `localhost:3742` by default (the CLI picks the next free
  39. port and prints the resolved URL). Wrangler handles the local Cloudflare Workers
  40. runtime and D1 database automatically.
  41. To scaffold a **new** project from the epicflare template instead, run
  42. `npx create-epicflare`.
  43. See
  44. [`docs/contributing/getting-started.md`](./docs/contributing/getting-started.md)
  45. for the full setup paths and expectations. Contributors and agents should start
  46. with [`AGENTS.md`](./AGENTS.md) for repo-specific guidance.
  47. If you are trying to understand what this repository is for, start with
  48. [`docs/contributing/project-intent.md`](./docs/contributing/project-intent.md).
  49. ## Tech Stack
  50. | Layer | Technology |
  51. | --------------- | ---------------------------------------------------------------------------------------- |
  52. | Runtime | [Cloudflare Workers](https://workers.cloudflare.com/) |
  53. | UI Framework | [TanStack Start](https://tanstack.com/start) |
  54. | Package Manager | [npm](https://www.npmjs.com/) |
  55. | Workspace | [Nx](https://nx.dev/) + npm workspaces |
  56. | Database | [Cloudflare D1](https://developers.cloudflare.com/d1/) |
  57. | Session/OAuth | [Cloudflare KV](https://developers.cloudflare.com/kv/) |
  58. | MCP State | [Durable Objects](https://developers.cloudflare.com/durable-objects/) on `kody-platform` |
  59. | E2E Testing | [Playwright](https://playwright.dev/) |
  60. | Bundler | [Vite](https://vite.dev/) |
  61. ## Scope
  62. - Source-available platform for individuals and teams, not a general-purpose
  63. agent harness
  64. - MCP-first architecture intended to work across compatible AI agent hosts
  65. - Compact MCP surface area preferred over a large static tool inventory
  66. - ChatGPT is a likely primary host target, while keeping the server usable from
  67. other MCP hosts where practical
  68. ## How It Works
  69. ```
  70. kody.codes β†’ kody-production (origin: TanStack Start, /mcp HTTP, OAuth, email, queues)
  71. β”œβ”€β†’ kody-platform (MCP / mailbox / meter / repo-session DOs)
  72. β”œβ”€β†’ kody-runtime (package apps, invoke API, StorageRunner)
  73. └─→ kody-jobs (cron + JobManager; calls back via JobsHost)
  74. kody.run β†’ kody-runtime (package-app zone routes)
  75. ```
  76. - `packages/worker/src/index.ts` is the origin entrypoint; platform, runtime,
  77. and jobs have sibling entrypoints (see
  78. [architecture](./docs/contributing/architecture/index.md#production-worker-fleet))
  79. - OAuth requests are handled first, then MCP requests, then static assets
  80. - Webhook ingress (including GET subscription challenges) is handled in the
  81. Worker `fetch` path before TanStack Start
  82. - Remaining website requests go through TanStack Start
  83. (`packages/worker/start/http-entry.ts`)
  84. - Client assets are bundled into `packages/worker/public/` and served via the
  85. `ASSETS` binding
  86. ## Documentation
  87. | Document | Description |
  88. | -------------------------------------------------------------------------------------------- | ------------------------------------ |
  89. | [`docs/contributing/getting-started.md`](./docs/contributing/getting-started.md) | Setup, environment variables, deploy |
  90. | [`docs/contributing/environment-variables.md`](./docs/contributing/environment-variables.md) | Adding new env vars |
  91. | [`docs/contributing/cloudflare-offerings.md`](./docs/contributing/cloudflare-offerings.md) | Optional Cloudflare integrations |
  92. | [`docs/contributing/project-intent.md`](./docs/contributing/project-intent.md) | Scope, goals, and non-goals |
  93. | [`docs/contributing/index.md`](./docs/contributing/index.md) | Developing and extending Kody |
  94. | [`docs/use/index.md`](./docs/use/index.md) | Using Kody over MCP |
  95. | [`docs/contributing/setup/`](./docs/contributing/setup/index.md) | Local development and verification |
  96. ## Contributing
  97. Outside pull requests to this repository need a signed inbound
  98. [Contributor License Agreement](./docs/contributing/inbound-contributions.md).
  99. Public packages do not use that CLA.
  100. See [`CONTRIBUTING.md`](./CONTRIBUTING.md) and
  101. [`docs/contributing/index.md`](./docs/contributing/index.md).
  102. ## License
  103. Free for personal, family, nonprofit, and classroom use. For any other use,
  104. email support@kody.codes.
  105. Kody is source-available under the [Kody License](./LICENSE)
  106. (`LicenseRef-Kody-FSL-1.1-ALv2-Personal`), the same license as the self-hosted
  107. [kody-hq/kody-celld](https://github.com/kody-hq/kody-celld). It is a modified
  108. [Functional Source License 1.1](https://fsl.software/) that limits the free
  109. Permitted Purposes to personal, family, nonprofit, and classroom use, including
  110. self-hosted deployments and modified forks you run on infrastructure you
  111. control. It keeps the FSL competing-use restriction, and each version becomes
  112. available under the Apache License 2.0 on the second anniversary of its release.
  113. Code published before this change stays under the standard
  114. [FSL-1.1-ALv2](https://fsl.software/), the license it was released under,
  115. including its two-year Apache 2.0 conversion. Directories with their own LICENSE
  116. file, such as [`packages/cli`](./packages/cli/LICENSE) and
  117. [`packages/dev-runtime`](./packages/dev-runtime/LICENSE), use that license
  118. (MIT). Third-party files keep their original licenses.
  119. Public packages published through Kody do not use this repository's CLA and have
  120. no license gate; that is separate from this repository's license.
  121. ---
  122. <div align="center">
  123. <sub>Built with ❀️ by <a href="https://epicweb.dev">Epic Web</a></sub>
  124. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.