Skip to content

Plasma Wiki

Nicholas Diao, Andrew Turner, Colton BerryJuly 21, 2026

Indexed knowledge bases with command-line tools for agents.

A luminous city of light rising from darkness.

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:

zsh
pip install plasma-wiki

wiki init

Start 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.