Editor tabs — open notes stack into a tab strip with a soft cap of 4 simultaneous tabs; oldest is evicted FIFO when you open a fifth.
Customizable sidebar — move plugin panels between the left/right rails and reorder them up/down. Layout persists per user.
A shared brain for people and AI. Self-hosted knowledge base with built-in MCP server, wiki-linking, graph visualization, mobile sync, and plugin ecosystem.
Estrelas
12
Ferramentas
—
Disponibilidade
—
Inline plugin settings — every plugin's configuration renders directly beneath its card in the admin panel, no separate dialog.
Why Kryton?
Your notes shouldn't live in a silo. Kryton is a knowledge base that both humans and AI agents can read, write, and reason over — through the same API, the same notes, the same graph.
For humans: A full-featured note-taking app with wiki-links, graph view, markdown editor, mobile app, and multi-user sharing.
For AI agents: A built-in MCP server gives Claude Code, Cursor, Windsurf, and any MCP-compatible agent direct access to your knowledge base — search notes, read context, create documents, traverse the knowledge graph, and use templates. Your AI assistant becomes a collaborator that remembers everything you've written.
Together: Humans write notes, AI reads them for context. AI generates documentation, humans review and refine it. Both contribute to a shared, interconnected knowledge graph.
Built-in MCP Server
Kryton ships with a production-ready MCP server at /api/mcp. No sidecar, no proxy, no extra setup — it's part of the app.
Plugins that register API routes are automatically exposed as MCP tools
Connect Your AI Agent
One-shot install (recommended)
npx @azrtydxb/kryton-init
That single command:
Asks for your Kryton server URL (defaults to https://kryton.ai)
Signs you in and mints an API key
Detects every supported AI tool on your machine
Writes the correct MCP config to each one (HTTP for hosts that support it, stdio shim via @azrtydxb/kryton-mcp for the rest)
It's idempotent — re-running replaces previous Kryton entries instead of duplicating them, and backs up any config it touches.
Supported hosts: Claude Code, Cursor, Claude Desktop, Codex, OpenCode, Cline, Continue, KiloCode, RooCode (macOS + Linux).
Other commands: uninstall removes Kryton from every host, status shows which hosts are wired, detect previews without writing. Full reference in docs/CLI.md.
Manual wiring (escape hatch)
If you'd rather edit the config yourself:
1. Create an API key in Kryton: Account Settings > API Keys > Create (read-write scope)
2. Configure your agent:
Add to your MCP settings (~/.claude.json or project .mcp.json):
3. Start using it: Ask your AI to "search my notes for...", "create a note about...", "what notes link to X?", or "read my project roadmap and suggest next steps."
Security
Scoped API keys — read-only or read-write, with optional expiration
Per-user isolation — each key accesses only that user's notes
256-bit entropy — keys use kryton_ prefix for secret scanning detection
Rate limited — 300 requests / 15 minutes per key
No admin access — API keys cannot access admin functions
Drag-and-drop file tree — move files and folders by dragging
Toast notifications — global info/success/error feedback
Responsive mobile layout — optimized for phone screens
Full WCAG accessibility — ARIA roles, keyboard navigation, focus management
Plugin Ecosystem
24 official plugins covering kanban, mermaid, excalidraw, git backup, calendar journal, flashcards, slash commands, theme presets, and more. Browse the full catalogue at azrtydxb/kryton-plugins.
Vim keybindings are no longer maintained as a built-in or shipped plugin.
Plugin APIs are automatically exposed as MCP tools — install a plugin and your AI agent can use it immediately.
Tech Stack
Component
Technology
Frontend
React 19, Vite 8, TypeScript 5.9, Tailwind CSS 4
Backend
Fastify 5, Drizzle ORM, TypeScript 5.9
Database
Postgres 16 with pgvector and tsvector
Mobile
Expo SDK 55, React Native (online-only against the server API)
Editor
In-house markdown editor with plugin-extensible suggestions and commands
Graph
D3.js force-directed
Auth
better-auth (sessions, OAuth, passkeys, 2FA)
AI Integration
MCP SDK (Model Context Protocol)
Runtime
Node.js 24
Quick Start
Docker (recommended)
The simplest path. The repo ships a docker-compose.yml that brings up a pgvector/pgvector:pg16 Postgres alongside the Kryton server — no separate database install needed.
git clone https://github.com/azrtydxb/kryton.git
cd kryton
docker compose up --build -d
Requires Postgres 16+ with the pgvector extension. The fastest way is to run just the Postgres service from the bundled compose file and run the app on the host:
git clone https://github.com/azrtydxb/kryton.git
cd kryton
docker compose up -d postgres # Postgres 16 + pgvector on :5432
npm install
export POSTGRES_URL=postgres://kryton:kryton@localhost:5432/kryton
export BETTER_AUTH_SECRET=$(openssl rand -hex 32)
npm run dev
If you'd rather use a Postgres you already have, make sure it's 16+ and run CREATE EXTENSION IF NOT EXISTS vector; once against the target database, then point POSTGRES_URL at it.
Kryton supports three deployment surfaces, all version-locked to the same app image and kept in sync by a CI drift gate. Pick the one that matches your environment.
Surface
Best for
Pros
Cons
Docker Compose
Single host, evaluation, small teams
One command, no orchestrator, Postgres bundled
No HA, manual upgrades, single node only
Helm chart
Kubernetes clusters, declarative config
Standard K8s, ingress / PVC / secrets handled, OCI distribution
You manage backups, plugins, multi-instance lifecycle yourself
Kubernetes Operator
Production K8s, multiple instances, managed lifecycle
Scheduled backups, plugin pre-install with sha256 verify, snapshots, multi-instance via CRDs
Extra moving piece, CRD install required
Docker Compose
Single-host self-hosting using docker-compose.prod.yml:
git clone https://github.com/azrtydxb/kryton.git
cd kryton
cp .env.example .env # fill in BETTER_AUTH_SECRET, POSTGRES_URL etc.
docker compose -f docker-compose.prod.yml up -d
Helm
Install on any Kubernetes cluster from the OCI registry:
The React Native mobile app lives in its own repository: azrtydxb/kryton-mobile. It is an online-only client that talks to the Kryton server over REST and uses the Yjs WebSocket endpoint for real-time collaborative editing of note bodies.
Note bodies are stored and edited as Yjs CRDT documents. All clients (web, mobile, and future desktop) connect to the server's WebSocket endpoint at /ws/yjs/:docId for live, conflict-free collaborative editing — concurrent edits from multiple devices or users merge automatically with no data loss.
Everything else (folders, tags, shares, settings, graph edges, trash items, installed plugins) is plain relational data served by ordinary REST endpoints; clients fetch on demand and do not maintain a local mirror.
Cedar for agent identity
AI agents are first-class database entities with short-lived tokens and optional Cedar policy documents. The server evaluates the Cedar policy on every agent request — (principal, action, resource) — before executing the handler. Agents default to deny-all; permissions are granted explicitly per note, folder, or tag. Agent actions are attributed to Agent::<id> in audit logs, distinct from the owning user's actions.
Kryton uses Drizzle Kit against Postgres. Migrations live under packages/server/src/db/migrations/ and run automatically at server startup.
For developers, after editing any file under packages/server/src/db/schema/:
cd packages/server
POSTGRES_URL=postgres://kryton:kryton@localhost:5432/kryton npm run db:generate
Inspect and commit the generated .sql file alongside the schema change. See MIGRATIONS.md for details.
Development
npm install # Install dependencies
npm run dev # Start dev servers (frontend :5173, backend :3001)
npm run typecheck # Type check
npm run lint # Lint
npm run build # Build for production
npm test # Run all tests
Documentation
API Keys & MCP — API key setup, MCP configuration, full tool reference
"Kryton" and the Kryton logo are trademarks of Pascal Watteel. The Apache
2.0 license grants rights to use the software, but it does not grant
permission to use these trademarks. You may not use the "Kryton" name or logo
in a way that suggests endorsement of, or affiliation with, your fork or
derivative product. Forks distributed publicly must be renamed.
Contributing
Contributions are welcome. Before your first pull request, please read and
sign the Contributor License Agreement. The CLA Assistant bot will
prompt you on your first PR — sign by commenting:
I have read the CLA Document and I hereby sign the CLA
K
Kryton
azrtydxb·12 estrelas·
A shared brain for people and AI. Self-hosted knowledge base with built-in MCP server, wiki-linking, graph visualization, mobile sync, and plugin ecosystem.
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo Kryton?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Kryton precisa de uma chave de API?
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Kryton usa?
Kryton roda localmente via stdio.
Quando Kryton foi verificado pela última vez?
Última verificação: 2026-10-28. A shared brain for people and AI. Self-hosted knowledge base with built-in MCP server, wiki-linking, graph visualization, mobile sync, and plugin ecosystem.