git-wiki

A self-maintaining knowledge wiki that lives in your own git repo. Your agent ingests sources, writes the pages, keeps cross-references current, and answers from the wiki. On-device hybrid search. No server, no SaaS, no DB — local commits by default, optional GitHub publishing.

bash <(curl -sL https://raw.githubusercontent.com/rarce/git-wiki/main/install.sh)

Features

• Compounds over time — every ingested source and answered query enriches the wiki.
• Your repo is the store — versioned, portable, shareable locally or via GitHub, diffs as a change log. Zero hidden state to corrupt.
• On-device hybrid search — BM25 + vector + LLM rerank via [qmd][qmd]. No external API, no embeddings uploaded anywhere.
• No server, no SaaS — the only runtime is bash, git, qmd, and optionally gh for GitHub sync.
• Agent-Skills standard — works with Claude Code, Cursor, Codex, Copilot, or any [Agent-Skills-compatible agent][home].
• Lint for drift — stale dates, orphans, broken links, index drift, missing cross-references, and contradictions.

How it works

Three layers from the [Karpathy LLM-wiki pattern][gist]:

1. Raw sources (sources/) — articles, papers, notes. Immutable; the LLM reads but never rewrites them.
2. Wiki pages (pages/, people/, concepts/) — LLM-owned markdown; synthesis accumulates here.
3. Schema (CLAUDE.md + SKILL.md) — conventions and workflows the LLM follows.

Two navigation files:

• index.md — content catalog, grouped by category. Read first on every query.
• log.md — append-only chronological record, grep-friendly (## [YYYY-MM-DD] | ).

ingest                                        query
  │                                             │
  ▼                                             ▼
sources/ ──► wiki pages ──► index.md ──► answer with citations
                 ▲                  │
                 └───── qmd search ─┘

git-wiki vs classic RAG