Plasma Wiki – a CLI for maintaining agent-edited Markdown wikis

Uh oh!

There was an error while loading. Please reload this page.

Notifications You must be signed in to change notification settings

Fork 0

Star 2

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

8 Commits

8 Commits

.claude-plugin

.claude-plugin

.codex-plugin

.codex-plugin

.github/workflows

.github/workflows

docs

docs

examples

examples

tests

tests

wiki

wiki

.cruft.json

.cruft.json

.gitattributes

.gitattributes

.gitignore

.gitignore

.pre-commit-config.yaml

.pre-commit-config.yaml

.python-version

.python-version

.readthedocs.yaml

.readthedocs.yaml

AGENTS.md

AGENTS.md

CLAUDE.md

CLAUDE.md

LICENSE

LICENSE

README.md

README.md

codecov.yaml

codecov.yaml

install.sh

install.sh

pyproject.toml

pyproject.toml

Repository files navigation

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:

pip install plasma-wiki

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

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.

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 index

wiki config — install Obsidian plugins and the git merge driver

Maintain indexes as files are added and removed:

wiki lint — validate structure and flag issues

wiki update — sync index links with the filesystem

Browse structure, search across content, and read entries:

wiki map — print an indented tree overview

wiki search — search content with regex

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

Once installed, run tools with uv run , or activate the environment first (source .venv/bin/activate).

Tests

Run the test suite:

pytest .

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

About

Indexed knowledge bases with command-line tools for agents.

Resources

Readme

License

Apache-2.0 license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy

Uh oh!

There was an error while loading. Please reload this page.

Activity

Custom properties

Stars

2 stars

Watchers

1 watching

Forks

0 forks

Report repository

Releases

1 tags

Packages 0

Uh oh!

There was an error while loading. Please reload this page.

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

Python 97.3%

Shell 2.7%