kylrix

Sponsor

Related MCP server: Kopern

Schnellstart & Einrichtung

Self-Hosting

Option 1: 1-Befehl-Skript

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

Option 2: Docker Direct Pull

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

Option 3: Docker Compose

docker compose up -d

Lokale Entwicklung

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

Öffne http://localhost:3005.

Ota Contributor Workflow

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

Siehe ota.yaml (verify, dev, selfhost) und appwrite.config.json.

Philosophie

Alles ist ein Objekt, jede Aktion ist nur ein Tool-Aufruf, und jedes Ergebnis ist mehr Kontext.

Kylrix behandelt Notizen, Aufgaben, Ereignisse, Tresor-Einträge, Chats, Dateien und sogar Workspaces als dieselbe Primitive: Objekte mit Zeilen, Berechtigungen und Verlauf. Agenten leben nicht in einer Seitenleiste – sie leben im Workspace und rufen dieselben Tools auf, die auch du aufrufst. Jede Notiz, die du erfasst, jede Aufgabe, die du abschließt, jede Nachricht, die du sendest, speist die Context Engine (CompiledLocalContext) und wird zur Hebelwirkung für die nächste Aktion. Das System verstärkt sich selbst.

Die lokale Kopie ist die Wahrheit. Das Netzwerk bestätigt. Gäste erhalten dieselbe Engine. Keine Funktion ist eine Insel.

Mensch-Agent-Synergie

Kylrix ist von Grundprinzipien her für das kollaborative gemeinsame Bauen zwischen Menschen und autonomen KI-Agenten entwickelt:

• Gemeinsame lebendige Workspaces: Menschen geben die architektonische Richtung, den Geschmack und die Domänenvision vor; Agenten arbeiten direkt in konkreten Workspaces (isAgentic: true), um Tools selbst zu nutzen (Dogfooding), technische Konzepte zu erfassen, Backlogs zu planen und Codeänderungen auszuführen.

• Sich selbst verstärkende Context Engine: Jede Notiz, jede abgeschlossene Aufgabe oder jeder Diskussionsstrang, der von Menschen oder Agenten erstellt wird, bereichert den gemeinsamen Workspace-Kontext und erhöht die Geschwindigkeit bei jeder weiteren Aufgabe.

• 1:1-Schnittstellenparität (MCP & REST API): Agenten verbinden sich nahtlos über den Model Context Protocol (MCP)-Server (/api/mcp) oder die Kylrix HTTP API (/api/v1) mit dem Ökosystem. Beide Schnittstellen bieten vollständige 1:1-Funktionsparität über Notizen, Ziele, Ideen, Kalenderereignisse, Formulare, Flows und Diskussionen hinweg.

• Autonomes Dogfooding in der Produktion: Kylrix wird von Agenten gebaut und weiterentwickelt, die zusammen mit menschlichen Ingenieuren direkt in Kylrix selbst arbeiten – und verwandelt so die alltägliche Softwareentwicklung in eine einheitliche, sich selbst verstärkende Schleife.

Integrationen & MCP-Installation

→ Vollständiger Agenten-Anschlussleitfaden: docs/integrations.md (Copy-Paste-Prompt für jeden Coding-Agenten)

Verbinde jeden KI-Client, jede CLI oder jeden autonomen Agenten direkt über das Model Context Protocol (MCP) und die offiziellen Agent Skills mit Kylrix.

1. Installation der Agent Skills

Füge deinem Coding-Assistenten oder deiner CLI direkt domänenspezifische Fähigkeiten hinzu:

# 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. Installation von Kylrix MCP in verschiedenen Tools

Der Kylrix-MCP-Server läuft über Streamable HTTP und SSE unter https://www.kylrix.space/api/v1/mcp.

Du hostest deine eigene Instanz? Siehe 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 (Automatische 1-Befehl-Installation)

# 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 (kopiere .cursor/mcp.json.example oder Einstellungen > Funktionen > 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

Konfiguriere einen HTTP- oder SSE-MCP-Server, der auf den Instanz-Endpunkt zeigt:

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

• Transport: http (oder sse über /api/v1/mcp?transport=sse)

• Header: Authorization: Bearer <YOUR_PAT_TOKEN> (erstelle Tokens unter Einstellungen > Entwickler)

Das vereinheitlichte System

Kylrix ersetzt voneinander getrennte Einzel-Apps durch einen sich selbst verstärkenden Graphen, in dem Notizen, Aufgaben, Anmeldedaten, Kalenderereignisse und Diskussionen dieselben zugrunde liegenden Objekt-Primitiven teilen. Eine Aktion in einer Domäne bereichert sofort den Kontext für Suche, Echtzeit-Kollaboration und autonome Agenten.

Der lokale Zustand dient als unmittelbare Quelle der Wahrheit mit Bestätigung im Hintergrund, während Agenten und externe Integrationen über die REST- und MCP-Schnittstellen identische Tool-Aufrufe nutzen.

SDK & Erweiterbarkeit

Kylrix ist bewusst als eine einzige, souveräne Web-Codebasis konzipiert, um eine unübertroffene Iterationsgeschwindigkeit und null Multi-Repo-Divergenz zu gewährleisten. Als Designprinzip werden First-Party-Mobil-, Desktop- oder CLI-Client-Apps nicht im Kern ausgeliefert; stattdessen bietet Kylrix umfassende Protokolle, Standard-APIs und Entwickler-Tooling, damit Drittentwickler, Agenten und Community-Builder eigene native Clients, CLI-Tools, Skripte und Ökosystem-Integrationen erstellen können.

Umfassende Dokumentation für alle Schnittstellen ist in der Kylrix-Dokumentation verfügbar.

Fehlerberichte, Feature-Anfragen & Sicherheit

Reiche Fehlerberichte, Funktionsvorschläge oder verantwortungsvolle Offenlegungen von Schwachstellen direkt über unser Unified Feedback & Security Portal ein. Architekturspezifikationen findest du in ARCHITECTURE.md.