kylrix

Спонсор

Related MCP server: Kopern

Быстрый старт и настройка

Самостоятельный хостинг

Вариант 1: скрипт одной командой

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

Вариант 2: прямой pull 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 рассматривает заметки, задачи, события, элементы Vault, чаты, файлы и даже рабочие пространства как один и тот же примитив: объекты со строками, правами доступа и историей. Агенты не живут на боковой панели — они живут в рабочем пространстве и вызывают те же инструменты, что и вы. Каждая захваченная заметка, каждая закрытая задача, каждое отправленное сообщение питают Context Engine (CompiledLocalContext) и становятся рычагом для следующего действия. Эффект системы накапливается.

Локальная копия — источник истины. Сеть подтверждает. Гости получают тот же движок. Ни одна функция не является островом.

Синергия человека и агента

Kylrix спроектирован из первых принципов для совместного построения, в котором участвуют люди и автономные ИИ-агенты:

• Общие живые рабочие пространства: люди задают архитектурное направление, вкус и видение предметной области; агенты работают непосредственно внутри конкретных рабочих пространств (isAgentic: true), обкатывая инструменты на себе, фиксируя технические концепции, планируя бэклоги и внося изменения в код.

• Context Engine с накопительным эффектом: каждая созданная заметка, каждая выполненная задача или ветка обсуждения — человеком или агентом — обогащает общий контекст рабочего пространства, увеличивая скорость выполнения каждой следующей задачи.

• Паритет интерфейсов 1:1 (MCP и REST API): агенты бесшовно подключаются к экосистеме через сервер Model Context Protocol (MCP) (/api/mcp) или Kylrix HTTP API (/api/v1). Оба интерфейса обеспечивают полный паритет функций 1:1 для заметок, целей, идей, событий календаря, форм, flows и обсуждений.

• Автономный dogfooding в продакшене: Kylrix создаётся и развивается агентами, работающими вместе с инженерами-людьми внутри самого Kylrix, превращая повседневную разработку ПО в единый накопительный цикл.

Интеграции и установка MCP

→ Полное руководство по подключению агентов: docs/integrations.md (промпт для копирования в любого кодинг-агента)

Подключайте любой ИИ-клиент, CLI или автономного агента напрямую к Kylrix через Model Context Protocol (MCP) и официальные Agent Skills.

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 работает поверх Streamable HTTP и SSE по адресу https://www.kylrix.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, указав endpoint экземпляра:

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

• Transport: http (или sse через /api/v1/mcp?transport=sse)

• Header: Authorization: Bearer <YOUR_PAT_TOKEN> (создавайте токены в Settings > Developers)

Единая система

Kylrix заменяет разрозненные точечные приложения графом с накопительным эффектом, в котором заметки, задачи, учётные данные, события календаря и обсуждения используют одни и те же базовые объектные примитивы. Действие в одной области немедленно обогащает контекст для поиска, совместной работы в реальном времени и автономных агентов.

Локальное состояние служит непосредственным источником истины с фоновым подтверждением, а агенты и внешние интеграции используют идентичные вызовы инструментов через интерфейсы REST и MCP.

SDK и расширяемость

Kylrix сознательно спроектирован как единая суверенная веб-кодовая база, чтобы сохранять непревзойдённую скорость итераций и нулевое расхождение между несколькими репозиториями. В соответствии с этим принципом дизайна, собственные (first-party) мобильные, десктопные или CLI-клиенты не поставляются в ядре; вместо этого Kylrix предоставляет всеобъемлющие протоколы, стандартные API и инструменты для разработчиков, чтобы сторонние разработчики, агенты и создатели сообщества могли строить собственные нативные клиенты, CLI-инструменты, скрипты и экосистемные интеграции.

Исчерпывающая документация по всем интерфейсам доступна в Kylrix Docs.

Сообщения об ошибках, запросы функций и безопасность

Отправляйте сообщения об ошибках, предложения функций или ответственные раскрытия уязвимостей напрямую через наш Unified Feedback & Security Portal. Архитектурные спецификации см. в ARCHITECTURE.md.