IWE is an Apache-2.0, Rust-built, local-first knowledge graph and memory system that turns a markdown directory into a graph and exposes it through an editor LSP plus a CLI and an MCP server (iwec over stdio, also runnable via npx as @iwe-org/mcp). It pairs fuzzy/full-text search with graph structure so one retrieve call returns parent context, children, and cross-references, and it enforces declared blast-radius guards and schema validation on agent writes. It suits people who keep knowledge as plain markdown and want AI agents retrieving structured context rather than similarity guesses; it is not for those wanting cloud hosting, a built-in AI model, or a stable library-level API. The main risks are the agent's write access to the notes directory and the network dependency introduced by running the server through npx.
IWE is a memory system for people and their AI agents: it turns a directory of markdown files into a knowledge graph. Notes stay as plain .md files in a local directory — no cloud, no database, no lock-in, versionable with git. The same graph has two interfaces: an LSP server for editors (VS Code, Neovim, Zed, Helix, and any LSP-capable editor) and a CLI plus an MCP server (iwec) for AI agents. The MCP server watches the files it serves, so edits made in your editor are reflected immediately. IWE has no built-in AI; it works alongside Claude, Codex, Gemini, and any tool that speaks the Model Context Protocol. Retrieval is by structure rather than similarity guessing: search finds an entry point, and retrieve/tree supply parent context, children, and cross-references in a single call. Agent writes are checked, not trusted — over MCP every mutation must declare expect guards stating how many documents and blocks it may touch, the whole update validates before anything is written, and a mismatch aborts with the offending blocks named. Frontmatter and document structure are validated against per-type document schemas, and mutations surface warnings for dangling links and orphan pages. Written in Rust under the Apache-2.0 license.
{
"mcpServers": {
"iwe": {
"command": "iwec",
"cwd": "~/notes"
}
}
}