LLM Wiki Agent

Personal knowledge wiki powered by Claude — schema, workflows, and one-command setup for your AI-driven second brain.

What is this?

LLM Wiki Agent turns your Obsidian vault (or any folder of notes) into a structured knowledge base maintained by Claude AI. You drop notes in, Claude organizes and synthesizes them.

You drop notes → Claude ingests & synthesizes → You query & learn

Quick Start

# Clone this repo
git clone https://github.com/fcwu/llm-wiki-agent.git

# One-command setup (creates your wiki at ~/my-wiki)
cd llm-wiki-agent
./setup.sh ~/my-wiki

# Open Claude Code in your new wiki
cd ~/my-wiki
claude

Then say ingest to start your first knowledge extraction.

What's Included

File	Purpose
CLAUDE.md	Core schema — tells Claude how to behave as your wiki agent
setup.sh	One-command bootstrap for a new wiki environment
.gitignore	Git ignore rules (excludes private/, macOS artifacts, Obsidian cache)
docs/getting-started.md	Full usage guide

Workflow

drop/     ← throw anything in here (articles, notes, ideas)
   ↓  triage
raw/      ← organized source material
   ↓  ingest
wiki/     ← AI-generated structured knowledge pages
   ↓  query
You       ← ask questions, get cited answers

Key Commands (in Claude Code)

Command	Action
triage	Sort drop/ → raw/
ingest	Extract raw/ → wiki/
ingest raw/tech/foo.md	Ingest a specific file
add todo raw/tech/foo.md	Add to reading list
lint wiki	Health check

Private Data

Files in private/ are always gitignored — safe for credentials, drafts with sensitive info, or anything you want Claude to see but never commit.

Viewing the Wiki with Obsidian

The wiki pages use [[wikilinks]] — they render perfectly in Obsidian, a free Markdown editor that gives you:

• Clickable [[wiki/entities/...]] cross-references
• Graph view to visualize knowledge connections
• Search across all notes instantly

Setup: Open Obsidian → "Open folder as vault" → select your wiki directory (e.g. ~/my-wiki).

Obsidian is optional but strongly recommended for browsing and navigating the wiki.

Requirements

Tool	Required	Purpose
git	Yes	Version control
Claude Code	Yes	AI engine
Obsidian	Recommended	Browse & navigate wiki

License

MIT