kylrix

Patrocinio

Related MCP server: Kopern

Inicio rápido y configuración

Autoalojamiento

Opción 1: Script de un solo comando

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

Opción 2: Docker pull directo

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

Opción 3: Docker Compose

docker compose up -d

Desarrollo local

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

Abre http://localhost:3005.

Flujo de trabajo para contribuidores de Ota

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

Consulta ota.yaml (verify, dev, selfhost) y appwrite.config.json.

Filosofía

Todo es un objeto, cada acción es simplemente una llamada a una herramienta, y cada resultado es más contexto.

Kylrix trata notas, tareas, eventos, elementos del vault, chats, archivos e incluso espacios de trabajo como la misma primitiva: objetos con filas, permisos e historial. Los agentes no viven en una barra lateral: viven en el espacio de trabajo y llaman a las mismas herramientas que tú. Cada nota que capturas, cada tarea que cierras, cada mensaje que envías alimenta el Context Engine (CompiledLocalContext) y se convierte en apalancamiento para la siguiente acción. El sistema se retroalimenta.

La copia local es la verdad. La red lo confirma. Los invitados reciben el mismo motor. Ninguna función es una isla.

Sinergia entre humanos y agentes

Kylrix está diseñado desde primeros principios para la construcción colaborativa entre humanos y agentes de IA autónomos:

• Espacios de trabajo vivos compartidos: los humanos aportan dirección arquitectónica, criterio y visión de dominio; los agentes operan directamente dentro de espacios de trabajo concretos (isAgentic: true) para probar las herramientas, capturar conceptos técnicos, planificar backlogs y ejecutar cambios de código.

• Context Engine acumulativo: cada nota redactada, tarea completada o hilo de discusión creado por humanos o agentes enriquece el contexto compartido del espacio de trabajo, amplificando la velocidad en cada tarea sucesiva.

• Paridad de interfaz 1:1 (MCP y API REST): los agentes se conectan al ecosistema sin fricción mediante el servidor del Model Context Protocol (MCP) (/api/mcp) o la API HTTP de Kylrix (/api/v1). Ambas interfaces ofrecen una paridad de funciones 1:1 completa en notas, objetivos, ideas, eventos de calendario, formularios, flujos y discusiones.

• Dogfooding autónomo en producción: Kylrix se construye y evoluciona gracias a agentes que trabajan junto a ingenieros humanos dentro del propio Kylrix, transformando el desarrollo de software cotidiano en un bucle unificado y compuesto.

Integraciones e instalación de MCP

→ Guía completa de conexión de agentes: docs/integrations.md (prompt listo para copiar y pegar para cualquier agente de programación)

Conecta cualquier cliente de IA, CLI o agente autónomo directamente a Kylrix mediante el Model Context Protocol (MCP) y las Agent Skills oficiales.

1. Instalación de Agent Skills

Añade capacidades específicas de dominio directamente a tu asistente de programación o 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. Instalación de Kylrix MCP en diferentes herramientas

El servidor MCP de Kylrix se ejecuta sobre Streamable HTTP y SSE en https://www.kylrix.space/api/v1/mcp.

¿Autoalojas tu propia instancia? Consulta 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 (instalación automatizada con un solo comando)

# 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 (copia .cursor/mcp.json.example o ve a Configuración > Funciones > 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

Configura un servidor MCP HTTP o SSE que apunte al endpoint de la instancia:

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

• Transporte: http (o sse mediante /api/v1/mcp?transport=sse)

• Cabecera: Authorization: Bearer <YOUR_PAT_TOKEN> (crea tokens en Configuración > Desarrolladores)

El sistema unificado

Kylrix reemplaza las aplicaciones puntuales desconectadas por un grafo acumulativo en el que notas, tareas, credenciales, eventos de calendario y discusiones comparten las mismas primitivas de objeto subyacentes. Una acción en un dominio enriquece inmediatamente el contexto para la búsqueda, la colaboración en tiempo real y los agentes autónomos.

El estado local actúa como fuente inmediata de verdad con confirmación en segundo plano, mientras que los agentes y las integraciones externas aprovechan las mismas llamadas a herramientas a través de las interfaces REST y MCP.

SDK y extensibilidad

Kylrix está diseñado intencionadamente como una única base de código web soberana para mantener una velocidad de iteración incomparable y cero divergencia entre múltiples repositorios. Como principio de diseño, las aplicaciones cliente propias para móvil, escritorio o CLI no se incluyen en el núcleo; en su lugar, Kylrix proporciona protocolos completos, APIs estándar y herramientas para desarrolladores, de modo que desarrolladores externos, agentes y creadores de la comunidad puedan construir clientes nativos personalizados, herramientas CLI, scripts e integraciones con el ecosistema.

La documentación completa de todas las interfaces está disponible en los Kylrix Docs.

Informes de errores, solicitudes de funciones y seguridad

Envía informes de errores, sugerencias de funciones o divulgaciones responsables de vulnerabilidades directamente a través de nuestro Portal unificado de comentarios y seguridad. Para las especificaciones de arquitectura, consulta ARCHITECTURE.md.