kylrix

스폰서

Related MCP server: Kopern

빠른 시작 및 설정

자체 호스팅

옵션 1: 단일 명령 스크립트

curl -fsSL https://raw.githubusercontent.com/Kylrix/kylrix/master/selfhost.sh | bash

옵션 2: Docker 직접 풀

docker pull ghcr.io/kylrix/kylrix:latest
docker run -d -p 5003:3000 --name kylrix-app ghcr.io/kylrix/kylrix:latest

옵션 3: Docker Compose

docker compose up -d

로컬 개발

git clone https://github.com/Kylrix/kylrix.git
cd kylrix
cp .env.example .env
pnpm install
pnpm dev

http://localhost:3005 를 엽니다.

Ota 기여자 워크플로우

ota validate .
ota doctor
ota tasks --use
ota up --workflow verify --mode native
ota up --workflow dev

ota.yaml (verify, dev, selfhost) 및 appwrite.config.json을 참조하세요.

철학

모든 것은 객체이고, 모든 행동은 단지 도구 호출이며, 모든 결과는 더 많은 컨텍스트입니다.

Kylrix는 메모, 작업, 이벤트, 볼트 항목, 채팅, 파일, 심지어 워크스페이스까지도 행, 권한, 히스토리를 가진 동일한 프리미티브인 객체로 취급합니다. 에이전트는 사이드바에 살지 않습니다. 에이전트는 워크스페이스 안에서 활동하며, 당신이 호출하는 것과 동일한 도구를 호출합니다. 당신이 캡처하는 모든 메모, 완료하는 모든 작업, 보내는 모든 메시지는 컨텍스트 엔진(CompiledLocalContext)에 공급되어 다음 행동을 위한 레버리지가 됩니다. 시스템은 복리식으로 성장합니다.

로컬 사본이 진실입니다. 네트워크가 이를 확인합니다. 게스트도 동일한 엔진을 사용합니다. 어떤 기능도 고립된 섬이 아닙니다.

인간과 에이전트의 시너지

Kylrix는 인간과 자율 AI 에이전트 간의 협력적 공동 구축을 위해 기본 원칙부터 설계되었습니다:

• 공유 라이브 워크스페이스: 인간은 아키텍처 방향, 취향, 도메인 비전을 제공합니다. 에이전트는 구체적인 워크스페이스(isAgentic: true) 내에서 직접 작동하며 도구를 도그푸딩하고, 기술 개념을 캡처하고, 백로그를 계획하고, 코드 변경을 실행합니다.

• 복리 컨텍스트 엔진: 인간이나 에이전트가 작성한 모든 메모, 완료한 모든 작업, 생성한 모든 토론 스레드는 공유 워크스페이스 컨텍스트를 풍부하게 하여 이후의 모든 작업에서 속도를 증폭시킵니다.

• 1:1 인터페이스 패리티(MCP 및 REST API): 에이전트는 Model Context Protocol(MCP) 서버(/api/mcp) 또는 Kylrix HTTP API(/api/v1) 를 통해 생태계에 매끄럽게 연결됩니다. 두 인터페이스 모두 메모, 목표, 아이디어, 캘린더 이벤트, 폼, 플로우, 토론에 걸쳐 완전한 1:1 기능 패리티를 제공합니다.

• 프로덕션에서의 자율 도그푸딩: Kylrix는 Kylrix 내부에서 인간 엔지니어와 함께 작업하는 에이전트에 의해 구축되고 진화하며, 일상적인 소프트웨어 개발을 통합된 복리 루프로 변환합니다.

통합 및 MCP 설치

→ 전체 에이전트 연결 가이드: docs/integrations.md (모든 코딩 에이전트를 위한 복사-붙여넣기 프롬프트)

Model Context Protocol(MCP)과 공식 Agent Skills를 통해 모든 AI 클라이언트, CLI 또는 자율 에이전트를 Kylrix에 직접 연결하세요.

1. Agent Skills 설치

코딩 어시스턴트 또는 CLI에 도메인별 기능을 직접 추가하세요:

# Kylrix MCP Server Skill
npx skills add kylrix/kylrix/mcp

# Kylrix REST API (PAT) Skill
npx skills add kylrix/kylrix/api

# Autonomous Agents Runtime Skill
npx skills add kylrix/kylrix/agents

2. 다양한 도구에 Kylrix MCP 설치하기

Kylrix MCP 서버는 https://www.kylrix.space/api/v1/mcp 에서 Streamable HTTP 및 SSE를 통해 실행됩니다.

자체 인스턴스를 직접 호스팅하고 계신가요? SELFHOST.md를 참조하세요.

Claude Code

claude mcp add --transport http kylrix https://www.kylrix.space/api/v1/mcp \
  --header "Authorization: Bearer <YOUR_PAT_TOKEN>"

Smithery CLI (자동 단일 명령 설치)

# Claude Desktop
npx -y @smithery/cli install kylrix/kylrix --client claude

# Cursor
npx -y @smithery/cli install kylrix/kylrix --client cursor

# Windsurf
npx -y @smithery/cli install kylrix/kylrix --client windsurf

Cursor (.cursor/mcp.json.example 복사 또는 Settings > Features > MCP)

{
  "mcpServers": {
    "kylrix": {
      "type": "http",
      "url": "https://www.kylrix.space/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_PAT_TOKEN>"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "kylrix": {
      "type": "http",
      "url": "https://www.kylrix.space/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_PAT_TOKEN>"
      }
    }
  }
}

Windsurf, Goose, Cline & Continue

인스턴스 엔드포인트를 가리키는 HTTP 또는 SSE MCP 서버를 구성하세요:

• 서버 URL: https://www.kylrix.space/api/v1/mcp

• 전송 방식: http (또는 /api/v1/mcp?transport=sse를 통한 sse)

• 헤더: Authorization: Bearer <YOUR_PAT_TOKEN> (Settings > Developers에서 토큰 생성)

통합 시스템

Kylrix는 단절된 포인트 앱들을 복리 그래프로 대체합니다. 이 그래프에서는 메모, 작업, 자격 증명, 캘린더 이벤트, 토론이 동일한 기반 객체 프리미티브를 공유합니다. 한 도메인의 행동은 검색, 실시간 협업, 자율 에이전트를 위한 컨텍스트를 즉시 풍부하게 만듭니다.

로컬 상태는 백그라운드 확인과 함께 즉각적인 진실의 원천 역할을 하며, 에이전트와 외부 통합은 REST 및 MCP 인터페이스를 통해 동일한 도구 호출을 활용합니다.

SDK 및 확장성

Kylrix는 비교할 수 없는 반복 속도와 멀티 레포 분기 제로를 유지하기 위해 의도적으로 단일하고 독립적인 웹 코드베이스로 설계되었습니다. 설계 원칙상 퍼스트파티 모바일, 데스크톱, CLI 클라이언트 앱은 코어에 포함되지 않습니다. 대신 Kylrix는 포괄적인 프로토콜, 표준 API, 개발자 도구를 제공하여 서드파티 개발자, 에이전트, 커뮤니티 빌더가 맞춤형 네이티브 클라이언트, CLI 도구, 스크립트, 생태계 통합을 구축할 수 있게 합니다.

모든 인터페이스에 대한 종합 문서는 Kylrix Docs에서 확인할 수 있습니다.