# Wiki

The wiki CLI and the node's two knowledge bases -- project wiki and memory.

- Repository: https://github.com/plasma-ai/fractal (789 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add plasma-ai/fractal --skill wiki -g -a claude-code -y`
Codex: `npx skills add plasma-ai/fractal --skill wiki -g -a codex -y`
Cursor: `npx skills add plasma-ai/fractal --skill wiki -g -a cursor -y`
Gemini CLI: `npx skills add plasma-ai/fractal --skill wiki -g -a gemini-cli -y`

## Description

The wiki CLI and the node's two knowledge bases -- project wiki and memory.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Wiki

A wiki is an indexed folder tree of `_index.md` files. A node works with two:

- **Project wiki** (`$WIKI_DIR`) -- shared across nodes; per-branch, reaching
  others only through merges (use `fractal radio` for live coordination). Holds
  architecture, conventions, and patterns; contribute durable project-wide
  knowledge here.
- **Memory** (`$MEMORY_DIR`) -- this node's private knowledge base. See the
  `memory` skill for how to maintain it.

Todo lists follow the same split: a private working checklist lives in memory; a
task list other nodes should see and track lives in the project wiki. Either way
it is living state -- current open items, pruned as they complete -- never an
append-only log.

Run `wiki --help` and `wiki <command> --help` for the CLI (init, update, lint,
map, search, read). Always pass `--path` (`$WIKI_DIR` or `$MEMORY_DIR`) -- a
bare command resolves the enclosing wiki by walking up, else `{cwd}/wiki`, which
from the node's cwd need not be the project wiki (`$WIKI_DIR`) and is never
memory, so an omitted `--path` silently targets the wrong wiki or errors. Run
`wiki update --path=<dir>` after adding, moving, or deleting pages;
`wiki lint --path=<dir>` validates structure.

## Editing discipline

Name pages and folders in ascii snake_case (`command_core`, not `command-core`)
-- both wikis enforce identifier-safe names (the project wiki's mirror the
source modules they document), so `wiki lint` rejects hyphens and spaces. The
rule allows `.`, so a non-markdown file keeps its extension (`controls.json`).

The rest: https://github.com/plasma-ai/fractal/blob/HEAD/fractal/_node/skills/wiki/SKILL.md