Technical approach & the agent
Scribe is a local-first desktop app with an agent at its core. Capture lands in an inbox; a librarian agent compiles it into the wiki behind a review gate; you retrieve it from chat, search, or any external agent over MCP.
The librarian agent
A background agent acts as librarian for your knowledge base — it dedupes, links, retitles, and keeps the taxonomy current as new captures arrive.
You write and talk; it files. The agent runs on every compile and can also be invoked directly when you want it to reorganize a corner of the vault.
Capture & the inbox
Everything starts as capture. A voice memo on a walk, a web page clipped mid-read, a paragraph typed into the composer, a note pushed in by an external agent over MCP — all of it lands in a single inbox, untouched and unstructured. Nothing is filed automatically; capture is deliberately cheap and lossless so the cost of writing something down never exceeds the value of having written it.
The inbox is a holding pen, not the wiki. Items sit there until you compile them, which means a bad capture never pollutes the base and a half-formed thought can wait until it has company. In practice most people compile in small batches — a handful of related captures at once — which gives the agent enough context to place each one well.
The compile loop
Compiling is where raw capture becomes knowledge. The librarian agent reads the new material, retrieves the pages it might touch, and works out a plan: which existing pages to edit, what to merge, where a new page is warranted, and which links to install. It then drafts the changes and hands them back as proposals rather than writing them straight to disk.
Crucially, the loop is iterative. The agent can open a page, realize the change implies a second edit elsewhere, and follow that thread — the same way a careful human editor would. Each step is a tool call against the vault, so the whole compile is legible after the fact: you can see exactly what it read and why it proposed what it did.
A codebase for knowledge
A knowledge base, it turns out, is a lot like a codebase — so Scribe borrows from Git. Large or destructive changes pass through a review gate, every update carries a full diff, and version history lets you revert.
The analogy runs deeper than diffs. Pages have something like a dependency graph through their links; a rename can ripple; a merge can orphan a reference. Treating those as first-class operations — rather than blind text edits — is what lets the agent be aggressive about keeping things tidy without quietly breaking the connections you rely on.
The review gate
The review gate is the trust model. Anything large, destructive, or cross-cutting stops here as a proposal, attributed and reversible, until you accept it. Small, page-local, in-context edits can stream straight to the page you're looking at; a four-page compile that splits a page and rewires its links earns a proper report.
This is the difference between an assistant you supervise and one you trust. Because nothing is final until you say so, the agent is free to propose the bold reorganization rather than the timid one — and you stay the editor-in-chief without having to do the filing yourself.
Versioning & revert
Every accepted change is a commit. The history is yours to walk: see how a page reached its current shape, diff any two points in time, and revert cleanly if a compile took a wrong turn. Reverting a change also unwinds the links it installed, so the graph never drifts out of sync with the prose.
Retrieval & MCP
Once it’s in, knowledge is reachable three ways: ask in chat, jump through search, or let any agent read it over MCP. The same channel works in reverse, so you can hand the right context to whatever tool will do the work.
Retrieval is the whole point — a base you can't get back out of is just a tidy graveyard. So Scribe treats the wiki as something to be read constantly: by you, by the chat, and by external agents that already have your context the moment they connect.
Storage & local-first
The vault is plain files on your disk. No lock-in, no server round-trip to read your own notes, and full function offline. Sync, when you want it, is layered on top rather than baked in — the source of truth is local, which is what makes the whole thing feel like yours.
Privacy
Because it's local-first, nothing leaves your machine unless you connect an agent that reads it. The MCP server is scoped to the vaults you choose, and writes always land in the review queue rather than the live wiki — so even a connected agent can propose, but only you can commit.
Limitations & what's next
The hard part isn't capture or retrieval; it's judgment — knowing when two notes are really the same idea, when a page should split, when a contradiction is a correction versus a nuance. The agent is good and getting better, but the review gate exists precisely because that judgment isn't perfect yet. The next frontier is making review itself faster: better summaries, tighter diffs, and surfaces like this one that let you move through a big change without losing the thread.