kody

Kody는 AI 에이전트의 메모리, 키, 코드 및 자동화를 위한 홈으로 설계된 개인 비서 플랫폼으로, 호환되는 MCP 호스트 간 이식성을 유지하는 것을 목표로 합니다. Cloudflare Workers와 Model Context Protocol을 기반으로 구축되었으며, Remix UI, Worker 기반 요청 라우팅, 패키지 런타임 플러밍 및 OAuth로 보호된 MCP 엔드포인트를 제공합니다. 아키텍처 및 범위 이 프로젝트는 대규모 정적 도구 카탈로그보다는 검색 및 Code Mode 실행 흐름을 갖춘 간결한 MCP 표면을 선호합니다. 다중 사용자 개인 비서로 설명되며, 각 로그인 사용자는 패키지, 작업, 비밀, 메모리 및 관련 상태를 포함한 완전히 격리된 비서를 받습니다. 테스트 및 픽스처는 결정적 로컬 계정을 시드할 수 있지만, 런타임에서 어떤 계정도 특권을 갖지 않습니다. README는 이 프로젝트가 일반 목적의 에이전트 하네스가 아닌 Fair Source 개인 비서 플랫폼이며, ChatGPT가 주요 호스트 대상이 될 가능성이 높지만 실용적인 경우 다른 MCP 호스트에서도 서버를 사용할 수 있도록 유지한다고 명시합니다. 저장소 구조 이 저장소는 Nx 모노레포입니다. 공유 모듈은 packages/shared에, 오리진 앱 워커는 packages/worker에 있으며, 형제 워커는 packages/platform-worker, packages/runtime-worker 및 packages/jobs-worker에 있고, mock Workers는 packages/mock-servers 아래에 있습니다. 프로덕션 토폴로지는 docs/contributing/architecture에 문서화되어 있습니다. 설명된 요청 흐름은 다음과 같습니다: OAuth 요청이 먼저 처리되고, 그 다음 MCP 요청, 그 다음 정적 자산이 처리됩니다. 비자산 요청은 서버 핸들러와 라우터로 전달되며, 클라이언트 자산은 packages/worker/public에 번들되어 ASSETS 바인딩을 통해 제공됩니다. 기술 스택 런타임: Cloudflare Workers. UI 프레임워크: Remix 3(베타). 패키지 매니저: npm. 워크스페이스: Nx 및 npm 워크스페이스. 데이터베이스: 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 템플릿에서 새 프로젝트를 스캐폴드하려면 README가 npx create-epicflare를 가리킵니다. 추가 설정 경로 및 기대 사항은 docs/contributing/getting-started.md에 있으며, 기여자와 에이전트는 저장소별 지침을 위해 AGENTS.md를 참조하도록 안내됩니다. 프로젝트 의도는 docs/contributing/project-intent.md에 문서화되어 있습니다. 문서 및 기여 README는 설정, 환경 변수, 선택적 Cloudflare 통합, 프로젝트 의도, Kody 개발 및 확장, MCP를 통한 Kody 사용, 로컬 개발 및 검증을 다루는 문서를 연결합니다. 외부 풀 리퀘스트는 서명된 인바운드 기여자 라이선스 계약이 필요합니다. Kody를 통해 게시된 공개 패키지는 해당 CLA를 사용하지 않습니다. 저장소는 Functional Source License 1.1 및 Apache 2.0 향후 라이선스로 라이선스가 부여되며, 경쟁 사용 이외의 목적에 대한 사용, 복사, 수정, 파생 저작물, 공개 공연, 표시 및 재배포를 허용하고, 각 버전은 출시 2주년에 Apache 2.0 하에서 제공됩니다.