Plasma Wiki
Nicholas Diao, Andrew Turner, Colton BerryJuly 21, 2026
Indexed knowledge bases with command-line tools for agents.

Why we built it
We built Plasma Wiki after running many agents on large projects at Plasma. They kept reloading the same material into context and overwriting each other's edits.
Plasma Wiki gives them a compact index to read first, so each agent opens only the pages a task needs. It became part of our daily workflow, and it is our first open-source tool. Fractal keeps each agent node's memory in a wiki.
Install the CLI
Install the package and initialize a wiki:
pip install plasma-wiki
wiki initStart with the map
wiki map prints the tree with word counts for each page and subtree. This is what the agent sees first:
api/ (210/4.5k): Routing, auth, and rate limiting.
auth (1.2k): Token issuance, refresh, and verification.
routes (3.1k): Endpoint handlers and request validation.
db/ (180/3.2k): Persistence layer and schema.
schema (1.4k): Tables, indexes, and migrations.
queries (1.6k): Hand-tuned SQL and the query builder.
architecture (640): How the services fit together.The agent reads api/ (210/4.5k) as a 210-word index summarizing a 4,500-word subtree. It opens api/ only when a task touches it, then reads a single page such as auth rather than the whole project.
Once the wiki has content, the loop is wiki map to see the layout, wiki search <pattern> to find a page, and wiki read <name> --words :100 to read its first 100 words. Agents run that loop through the /wiki skill or call the wiki CLI directly.
Plain Markdown, kept in sync by the CLI
Under the hood it's just files: each folder becomes a section, each Markdown file an entry, with _index.md files wiring the tree together. The same files serve people and agents: you edit them in Obsidian or any editor, and agents query them through the wiki CLI.
We are not the first to point agents at a wiki: Andrej Karpathy sketched an LLM-maintained one, and Google's Open Knowledge Format standardizes the shape. What Plasma Wiki adds is a deterministic CLI that keeps the index and links in sync, so the LLM only writes content.
Unlike a single AGENTS.md or an unindexed docs folder, the indexed tree scales: the agent navigates it instead of scanning everything.
New information updates the topic's existing page instead of accumulating as dated entries, so the wiki reads like a reference. Because it is plain files in your repo, every change is a reviewable diff and any page can be edited by hand.
When to use it
01
Large context, small reads
Plasma Wiki helps when an agent needs a compact index before opening files. Plain files and grep are simpler for a handful of files.
02
One wiki for several agents
wiki init installs a git merge driver for generated _index.md changes, so several agents or worktrees can share one wiki. Those changes merge cleanly, and real content conflicts still surface for review.
03
Find exact text
wiki search matches text patterns with regex, not semantic or vector meaning.
04
Knowledge that belongs in the repo
Use Plasma Wiki for shared project context: decisions, architecture, conventions, and workflows.