Wiki CLI

# Wiki CLI

[![PyPI version](https://badge.fury.io/py/wazootech-wiki.svg)](https://pypi.org/project/wazootech-wiki/)
[![npm version](https://img.shields.io/npm/v/wazootech-wiki)](https://www.npmjs.com/package/wazootech-wiki)
[![CI Status](https://github.com/wazootech/wiki/actions/workflows/ci.yml/badge.svg)](https://github.com/wazootech/wiki/actions)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![skills.sh](https://skills.sh/b/wazootech/wiki)](https://skills.sh/wazootech/wiki)

**Wiki CLI** is a command-line tool for Markdown wikis. You keep writing in Obsidian, VS Code, or any editor — the CLI validates your documents, runs queries against them, and builds static sites. Drop a `wiki.yaml` in your folder and you're set.

Repository: [github.com/wazootech/wiki](https://github.com/wazootech/wiki). CLI command: `wiki`. Install via [pip](https://pypi.org/project/wazootech-wiki/) or [npm](https://www.npmjs.com/package/wazootech-wiki).

Starter templates: [wiki-templates](https://github.com/wazootech/wiki-templates) (monorepo with all starter templates). See [Wiki CLI templates](docs/wiki/wiki.md#ecosystem-templates).

## Use cases and integrations

Wiki CLI is **interop-first**: it runs beside your existing wiki without owning the editor.

- **Obsidian & PKM** — Validate links and run queries inside your personal wiki. See [Obsidian integration](docs/wiki/Obsidian_Integration.md).
- **Static Documentation & Wikis** — Auto-generate styled HTML documentation pages, tables of contents, and sidebar infoboxes for publishing to GitHub Pages or static hosts.
- **LLM Wikis & Agent Memory** — Validate and query machine-generated Markdown databases. See [LLM Wiki](docs/wiki/LLM_Wiki.md).
- **Adoption path** — `wiki init` → `wiki check` → `wiki serve` (add `lint`, `query`, and `build` as you need them).

### Distinguishing Wiki CLI from Farzapedia

While inspired by personal digital gardens like **Farzapedia** (a subjective, first-person memory wiki optimized for a single agent), **Wiki CLI** is a general-purpose, multi-player toolchain:

- **Farzapedia** is a specific *content wiki* containing diary entries, notes, and messages.
- **Wiki CLI** is a *utility* for *any* wiki. It validates structure, runs queries, and builds static websites from a folder of Markdown files.

Adoption path: [Wiki CLI](docs/wiki/wiki.md) in the docs wiki.

## Key features

Three capabilities, one toolchain:

| Capability       | Commands                                                    | What you get                                                                    |
| ---------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------- |
| **Trust**        | [`check`](#check), [`lint`](#lint), [`fmt`](#fmt)           | Integrity checks (SHACL, JSON Schema), wiki conventions, automated formatting   |
| **Intelligence** | [`query`](#query), [`render`](#render), [`export`](#export) | Semantic queries (SPARQL), live inline tables, data exports (JSON-LD, Turtle)   |
| **Publish**      | [`build`](#build), [`serve`](#serve), [`link`](#link)       | Static HTML with infoboxes and metadata viewer, local preview, wikilink hygiene |

Also: [`init`](#init) scaffolds `wiki.yaml`; `wiki query --pretty` renders Rich tables in the terminal; YAML and JSON frontmatter feed into the same queryable model; per-page layouts via `wazoo:layout`.

## Agent skills

Wiki CLI ships three agent skills for coding assistants (Claude Code, Cursor,
OpenCode, Gemini). They are not thin wrappers — they encode opinionated
best practices that apply to any wiki or docs repo:

- **[wiki](skills/wiki/SKILL.md)** — the consolidated operational skill.
  Routes to install, scaffold, audit, or deploy workflows. Encodes the
  "silence is golden" philosophy (exit 0 on success) and deterministic
  verification scripts instead of agent reasoning about whether things look
  right.
- **[wiki-sync](skills/wiki-sync/SKILL.md)** — Git-anchored delta sync for
  code wikis. Treats the last-synced commit as an anchor and diffs forward,
  editing only the pages the diff demands. Defaults to drift-free docs (no
  line numbers, no machine-specific measurements) with an opt-in `detail_level`
  directive. Works on any `docs/` folder, not just this repo.
- **[wiki-feedback](skills/wiki-feedback/SKILL.md)** — structured feedback on
  integration and template proposals. Enforces a quality bar for new ecosystem
  contributions.

```bash
npx skills add wazootech/wiki@wiki -g -y
npx skills add wazootech/wiki@wiki-sync -g -y
npx skills add wazootech/wiki@wiki-feedback -g -y
```

The skills follow the same convention as the CLI: deterministic scripts
(`verify.sh`, `audit.sh`) for anything that can be checked, agent reasoning
only for decisions that require judgment.

## Templates

All templates live in the [wiki-templates](https://github.com/wazootech/wiki-templates) monorepo. Templa

... (truncated)