Wardwell

v0.8.0

Search everything
you've built.

Decisions, fixes, patterns — indexed and searchable by your AI agent mid-session. Wardwell is an MCP server that turns your accumulated knowledge into tools the agent calls on its own.

$ brew tap yakschuss/wardwell
$ brew install wardwell
$ wardwell init
# registers MCP server, builds search index

You work. Wardwell indexes.

Decisions, history, blockers, lessons — written to a plain-text vault as you go. Full-text indexed automatically. Markdown and JSONL you can read yourself.

The agent searches without asking.

Wardwell exposes search as MCP tools. When your agent needs context — a past decision, a pattern from another project, that fix from three weeks ago — it queries the index directly.

Cross-project. Cross-session.

Nothing stays siloed. A lesson learned in one project surfaces in another. Your vault is one search space — every project, every session, every insight.

// agent calls wardwell_search mid-session query: "KV batch write timeout" action: search // 3 results across 2 projects lessons.jsonl — Root cause: unbounded batch size Prevention: chunk KV writes to 25 keys max decisions.md — Switched to sequential writes for reliability Tradeoff: 2x slower, zero timeouts history.jsonlFeb 18 — Fixed KV timeout in vault sync
// agent resolves an entity by name action: resolve query: "discovery" // returns project + related kanban tickets discovery — project at keepsight/discovery score: 1.0 SH-45 — Customer workflow discovery protocol status: review

Navigate your knowledge graph.

Links, backlinks, and entity resolution across your vault. The agent traverses relationships in ~200 tokens instead of reading full files. Wiki-links, callsigns, and frontmatter refs — all indexed automatically.

Read only what you need.

Partial reads with offset and limit. The agent checks file size before committing tokens — 838-line PRD? Read lines 100–105. Frontmatter always comes back in full.

Kill-switch everything.

Feature flags in config.yml. Every new capability defaults on, flips off with one line. Graph navigation, entity resolution, partial reads — toggle each independently.

Get notified when new search capabilities ship.