How zl0802/llm-wiki works
llm-wiki is a local-first knowledge-base product with a mature agent/Skill workflow and a developing web workbench; both are documented as using the same knowledge-base format and graph engine. The workbench’s user path is selecting or creating a knowledge base, searching and reading pages, then chatting or batch-digesting material, with retrieved context and generated artifacts tied to that knowledge base. The graph is a shared visualization capability. Sampled files support the UI/API boundary, retrieval, graph rendering, and rename scan; broader workflow links rely on README capabilities and listed module paths, not inspected implementations.
Main entry points: App.tsx Workbench UI · app.ts HTTP app · GraphPanel.tsx Graph panel · retrieval.ts Context retrieval
Components 20
Workbench
- Workbench UI
workbench/web/src/App.tsx - Page search
workbench/web/src/components/SearchPanel.tsx - API client
workbench/web/src/lib/api/client.ts - HTTP app
workbench/server/src/app.ts
Knowledge workflows
- Knowledge base service
workbench/server/src/knowledge-bases.ts - Page service
workbench/server/src/pages.ts - Context retrieval
workbench/server/src/retrieval.ts - Agent conversation
workbench/server/src/agent.ts - Batch digestion
workbench/server/src/digest/batch.ts - Wiki files
Graph experience
- Graph panel
workbench/web/src/components/GraphPanel.tsx - Graph routes
workbench/server/src/routes/graph.ts - Safe graph rename
workbench/server/src/graph-rename-preview.ts - Graph engine
packages/graph-engine/src/index.ts - Render pipeline
packages/graph-engine/src/render/render-pipeline.ts - Graph interaction
packages/graph-engine/src/render/controller.ts - Offline graph reader
packages/graph-engine/src/render/offline-reader.ts
Shared contracts
- Workbench contracts
packages/workbench-contracts/src/index.ts
Other components
- Workbench user
- Model provider
Connections 26
- Workbench user → Workbench UI: uses
- Workbench UI → Page search: opens
- Workbench UI → API client: requests
- Page search → Workbench UI: selects pages
- API client → HTTP app: sends requests
- HTTP app → Workbench contracts: validates envelopes
- Workbench UI → Workbench contracts: uses schemas
- HTTP app → Knowledge base service: dispatches
- HTTP app → Page service: dispatches
- HTTP app → Graph routes: dispatches
- Workbench UI → Knowledge base service: creates or selects
- Workbench UI → Batch digestion: starts batch
- Workbench UI → Agent conversation: sends conversation
- Agent conversation → Context retrieval: retrieves context
- Context retrieval → Page service: loads page cache
- Context retrieval → Wiki files: reads pages
- Agent conversation → Model provider: requests generation
- Batch digestion → Wiki files: processes knowledge
- Graph panel → Graph routes: loads graph
- Graph routes → Wiki files: reads graph data
- Graph panel → Graph engine: renders through
- Graph engine → Render pipeline: prepares rendering
- Render pipeline → Graph interaction: binds interactions
- Workbench user → Offline graph reader: browses offline
- Graph panel → Safe graph rename: requests preview
- Safe graph rename → Wiki files: scans and reads