Personal knowledge base for Claude Code. One plugin, one command, everything set up.
# 1. Add marketplace
claude plugin marketplace add https://github.com/iorlas/iorlas-marketplace.git
# 2. Install Kay
claude plugin install iorlas-kay@iorlas-marketplace
# 3. Run init (this sets up everything)
/init# 4. Enable global agent lifecycle (ACC, signal emission)
echo 'Read `~/Documents/Knowledge/global-claude.md` at the start of every session.' > ~/.claude/CLAUDE.mdThat's it. Init will:
- Check dependencies (Node.js, Python, QMD, jq, git)
- Create your Knowledge folder with ontology-driven structure
- Install the entity engine, scheduler, and background jobs
- Configure semantic search (QMD), memory, MCP, and a status line
- Tell you what to do next
Run /init again anytime — it detects drift and self-heals.
Start the scheduler in a spare terminal tab (keeps embeddings fresh, runs decay scoring, incubates new ideas):
~/Documents/Knowledge/internals/.venv/bin/python3 ~/Documents/Knowledge/internals/core/scheduler.pyStart working from your Knowledge folder:
cd ~/Documents/Knowledge
claude| Command | What it does |
|---|---|
/init |
Set up from scratch or health-check an existing install |
/inbox |
Capture thoughts, tasks, links, voice dumps — from any directory |
/reflect |
Emit evolution signal — record friction, needs, decisions to Evolution/signals/ |
/triage |
Process inbox items: resolve mentions, link entities, route observations |
/consolidate |
Find scattered entities that belong together and merge them |
Kay is ontology-driven. Entity schemas (YAML files in the plugin) define your knowledge structure:
- Inbox — captured ideas, links, notes awaiting triage
- Projects — delivery work, consulting, content creation
- People — contacts, collaborators, public figures
- Companies — organizations relevant to your work
- Researches — deep investigations with sources and analysis
- Processes — reusable methodologies and workflows
- References — curated resource lists by domain
Add a new .yaml schema to the plugin's ontology/ folder, rerun /init, and the new entity type appears.
Want a new entity type? Create a schema:
# ontology/book.yaml
name: book
description: Books you've read or want to read
folder: Books
file_pattern: "{slug}/README.md"
inherits: baseRun /init — Kay creates the Books/ folder and you're ready to go.
git clone https://github.com/iorlas/iorlas-kay.git
claude --plugin-dir ./iorlas-kayUse --plugin-dir for local development. Edits are picked up on session start — no cache issues.
MIT — Denis Tomilin