kylrix

赞助

Related MCP server: Kopern

快速开始与安装

自托管

方式一：单命令脚本

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

方式二：Docker 直接拉取

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

方式三：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。

设计理念

一切皆为对象，每个操作都只是工具调用，每个结果都是更多上下文。

Kylix 将笔记、任务、事件、保险库条目、聊天、文件甚至工作区都视为同一种原语：带有行、权限和历史的对象。Agent 不是活在侧边栏里——它们活在工作区中，调用着你调用的同样工具。你捕获的每一条笔记、关闭的每一个任务、发送的每一条消息，都会滋养 Context Engine（CompiledLocalContext），并成为下一个行动的杠杆。整个系统不断复利累积。

本地副本即真相。网络负责确认。访客获得相同的引擎。没有任何功能是一座孤岛。

人类与 Agent 的协同

Kylix 从第一性原理出发，专为人类与自主 AI Agent 之间的协作共建而设计：

• 共享的活工作区：人类提供架构方向、品味与领域愿景；Agent 直接在具体工作区（isAgentic: true）内运作，亲身使用（dogfood）工具、沉淀技术概念、规划待办积压并执行代码变更。

• 复利式 Context Engine：无论是人类还是 Agent，起草的每一条笔记、完成的每一个任务、创建的每一个讨论线程，都会丰富共享工作区的上下文，为后续的每一项任务放大执行速度。

• 1:1 接口对等（MCP 与 REST API）：Agent 可通过 Model Context Protocol (MCP) 服务器（/api/mcp）或 Kylix HTTP API (/api/v1) 无缝接入生态。两种接口在笔记、目标、想法、日历事件、表单、流程和讨论上提供完整的 1:1 功能对等。

• 生产环境中的自主 Dogfooding：Kylix 由 Agent 与人类工程师在 Kylix 内部并肩构建并持续演进，将日常软件开发转化为统一的复利闭环。

集成与 MCP 安装

→ 完整 Agent 接入指南：docs/integrations.md（可直接复制粘贴给任何编码 Agent 的提示词）

通过 Model Context Protocol (MCP) 和官方 Agent Skills，将任何 AI 客户端、CLI 或自主 Agent 直接连接到 Kylix。

1. 安装 Agent Skills

将领域特定能力直接添加到你的编码助手或 CL：

# 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. 将 Kylix MCP 安装到不同工具中

Kylix MCP 服务器通过 Streamable HTTP 与 SSE 运行于 https://www.kylix.space/api/v1/mcp。

想要自托管自己的实例？参见 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.kylix.space/api/v1/mcp

• 传输方式：http（或通过 /api/v1/mcp?transport=sse 使用 sse）

• 请求头：Authorization: Bearer <YOUR_PAT_TOKEN>（在 Settings > Developers 中创建令牌）

统一系统

Kylix 用一个复利式图结构取代彼此割裂的单点应用，让笔记、任务、凭据、日历事件和讨论共享同一套底层对象原语。某个领域中的一次操作会立即丰富搜索、实时协作和自主 Agent 的上下文。

本地状态作为即时的事实来源，并在后台进行确认；同时，Agent 和外部集成通过 REST 与 MCP 接口使用完全相同的工具调用。