# iwe-org/iwe

Markdown knowledge graph — LSP for your editor, CLI + MCP memory for your AI agents

Repository: https://github.com/iwe-org/iwe
Canonical: https://ross.abutalabs.com/products/iwe
Homepage: https://iwe.md
Language: Rust
License: Apache-2.0
License Family: permissive
Topics: lsp, markdown, notes, zettelkasten, pkm, neovim, helix, zed, cli, knowledge-management, productivity, rust, ai-agents, mcp, knowledge-graph, language-server, local-first, note-taking, okf, ai-memory
Last push: 2026-08-24T23:00:42+00:00

## Health v2 (maintenance only)
Score: 85/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 50
- inputs: {"age_days": 713, "days_push": 9, "days_rel": 9, "gap_med": 2, "n_releases_24m": 102}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1576, forks 73 (observed 2026-08-28T04:05:06.047851+00:00)

## What it is
IWE is a Rust-based tool that turns a directory of plain Markdown files into a queryable knowledge graph, exposed through an LSP server for editors (VS Code, Neovim, Zed, Helix), a CLI, and an MCP server for AI agents. It is local-first with no cloud or database, letting humans and agents navigate, search, and restructure the same notes.

## Use cases
- manage zettelkasten-style markdown notes with IDE features
- give AI coding agents structured memory over my notes
- query my markdown notes like a database from the CLI
- get LSP navigation and refactoring for markdown in Neovim
- build a local-first personal knowledge graph with git versioning
- let Claude Code capture session context as reviewable markdown
- run structured queries like 'all drafts under this subtree' over notes

## When to choose
- you want database-style structured queries over plain markdown files without a database
- you need both editor LSP integration and MCP/CLI access to the same notes
- you prefer local-first, git-versioned knowledge management with full file ownership
- you want AI agents to navigate notes by structure rather than similarity search

## When to avoid
- you need a hosted or collaborative note-taking service with sync across devices
- you want semantic/vector similarity search over unstructured text rather than link-based structure
- you need rich WYSIWYG editing or a graphical note app
- your notes live in formats other than markdown

## Facets
- artifact type: cli-tool
- maturity: active
- function: search-engine, mcp, cli, developer-tools, documentation, markdown
- domain: developer-tools, text-editors
- platform: windows, cli, cross-platform, rust
- tags: knowledge-graph, lsp, zettelkasten, pkm, note-taking, local-first, ai-memory, mcp-server, language-server, knowledge-management, ai-agents, command-line, linux, macos

## Member repositories
- iwe-org/iwe (main) score 85

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:06.047851+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:57:25.202220+00:00, confidence not recorded.
  - readme: https://github.com/iwe-org/iwe (fetched 2026-08-28T04:05:06.047851+00:00, sha 5cba7f1b93ec)
  - homepage: https://iwe.md (fetched 2026-08-29T11:27:40.496208+00:00, sha 6b84ce09b211)
  - site_page: https://iwe.md/docs/getting-started (fetched 2026-08-29T11:27:40.502436+00:00, sha 5fe9d0716882)
  - site_page: https://iwe.md/docs (fetched 2026-08-29T11:27:40.498755+00:00, sha 789194150620)
  - site_page: https://iwe.md/about (fetched 2026-08-29T11:27:40.500630+00:00, sha 4629d56341e9)
  - site_page: https://iwe.md/docs/getting-started/installation (fetched 2026-08-29T11:27:40.504202+00:00, sha fd506829120d)
  - site_page: https://iwe.md/docs/getting-started/usage (fetched 2026-08-29T11:27:40.505827+00:00, sha 9c693815a283)
  - site_page: https://iwe.md/docs/features (fetched 2026-08-29T11:27:40.507587+00:00, sha 5b5da4c89aec)
  - site_page: https://iwe.md/docs/features/search (fetched 2026-08-29T11:27:40.509541+00:00, sha 7774c9b26bae)
  - site_page: https://iwe.md/docs/features/navigation (fetched 2026-08-29T11:27:40.511517+00:00, sha 8ded7f25050d)
- Data as of 2026-08-30T08:39:29.467469+00:00.
