kody

Kodyは、AIエージェントのメモリ、キー、コード、自動化のホームとして設計されたパーソナルアシスタント基盤であり、互換性のあるMCPホスト間でポータブルであり続けることを目標としています。Cloudflare WorkersとModel Context Protocol上に構築され、Remix UI、Workerベースのリクエストルーティング、パッケージランタイムの配線、OAuthで保護されたMCPエンドポイントを提供します。 アーキテクチャと範囲 このプロジェクトは、大規模な静的なツールカタログではなく、検索とCode Modeのexecuteフローを備えたコンパクトなMCPサーフェスを好みます。マルチユーザーのパーソナルアシスタントとして説明されており、サインインした各ユーザーは、パッケージ、ジョブ、シークレット、メモリ、および関連する状態をカバーする完全に分離されたアシスタントを取得します。テストとフィクスチャは決定論的なローカルアカウントをシードする場合がありますが、実行時に特権を持つアカウントはありません。READMEは、このプロジェクトが汎用エージェントハーネスではなくFair Sourceのパーソナルアシスタント基盤であること、またChatGPTが主要なホストターゲットである可能性が高く、実用的な範囲で他のMCPホストからもサーバーを使用可能に保つことを述べています。 リポジトリ構成 リポジトリはNxモノレポです。共有モジュールはpackages/sharedにあり、オリジンアプリのworkerはpackages/workerにあり、兄弟workerはpackages/platform-worker、packages/runtime-worker、packages/jobs-workerにあり、さらにpackages/mock-servers配下にモックWorkersがあります。本番トポロジはdocs/contributing/architectureに文書化されています。説明されているリクエストフローは次のとおりです。まずOAuthリクエストが処理され、次にMCPリクエスト、次に静的アセットが処理されます。アセット以外のリクエストはサーバーハンドラーとルーターにフォールスルーし、クライアントアセットはpackages/worker/publicにバンドルされ、ASSETSバインディング経由で提供されます。 技術スタック ランタイム: Cloudflare Workers。UIフレームワーク: Remix 3 (beta)。パッケージマネージャー: npm。ワークスペース: Nxとnpm workspaces。データベース: Cloudflare D1。セッション/OAuth: Cloudflare KV。MCP状態: kody-platform上のDurable Objects。E2Eテスト: Playwright。バンドラー: Vite。 はじめに 依存関係をnpm installでインストールし、npm run devで開発サーバーを起動します。開発サーバーはデフォルトでlocalhost:3742で実行され、CLIが次の空きポートを選び、解決されたURLを出力します。WranglerがローカルのCloudflare WorkersランタイムとD1データベースを自動的に処理します。代わりにepicflareテンプレートから新しいプロジェクトをscaffoldするには、READMEはnpx create-epicflareを指しています。さらなるセットアップ手順と期待事項はdocs/contributing/getting-started.mdにあり、コントリビューターとエージェントはリポジトリ固有のガイダンスについてAGENTS.mdを参照するよう指示されています。プロジェクトの意図はdocs/contributing/project-intent.mdに文書化されています。 ドキュメントとコントリビューション READMEは、セットアップ、環境変数、オプションのCloudflare統合、プロジェクトの意図、Kodyの開発と拡張、MCP経由でのKodyの使用、ローカル開発と検証を扱うドキュメントへのリンクを提供しています。外部からのプルリクエストには、署名済みのインバウンドContributor License Agreementが必要です。Kodyを通じて公開されるパブリックパッケージは、そのCLAを使用しません。リポジトリはFunctional Source License 1.1と将来のApache 2.0ライセンスの下でライセンスされており、Competing Use以外のあらゆる目的での使用、コピー、変更、派生作品、公の実演、表示、再配布を許可し、各バージョンはリリースから2周年にApache 2.0の下で利用可能になります。