To0wnn/knowledge

A small self-hosted knowledge server for AI coding agents. It gives Claude Code, Codex and Antigravity (agy) on every
device the same live docs and memory, over MCP, plus a web UI with a graph of how the notes connect.
Notes are plain Markdown files on disk. The server indexes them, serves them to agents with a per-device token, and
checks them against a few house rules, so a growing pile of agent memory stays findable and tidy.
Made-up demo notes from demo/ ; regenerate with uv run --project server --with playwright python demo/screenshot.py .
## What it does
MCP tools for agents: search (regex and semantic), read, list, related notes, write and edit (with conflict
checks), new memo, delete (kept as a copy), history, lint, and ingest of a web page, PDF or text as a raw source.
Semantic hits show the file size and the newest "(checked )" mark, so an agent can tell which hit to read.
Session start context: each agent gets the shared instructions, the house rules and the memory index of the
project it works in, plus open items whose date has passed and hand-over tasks between agents.
Hand-overs during a session: before a prompt (at most every two minutes) Claude Code, Codex and agy ask
/tasks for the tasks handed to them; a task added after the session started is told to the agent once.
The same per-turn call lets the server steer every session, also a resumed one that ran no start hook: notices
(such as docs moved into an archive folder) go to the first session of the device that asks, offered again after an
hour when that session had no further turn, and one session is asked to run a full docs mirror sync in the
background when the device's last one is older than docssyncminutes (admin page, Settings).
Waking another agent (same machine): after a knowledgeedit/knowledgewrite/knowledgenewmemo, the
plugin wakes the newest idle session per agent and project on that machine that has a new task: Codex through
codex queue --thread, agy through its local language server (the agy session registers once by running
agenthooks.py register as a terminal command, the plugin asks it to), Claude Code through an asyncRewake
waiter hook. The woken agent tells the user and waits for consent. The admin page lists per token the sessions
seen in the last week (agent, session id, project, wakeable), each with a Forget button.
Usage limits: each prompt checks how much of the agent's own usage limit is used and says it once per session
and limit window at 50, 75 and 90%; from 95% a new subagent is refused (Claude Code Agent, Codex spawnagent, agy
invokesubagent). The numbers are the agent's own: Codex's rollout, agy's language server (after its one-time
register), and for Claude Code, which hands them only to its status line, a small tap that the plugin puts in front
of your status line at session start (your line still shows; the old command is kept in
~/.knowledge/statusline-original.json). Without numbers nothing is said or refused.
Secret guard: an edit that writes a known secret value into a file is refused (Claude Code Edit/Write, Codex
applypatch, agy's file tools), where token.py push-secrets left the hash file. Only new text counts, so removing a