Indexed knowledge bases with command-line tools for agents.
A wiki keeps project knowledge as plain markdown, indexed at every level
by _index.md files, read by consulting the index and opening only the
pages that a task needs. Andrej Karpathy named this shape the
LLM Wiki
pattern, and Google's
Open Knowledge Format
describes a standardized format for such markdown knowledge bases. Most
approaches leave a great deal of structuring for agents to maintain by
hand; here a deterministic CLI generates the indexes and cross-links and
reconciles _index.md merges when parallel edits collide, so content is
the only judgment call.
Source: https://github.com/plasma-ai/wiki
Package: https://pypi.org/project/plasma-wiki/
Documentation: https://docs.plasma.ai/wiki
Installation
Install the wiki package from PyPI:
Use pipx install plasma-wiki or uv tool install plasma-wiki to
install in an isolated environment.
Skill
Install the /wiki skill for your agent via the plugin marketplace
(Claude Code and Codex):
# Claude Code /plugin marketplace add plasma-ai/plugins /plugin install wiki@plasma # Codex codex plugin marketplace add plasma-ai/plugins codex plugin add wiki@plasma
Or from the CLI, which copies the skill into ~/.claude/skills and
~/.agents/skills (add --project for the current project only):
Usage
A wiki is a tree of markdown files linked together by _index.md files.
Each folder becomes a section, and each markdown file becomes an entry.
Wikis are designed to be read and written by both humans and agents:
humans author content in Obsidian (or any editor), and agents query the
wiki through the CLI to ground their work in project-specific knowledge.
Page, folder, and wiki names are lenient by default: spaces, dashes,
mixed case, and unicode are all fine. Only characters that would break
the wiki's structure — its path, link, and index syntax — are rejected,
along with leading dots (hidden files) and the reserved _index /
_config names. A wiki can opt into stricter rules, such as ASCII-only
or identifier-style names, through the naming block in
_config/settings.json; wiki lint flags any name that violates the
policy.
Frontmatter timestamps default to UTC in ISO-8601. To change them, set a
timezone (any IANA name) and format (a strftime string) under
timestamp in _config/settings.json.
CLI
Use the /wiki skill to manage wikis, or drive the wiki CLI directly.
Initialize a wiki in the current project and configure integrations:
wiki init— scaffold a new wiki with a root indexwiki config— install Obsidian plugins and the git merge driver
Maintain indexes as files are added and removed:
wiki lint— validate structure and flag issueswiki update— sync index links with the filesystem
Browse structure, search across content, and read entries:
wiki map— print an indented tree overviewwiki search— search content with regexwiki read— read a named entry
Commands operate on the wiki/ folder under the current directory by
default; pass --path to target another wiki. map, search,
update, and lint accept an optional name argument to restrict scope
to a subtree. Run wiki --help and wiki <command> --help for full
option descriptions.
Development
Install
Run install.sh in the package root. With no environment active it
creates and uses a local .venv; with one active (e.g. pyenv) it
installs into that environment (editable), without recreating it:
./install.sh --all-extras --groups=test,lint,type
Run ./install.sh --help for all options. Alternatively, run
uv sync --all-extras --group test --group lint --group type and
uv run pre-commit install to set up the environment manually.
Installing a dependency as editable (e.g. a sibling package) is left to
the caller: uv pip install --editable <path>.
Once installed, run tools with uv run <command>, or activate the
environment first (source .venv/bin/activate).
Tests
Run the test suite:
Linting
Run linters and formatters:
pre-commit run --all-files
Third-Party Software
wiki sets up the
Front Matter Title
Obsidian plugin by Snezhig, which displays each note's name
frontmatter as its title. The plugin is licensed GPL-3.0;
wiki init/wiki config download version 4.1.0 from the upstream
GitHub release at setup time rather than redistributing it.
License
Licensed under the Apache License 2.0 — see LICENSE.
Copyright © 2026 Plasma AI