plasma-wiki 0.1.0

Indexed knowledge bases with command-line tools for agents.

wiki

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 CLI from PyPI:

pipx install plasma-wiki

(pip install plasma-wiki or uv tool install plasma-wiki work too.)

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):

wiki install

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.

Use the /wiki skill to manage wikis. The wiki CLI is also available directly — run wiki --help and wiki <command> --help to explore.

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 syncs into that:

./install.sh --all-extras --groups=test,lint,type

Run tools with uv run <command>, or activate the environment first (source .venv/bin/activate). 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>.

Tests

Run the test suite:

pytest .

Linting

Run linters and formatters:

pre-commit run --all-files

Acknowledgements

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