Skip to main content
Glama
deenesjakoruzh
Kylrix

kylrix

Official
by Kylrix
OverviewSchemaSourceRelated ServersDiscussions(1)Admin
TypeScript
Remote

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 (the agent's own workspace), then npx skills add kylrix/kylrix --skill mcp --skill api --skill agents

Related MCP server: Shared Workspace MCP

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

Default

App

http://localhost:5003

Appwrite API

http://localhost:8080/v1

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

Token

Use when

PAT (kyl_pat_…)

The agent acts in your workspace (IDE tools, scripts, MCP on your behalf). Settings → Developers

Agent key (kyl_apk_…)

The agent gets its own workspace — it provisions itself and mints its own PAT. Settings → Smart Agents

Surface

Use when

WebMCP (navigator.modelContext)

In-browser agents (Chrome, ChatGPT browser) with zero-config live session tools

MCP

IDE agents (Cursor, Claude, Windsurf, Codex, …)

REST API (/api/v1)

Scripts, mobile apps, CI, custom backends

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

Link

WebMCP (W3C in-browser)

docs/webmcp.md · navigator.modelContext

MCP

Humans & agents above · docs/mcp.md

REST API

docs/api.md · https://www.kylrix.space/api/v1

Sign in with Kylrix (OAuth 2.1)

docs/oauth2.md

SDK

sdk/ in this repo

Flows

Extensible layers inside Kylrix — kylrix.space/flows

What ships in the box

Area

What

Notes & ideas

Linked notes, tags, sharing

Goals

Goal tracking and focus sessions

Events

Calendar and scheduling

Forms

Build forms and collect responses

Flows

Installable workflow plugins (kylrix.space/flows)

Workspaces

Projects, collaborators, permissions

Connect

Chats, moments, group hangouts

Vault

Client-encrypted credentials (optional)

Agents

In-workspace sessions with tool parity to users

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

Feedback & security

Bug report form · ARCHITECTURE.md

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers