wiki-spaces 0.3.0

Minimal nestable wiki — a folder + index.md, for any use case (notes, research, recipes, writing, team docs). Spec, conventions catalog, and reference skills.

wiki-spaces

A minimal nestable wiki — a folder with index.md, for any use case. Research, recipes, code notes, writing, team docs, a personal life wiki — your shape, your call.

Markdown flavor is Obsidian — wikilinks, frontmatter, callouts, embeds, comments, Bases. One dialect across the spec, the skills, and the tools.

Start

mkdir -p ~/Wiki && echo "# My Wiki" > ~/Wiki/index.md

That's a complete wiki. Add files, folders, anything. The whole spec is one page: AGENTS.md.

Optional tooling

For AI agents to find and act on your wiki, install the helper:

uvx wiki-spaces install                  # link skills into detected AI harnesses
uvx wiki-spaces init ~/Wiki              # scaffold + register as default target
uvx wiki-spaces doctor --no-net          # verify

Or pip install wiki-spaces (or uv tool install wiki-spaces) and drop the uvx prefix.

Also available:

uvx wiki-spaces space add projects/foo   # create a space + register it
uvx wiki-spaces space audit              # report ## Spaces drift

Let an AI agent do the setup

Paste this to your agent:

Install and set up wiki-spaces for me by following the instructions here:
https://raw.githubusercontent.com/anfreire/wiki-spaces/main/references/SETUP.md

The agent picks tailored defaults, scaffolds, links the skills into your harness, and writes the config.

What you get

Three reference skills your AI agent uses to work with the wiki:

• wiki-search — find content
• wiki-update — capture / save / sync
• wiki-tend — audit, normalize tags, cross-link

For Cursor / Windsurf / Copilot / Aider (no skills concept), see references/HARNESS_INTEGRATION.md.

Learn more

• AGENTS.md — the spec, one page
• CONVENTIONS.md — opt-in conventions catalog
• references/EXAMPLES.md — topology examples per use case
• references/MOUNT.md — mount external spaces into your wiki

Dependencies

Python >=3.11. uv recommended (handles Python provisioning). git optional.

Prior art

• Andrej Karpathy's LLM Wiki gist
• Ar9av/obsidian-wiki — broader framework wiki-spaces extracts from
• kepano — vendored obsidian-markdown and obsidian-bases skills

License

MIT. See LICENSE.