Kody

---

Kody はエージェントのクラウドです。AI エージェントが保持するメモリ、キー、コード、自動化機能を、あらゆる MCP ホストで利用できます。Cloudflare Workers と Model Context Protocol（MCP）上に構築されており、TanStack Start のウェブサイト、Worker ベースのリクエストルーティング、パッケージのランタイム連携、OAuth で保護された MCP エンドポイントを提供します。このプロジェクトは、大規模な静的ツールカタログではなく、強力な search と Code Mode の execute フローを備えたコンパクトな MCP インターフェースを重視しています。

Kody は個人とチーム（組織、チーム、助成金）に対応します。各アカウントには、分離されたパッケージ、ジョブ、認証情報、メモリ、および関連する状態が保持されます。テストやフィクスチャで決定論的なローカルアカウントを作成することはありますが、実行時に特権を持つアカウントはありません。このリポジトリでは、いくつかの epicflare スターターの規約に従っています。

このリポジトリは Nx モノレポとして構成されています。共有モジュールは packages/shared（@kody-internal/shared）に、オリジンアプリの Worker は packages/worker に、兄弟 Worker は packages/platform-worker、 packages/runtime-worker、packages/jobs-worker に、モック Worker は packages/mock-servers/* にあります。本番環境のトポロジーについては docs/contributing/architecture/index.md を参照してください。

クイックスタート

npm install
npm run dev

開発サーバーはデフォルトで localhost:3742 で起動します（CLI は次に空いているポートを選び、確定した URL を表示します）。ローカルの Cloudflare Workers ランタイムと D1 データベースは Wrangler が自動的に処理します。

代わりに epicflare テンプレートから新しいプロジェクトをスキャフォールドするには、npx create-epicflare を実行してください。

セットアップ方法と要件の詳細は docs/contributing/getting-started.md を参照してください。コントリビューターとエージェントは、リポジトリ固有のガイダンスが記載された AGENTS.md から始めてください。

このリポジトリの目的を知りたい場合は、 docs/contributing/project-intent.md を参照してください。

技術スタック

レイヤー	技術
ランタイム	Cloudflare Workers
UI フレームワーク	TanStack Start
パッケージマネージャー	npm
ワークスペース	Nx + npm workspaces
データベース	Cloudflare D1
セッション／OAuth	Cloudflare KV
MCP の状態	kody-platform 上の Durable Objects
E2E テスト	Playwright
バンドラー	Vite

対象範囲

• 個人やチーム向けの Fair Source プラットフォームであり、汎用エージェントハーネスではありません
• 互換性のある AI エージェントホスト間で動作することを意図した、MCP を中心とするアーキテクチャです
• 大規模な固定ツール一覧よりも、コンパクトな MCP インターフェースを優先します
• ChatGPT を主なホスト対象として想定しつつ、実用上可能な範囲で他の MCP ホストからもサーバーを利用できるようにします

動作の仕組み

kody.codes  → kody-production (origin: TanStack Start, /mcp HTTP, OAuth, email, queues)
                 ├─→ kody-platform  (MCP / mailbox / meter / repo-session DOs)
                 ├─→ kody-runtime   (package apps, invoke API, StorageRunner)
                 └─→ kody-jobs      (cron + JobManager; calls back via JobsHost)

kody.run    → kody-runtime (package-app zone routes)

• packages/worker/src/index.ts がオリジンのエントリーポイントです。platform、runtime、jobs にもそれぞれ兄弟エントリーポイントがあります（アーキテクチャを参照）
• OAuth リクエスト、MCP リクエスト、静的アセットの順に処理します
• Webhook の受信処理（GET サブスクリプションチャレンジを含む）は、TanStack Start の前に Worker の fetch パスで処理されます
• 残りの Web サイトリクエストは TanStack Start（packages/worker/start/http-entry.ts）を経由します
• クライアントアセットは packages/worker/public/ にバンドルされ、ASSETS バインディング経由で配信されます

ドキュメント

ドキュメント	説明
docs/contributing/getting-started.md	セットアップ、環境変数、デプロイ
docs/contributing/environment-variables.md	新しい環境変数の追加
docs/contributing/cloudflare-offerings.md	オプションの Cloudflare 統合
docs/contributing/project-intent.md	対象範囲、目標、対象外の事項
docs/contributing/index.md	Kody の開発と拡張
docs/use/index.md	MCP 経由での Kody の利用
docs/contributing/setup/	ローカル開発と検証

コントリビューション

このリポジトリへの外部からのプルリクエストには、署名済みのコントリビューターライセンス契約が必要です。 公開パッケージにはこの CLA は適用されません。

CONTRIBUTING.mdと docs/contributing/index.mdを参照してください。

ライセンス

Kody は Functional Source License, Version 1.1, ALv2 Future License (FSL-1.1-ALv2) の下でライセンスされています。競合利用以外の目的であれば、本ソフトウェアを使用、複製、変更、派生物の作成、公開実演、公開展示、および再配布できます。競合利用とは、本ソフトウェアを、Kody の代替となる商用製品またはサービス、バージョンが公開された時点でライセンサーが Kody を使用して提供していた別の製品またはサービスの代替となるもの、または同一もしくは実質的に類似した機能を提供するものとして、他者に利用可能にすることを意味します。各バージョンは、公開日から 2 年後に Apache License 2.0 の下で利用可能になります。

Kody を通じて公開されるパブリックパッケージには、このリポジトリの CLA は適用されず、ライセンスの制限もありません。これは、このリポジトリのライセンスとは別のものです。

---