kylrix

TL;DR

• Kylrix — open-source, local-first workspace for notes, goals, workspaces, chat, vault, and agents.

• Use the cloud — kylrix.space

• Self-host — curl -fsSL https://raw.githubusercontent.com/Kylrix/kylrix/master/selfhost.sh | bash → app on :5003

• Wire an agent — mint a PAT (your workspace) or agent key (its own workspace), then npx skills add kylrix/kylrix --skill mcp --skill api --skill agents

Related MCP server: Kopern

Sponsor

Self-host

Agent skill:

npx skills add kylrix/kylrix --skill selfhost

Configure (optional — omit to auto-mint admin credentials into .env):

export SELFHOST_ADMIN_EMAIL=you@example.com
export SELFHOST_ADMIN_PASSWORD='your-secure-password'

Install (bundled Appwrite + Kylrix, no cloud backend):

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

More: SELFHOST.md · re-run ./selfhost.sh anytime (detects drift, skips healthy steps).

Develop

git clone https://github.com/Kylrix/kylrix.git
cd kylrix
cp env.sample .env

Install Ota (execution contract for this repo):

curl -fsSL https://dist.ota.run/install.sh | sh

Run:

ota doctor
ota up --workflow dev          # local app → http://localhost:3005
ota up --workflow verify       # lint + test + build

Contract: ota.yaml · schema: appwrite.config.json

Humans & agents

Humans and agents share the same workspace. MCP for IDE tool loops; REST for scripts, mobile, and CI.

Choose auth

Steps

1. Mint a token — PAT (your workspace) or agent key (agent workspace)

2. Install skills

   npx skills add kylrix/kylrix --skill mcp --skill api --skill agents

3. Connect MCP (IDE only — uses your PAT; Smithery wires the official endpoint)

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

4. Browser Agents (WebMCP) — Auto-exposed via navigator.modelContext with zero config in your live session:

   await navigator.modelContext.executeTool('kylrix_create_note', {
     title: 'Agent Note',
     content: 'Created via in-browser modelContext',
     tags: ['webmcp']
   });

   Test: Enable chrome://flags/#enable-webmcp-testing in Chrome, browse via ChatGPT, or click the WebMCP badge in Settings → Developers.

Wiring reference: docs/integrations.md · docs/webmcp.md

Integrations

What ships in the box

Local copy is the default source of truth; sync confirms in the background.

Feedback & security

Bug report form · ARCHITECTURE.md