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).
37 lines
1.9 KiB
Markdown
37 lines
1.9 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
librefang hand run wiki
|
|
```
|