wiki-spaces — a wiki for ai agents — the whole spec is one heading
2026·05 · active · python · markdown
the premise
ai coding agents accumulate knowledge and then lose it when the session ends. wiki-spaces gives them a place to keep it: a wiki where the llm is both the writer and the reader, and a human rarely opens the files at all.
the entire navigation contract: a wiki is a folder with an index.md that contains a `## spaces` heading. that's it. everything else — frontmatter, tags, logging — is opt-in.
spaces all the way down
a space is a folder with index.md + `## spaces`. a wiki is just the space at the top. embed your wiki inside mine and it becomes a space of mine — the model is closed under composition, which is what lets agents mount, share and nest knowledge bases without a registry.
trust scope follows the same shape: reads cross owned spaces freely; anything external — shared mounts, foreign submodules, escaping symlinks — needs explicit opt-in.
shipped, not specced
the spec ships as three self-contained skills — search, update, tend — each bundling its own stdlib ws.py, plus a plugin per harness: claude code, codex, github copilot, and opencode. two deterministic hooks orient every session: a "this project has a space in your wiki" line at start, a capture footnote after turns.
v3.0.0 deleted the python cli, the installer and the pypi package — the skills are the product now. 153 commits; the repo is itself a wiki-spaces wiki — its own canonical example.
facts
status: active · v3.0.0
spec floor: index.md + ## spaces
ships with: 3 skills · 4 harness plugins · 2 hooks
commits: 153
license: MIT
links
github
← anfreire.dev · the interactive version needs javascript