Adrian Rogala
f9c7456900
Squashed replay of the original 9-commit branch onto current main. The original branch was 30+ commits behind, forked from before the skills refactor (PR #42) and workflow template expansion (PR #36), so a standard rebase hit heavy add/add conflicts on workflows/*.toml that are unrelated to the wiki hand. This replay keeps only the final hands/wiki/ tree state, which is the actual intent of the PR (the author iterated several times on the same files; squashing matches that). Implements the "LLM Wiki" pattern (Andrej Karpathy) for building a personal, Obsidian-compatible knowledge base. Instead of on-the-fly RAG, the wiki hand incrementally maintains a Markdown vault: hands/wiki/ ├── HAND.toml # hand manifest + [agents.*] sections ├── README.md # user-facing docs ├── SKILL-main.md # Librarian (coordinator) routing + FS ops ├── SKILL-ingestor.md # Source extraction + [[wikilink]] writing ├── SKILL-analyst.md # Synthesis with provenance citations └── SKILL-linter.md # Broken link / orphan / contradiction audit Closes librefang/librefang-registry#44 (via replay, not merge).
Wiki Hand
Autonomous personal knowledge base agent -- builds and maintains an Obsidian-compatible wiki from raw sources. It extracts entities, concepts, and claims with strict provenance tracking, cross-references everything, and performs periodic health checks.
Configuration
| Field | Value |
|---|---|
| Category | knowledge |
| Agent | librarian |
| Routing | wiki, knowledge base, ingest source, ingest deep, deep ingest, crawl, wiki query, wiki lint |
Integrations
- Git -- Required for version control. Every operation (ingest, query, lint, maintain) is automatically committed to your vault history.
- qmd -- (Optional) A local hybrid search engine. Recommended for wikis scaling beyond 200 pages.
Settings
- Wiki Vault Path -- Directory where your wiki files will be stored (default:
./wiki) - File-Back Mode -- How to handle saving generated syntheses (
auto,ask,never) - Search Backend -- The search engine to use for queries (
index,qmd) - Wiki Content Language -- Target language for all generated content in the wiki (default:
en)
Features
- Ingestion: Give the agent raw sources (markdown, text, HTML, PDF via terminal) and it will extract factual claims, identify entities, and build connected concept pages.
- Deep Ingestion (
ingest-deep): Provide a starting URL, and the agent will intelligently crawl the main page along with up to 5 of its most substantive sub-pages to build a comprehensive knowledge tree in one go. - Synthesized Queries: Ask questions across your entire knowledge base. The agent provides answers backed by
[[wikilink]]citations, effectively compiling its response from your collected literature. - Linting & Maintenance: The agent can periodically scan the wiki to merge duplicate entities, fix broken links, identify contradictions, and point out orphan pages.
Usage
librefang hand run wiki