Build, ship and think in one living agentic workspace.

Name: kylrix
Author: Kylrix

Your workflow becomes a living, scalable system that compounds daily leverage over time.

Open source · Self-hostable · Local-first · Optional encryption

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

Agent skill:

npx skills add kylrix/kylrix --skill selfhost

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

export [email protected]
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).

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 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

Install skills

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

Connect MCP (IDE only — uses your PAT; Smithery wires the official endpoint)
```
npx -y @smithery/cli install kylrix/kylrix --client cursor
```
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.

	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

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.