diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index ff2964b..1af028c 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -2,11 +2,11 @@ "name": "cosmic-brain-marketplace", "owner": { "name": "AgriciDaniel", - "email": "github@agricidaniel" + "email": "***REMOVED***" }, "metadata": { "description": "cosmic-brain — Claude + Obsidian knowledge companion by AgriciDaniel", - "version": "1.0.0" + "version": "1.2.0" }, "plugins": [ { @@ -17,7 +17,7 @@ "ref": "main" }, "description": "Claude + Obsidian knowledge companion. Sets up a persistent, compounding wiki vault. Covers memory management, session notetaking, knowledge organization, and agent context across projects.", - "version": "1.0.0", + "version": "1.2.0", "author": { "name": "AgriciDaniel", "url": "https://github.com/AgriciDaniel" diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index ea19c2f..b4e3fb6 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "cosmic-brain", - "version": "1.1.0", + "version": "1.2.0", "description": "Claude + Obsidian knowledge companion. Sets up a persistent, compounding wiki vault. Covers memory management, session notetaking, knowledge organization, and agent context across projects. Based on Andrej Karpathy's LLM Wiki pattern.", "author": { "name": "AgriciDaniel", diff --git a/.obsidian/community-plugins.json b/.obsidian/community-plugins.json index 50b1eb6..c2f56a5 100644 --- a/.obsidian/community-plugins.json +++ b/.obsidian/community-plugins.json @@ -1,8 +1,6 @@ [ - "calendar", - "thino", - "calendar-beta", - "obsidian-memos", "obsidian-excalidraw-plugin", - "obsidian-banners" -] \ No newline at end of file + "obsidian-banners", + "calendar", + "thino" +] diff --git a/CLAUDE.md b/CLAUDE.md index 828f759..67cdd83 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -8,7 +8,7 @@ This folder is both a Claude Code plugin and an Obsidian vault. ## What This Vault Is For -[Fill this in when you first scaffold the vault. One sentence describing your purpose.] +This vault demonstrates the LLM Wiki pattern — a persistent, compounding knowledge base for Claude + Obsidian. Drop any source, ask any question, and the wiki grows richer with every session. ## Vault Structure diff --git a/README.md b/README.md index f0ea75d..079e8d9 100644 --- a/README.md +++ b/README.md @@ -174,18 +174,53 @@ claude mcp add-json obsidian-vault '{ --- -## Recommended Plugins +## Plugins (pre-installed) -Install via Obsidian > Settings > Community Plugins: +These ship with the vault — enable them in **Settings → Community Plugins → enable**: -| Plugin | What it does | -|--------|-------------| -| Dataview | Powers the dashboard queries | -| Templater | Auto-populates frontmatter from templates | -| Obsidian Git | Auto-commits every 15 minutes | -| Minimal Theme | Best dark theme for this setup | +| Plugin | Purpose | Notes | +|--------|---------|-------| +| **Calendar** | Right-sidebar calendar with word count + task dots | Pre-installed | +| **Thino** | Quick memo capture panel | Pre-installed | +| **Excalidraw** | Freehand drawing canvas, annotate images | Pre-installed* | +| **Banners** | Notion-style header image via `banner:` frontmatter | Pre-installed | -Also install the **Obsidian Web Clipper** browser extension. It sends web pages to `.raw/` in one click. +\* Excalidraw `main.js` (8MB) is downloaded automatically by `setup-vault.sh`. It is not tracked in git. + +Also install from **Community Plugins** (not pre-installed): + +| Plugin | Purpose | +|--------|---------| +| **Dataview** | Powers the dashboard Dataview queries | +| **Templater** | Auto-fills frontmatter from `_templates/` | +| **Obsidian Git** | Auto-commits vault every 15 minutes | + +Also install the **[Obsidian Web Clipper](https://obsidian.md/clipper)** browser extension — sends web pages to `.raw/` in one click. + +--- + +## CSS Snippets (auto-enabled by setup-vault.sh) + +Three snippets ship with the vault and are enabled automatically: + +| Snippet | Effect | +|---------|--------| +| `vault-colors` | Color-codes `wiki/` folders by type in the file explorer (blue = concepts, green = sources, purple = entities) | +| `ITS-Dataview-Cards` | Turns Dataview `TABLE` queries into visual card grids — use ` ```dataviewjs ` with `.cards` class | +| `ITS-Image-Adjustments` | Fine-grained image sizing in notes — append `\|100` to any image embed | + +--- + +## Banner Plugin + +Add to any wiki page frontmatter: + +```yaml +banner: "_attachments/images/your-image.png" +banner_icon: "🧠" +``` + +The page renders a full-width header image in Obsidian. Works great for hub pages and overviews. --- @@ -221,6 +256,8 @@ cosmic-brain/ ├── _templates/ # Obsidian Templater templates ├── wiki/ │ ├── Wiki Map.canvas # visual hub — central graph node +│ ├── canvases/ # welcome.canvas + main.canvas (visual demos) +│ ├── getting-started.md # onboarding walkthrough (inside the vault) │ ├── concepts/ # seeded: LLM Wiki Pattern, Hot Cache, Compounding Knowledge │ ├── entities/ # seeded: Andrej Karpathy │ ├── sources/ # seeded: Nate Herk LLM Wiki Transcript diff --git a/bin/setup-vault.sh b/bin/setup-vault.sh index 30df995..0776fe0 100755 --- a/bin/setup-vault.sh +++ b/bin/setup-vault.sh @@ -93,10 +93,21 @@ echo "" echo "Next steps:" echo " 1. Open Obsidian" echo " 2. Manage Vaults → Open folder as vault → select: $VAULT" -echo " 3. Enable community plugins when prompted (Calendar + Thino are pre-installed)" +echo " 3. Enable community plugins when prompted (Calendar, Thino, Excalidraw, Banners are pre-installed)" echo " 4. Install: Dataview, Templater, Obsidian Git (Settings → Community Plugins)" echo " 5. Type /wiki in Claude Code to scaffold your knowledge base" echo "" +echo "Pre-installed plugins:" +echo " - Calendar (sidebar calendar with word count + task dots)" +echo " - Thino (quick memo capture)" +echo " - Excalidraw (freehand drawing + image annotation)" +echo " - Banners (add banner: to any note frontmatter for header images)" +echo "" +echo "CSS snippets enabled:" +echo " - vault-colors: color-codes wiki/ folders in file explorer" +echo " - ITS-Dataview-Cards: use \`\`\`dataviewjs with .cards for card grids" +echo " - ITS-Image-Adjustments: append |100 to image embeds for sizing" +echo "" echo "Views available:" echo " - Wiki Map canvas (wiki/Wiki Map.canvas) — knowledge graph" echo " - Design Ideas canvas (projects/visual-vault/design-ideas.canvas) — visual reference board" diff --git a/docs/install-guide.md b/docs/install-guide.md new file mode 100644 index 0000000..5b0f124 --- /dev/null +++ b/docs/install-guide.md @@ -0,0 +1,239 @@ +# cosmic-brain — Install Guide + +**Claude + Obsidian Knowledge Companion** +Version 1.2.0 · [github.com/AgriciDaniel/cosmic-brain](https://github.com/AgriciDaniel/cosmic-brain) + +--- + +## What is cosmic-brain? + +cosmic-brain is a Claude Code plugin + Obsidian vault that builds and maintains a persistent, compounding knowledge base. Every source you add gets processed into cross-referenced wiki pages. Every question you ask pulls from everything that has been read. Knowledge compounds like interest. + +Built on Andrej Karpathy's LLM Wiki pattern. + +--- + +## Prerequisites + +| Tool | How to get it | Notes | +|------|--------------|-------| +| **Claude Code** | `npm install -g @anthropic-ai/claude-code` | Free tier available | +| **Obsidian** | [obsidian.md](https://obsidian.md) | Free | +| **Git** | Pre-installed on most systems | For Option 1 | + +--- + +## Installation + +### Option 1 — Clone as vault (recommended) + +Full setup in under 2 minutes. + +```bash +git clone https://github.com/AgriciDaniel/cosmic-brain +cd cosmic-brain +bash bin/setup-vault.sh +``` + +Then in Obsidian: **Manage Vaults → Open folder as vault → select `cosmic-brain/`** + +Open Claude Code in the same folder and type `/wiki`. + +### Option 2 — Install as Claude Code plugin + +```bash +claude plugin install github:AgriciDaniel/cosmic-brain +``` + +In any Claude Code session: type `/wiki` — Claude walks you through vault setup. + +### Option 3 — Add to an existing vault + +Copy `WIKI.md` from this repo into your vault root. Then paste into Claude: + +``` +Read WIKI.md in this project. Then: +1. Check if Obsidian is installed. If not, install it. +2. Check if the Local REST API plugin is running on port 27124. +3. Configure the MCP server. +4. Ask me ONE question: "What is this vault for?" +Then scaffold the full wiki structure. +``` + +--- + +## First Steps + +### 1. Scaffold the vault + +Type `/wiki` in Claude Code. Claude will: +- Detect your vault mode (website, GitHub, business, personal, research, or book/course) +- Create the folder structure and core wiki pages +- Set up `wiki/index.md`, `wiki/hot.md`, `wiki/log.md`, and `wiki/overview.md` + +### 2. Drop your first source + +Put any document into `.raw/`: +- PDFs, markdown files, transcripts, articles, URLs + +Tell Claude: `ingest [filename]` + +Claude reads the source and creates 8–15 cross-referenced wiki pages. + +### 3. Ask questions + +``` +what do you know about [topic]? +``` + +Claude reads the hot cache, scans the index, drills into relevant pages, and gives a synthesized answer — citing specific wiki pages, not training data. + +--- + +## Commands Reference + +| Command | What Claude does | +|---------|-----------------| +| `/wiki` | Setup check, scaffold, or continue where you left off | +| `ingest [file]` | Read source, create 8–15 wiki pages, update index and log | +| `ingest all of these` | Batch process multiple sources, then cross-reference | +| `what do you know about X?` | Read index → relevant pages → synthesize answer | +| `/save` | File the current conversation as a wiki note | +| `/save [name]` | Save with a specific title | +| `/autoresearch [topic]` | Autonomous research loop: search, fetch, synthesize, file | +| `/canvas` | Open or create a visual canvas | +| `/canvas add image [path]` | Add an image to the canvas | +| `/canvas add text [content]` | Add a markdown text card | +| `/canvas add pdf [path]` | Add a PDF document | +| `/canvas add note [page]` | Pin a wiki page as a linked card | +| `lint the wiki` | Health check: orphans, dead links, gaps | +| `update hot cache` | Refresh `hot.md` with latest context summary | + +--- + +## Plugins (pre-installed) + +Enable in **Settings → Community Plugins**: + +| Plugin | Purpose | +|--------|---------| +| **Calendar** | Right-sidebar calendar with word count and task dots | +| **Thino** | Quick memo capture panel | +| **Excalidraw** | Freehand drawing, image annotation | +| **Banners** | Header images via `banner:` frontmatter | + +Also install from Community Plugins: + +| Plugin | Purpose | +|--------|---------| +| **Dataview** | Powers the dashboard queries | +| **Templater** | Auto-fills frontmatter from templates | +| **Obsidian Git** | Auto-commits vault every 15 minutes | + +--- + +## CSS Snippets + +Three snippets are auto-enabled by `setup-vault.sh`: + +| Snippet | Effect | +|---------|--------| +| `vault-colors` | Color-codes wiki folders in the file explorer | +| `ITS-Dataview-Cards` | Turns Dataview queries into visual card grids | +| `ITS-Image-Adjustments` | Fine-grained image sizing — append `\|100` to embeds | + +--- + +## Six Wiki Modes + +| Mode | Use when | +|------|---------| +| **A: Website** | Sitemap, content audit, SEO wiki | +| **B: GitHub** | Codebase map, architecture wiki | +| **C: Business** | Project wiki, competitive intelligence | +| **D: Personal** | Second brain, goals, journal synthesis | +| **E: Research** | Papers, concepts, thesis | +| **F: Book/Course** | Chapter tracker, course notes | + +Modes can be combined. + +--- + +## MCP Setup (Optional) + +MCP lets Claude read and write vault notes directly without copy-paste. + +**Option A — REST API:** + +1. Install the **Local REST API** plugin in Obsidian +2. Copy your API key +3. Run: + +```bash +claude mcp add-json obsidian-vault '{ + "type": "stdio", + "command": "uvx", + "args": ["mcp-obsidian"], + "env": { + "OBSIDIAN_API_KEY": "your-key", + "OBSIDIAN_HOST": "127.0.0.1", + "OBSIDIAN_PORT": "27124", + "NODE_TLS_REJECT_UNAUTHORIZED": "0" + } +}' --scope user +``` + +**Option B — Filesystem (no plugin needed):** + +```bash +claude mcp add-json obsidian-vault '{ + "type": "stdio", + "command": "npx", + "args": ["-y", "@bitbonsai/mcpvault@latest", "/path/to/your/vault"] +}' --scope user +``` + +--- + +## Troubleshooting + +| Problem | Fix | +|---------|-----| +| `/wiki` says "not found" | Make sure `cosmic-brain` plugin is enabled: `claude plugin list` | +| Graph colors reset after closing Obsidian | Open Graph view → gear → Color groups → re-add once. Permanent after that. | +| Excalidraw not loading | Run `bash bin/setup-vault.sh` to download `main.js` (8MB, not in git) | +| Dashboard shows no results | Install the **Dataview** plugin from Community Plugins | +| Hot cache not loading at session start | Check hooks: `claude hooks list` — SessionStart hook should be present | + +--- + +## Cross-Project Power Move + +Point any Claude Code project at this vault. Add to that project's `CLAUDE.md`: + +```markdown +## Wiki Knowledge Base +Path: ~/path/to/cosmic-brain + +When you need context not in this project: +1. Read wiki/hot.md first (recent context cache) +2. If not enough, read wiki/index.md +3. If you need domain details, read the relevant wiki page + +Do NOT read the wiki for general coding questions. +``` + +Your executive assistant, coding projects, and content workflows all draw from the same knowledge base. + +--- + +## Support + +- **GitHub**: [github.com/AgriciDaniel/cosmic-brain](https://github.com/AgriciDaniel/cosmic-brain) +- **Issues**: [github.com/AgriciDaniel/cosmic-brain/issues](https://github.com/AgriciDaniel/cosmic-brain/issues) +- **Community**: [AI Marketing Hub on Skool](https://skool.com) + +--- + +*Built by [AgriciDaniel](https://github.com/AgriciDaniel) / AI Marketing Hub* +*Based on Andrej Karpathy's LLM Wiki pattern* diff --git a/docs/install-guide.pdf b/docs/install-guide.pdf new file mode 100644 index 0000000..aa911dd Binary files /dev/null and b/docs/install-guide.pdf differ diff --git a/wiki/canvases/main.canvas b/wiki/canvases/main.canvas index e3fd881..34eabdc 100644 --- a/wiki/canvases/main.canvas +++ b/wiki/canvases/main.canvas @@ -1,18 +1,13 @@ { "nodes":[ - {"id":"zone-wiki-pages-1744033999","type":"group","x":-400,"y":320,"width":1000,"height":840,"color":"2","label":"Wiki Pages"}, + {"id":"zone-wiki-pages-1744033999","type":"group","x":-400,"y":320,"width":1000,"height":320,"color":"2","label":"Wiki Pages"}, {"id":"zone-default","type":"group","x":-400,"y":-140,"width":800,"height":400,"color":"4","label":"General"}, - {"id":"title","type":"text","text":"# Visual Reference\n\nDrop images, PDFs, and notes here.","x":-400,"y":-300,"width":400,"height":120,"color":"6"}, {"id":"note-llm-wiki-1744033901","type":"file","file":"wiki/concepts/LLM Wiki Pattern.md","x":80,"y":-120,"width":300,"height":100}, {"id":"text-insight-1744033945","type":"text","text":"## Key insight\n\nKnowledge compounds like interest.\nEvery ingest enriches 8–15 pages.","x":80,"y":0,"width":300,"height":220,"color":"5"}, {"id":"img-logo-pro-1744033823","type":"file","file":"_attachments/images/skool-hub/logo-pro.png","x":-380,"y":-120,"width":419,"height":230}, {"id":"484d32f71e442aa0","type":"file","file":"Cosmic Brain Cover.png","x":-360,"y":360,"width":400,"height":206}, {"id":"a8f6d861b3c08664","type":"file","file":"Cosmic Brain Clean.gif","x":80,"y":360,"width":400,"height":206}, - {"id":"8ef901e71f8bb99a","type":"file","file":"Claude SEO Posts cover 1x1-compressed.gif","x":80,"y":620,"width":400,"height":400}, - {"id":"1b493d96e43535e2","type":"file","file":"Claude SEO Posts cover 1x1.gif","x":-360,"y":620,"width":400,"height":400}, - {"id":"40480d22fb607a70","type":"file","file":"PROMPT.md","x":140,"y":1200,"width":400,"height":400}, - {"id":"7b680dc65660903b","type":"file","file":"WIKI 1.md","x":-380,"y":1200,"width":400,"height":400}, - {"id":"6c17fb8ecb9af539","type":"file","file":"Obsidian vault with Claude Code - full integration and visual organization 1.md","x":-380,"y":1680,"width":920,"height":640} + {"id":"title","type":"text","text":"# Visual Reference\n\nDrop images, PDFs, and notes here.","x":-440,"y":-360,"width":400,"height":120,"color":"6"} ], "edges":[] } \ No newline at end of file diff --git a/wiki/canvases/welcome.canvas b/wiki/canvases/welcome.canvas index 0fd6621..64b781f 100644 --- a/wiki/canvases/welcome.canvas +++ b/wiki/canvases/welcome.canvas @@ -3,22 +3,24 @@ {"id":"zone-input","type":"group","x":-680,"y":-360,"width":560,"height":560,"color":"4","label":"1 · Drop Your Sources"}, {"id":"zone-output","type":"group","x":480,"y":-360,"width":560,"height":560,"color":"6","label":"3 · Your Brain (Vault) Grows"}, {"id":"zone-process","type":"group","x":-60,"y":-360,"width":480,"height":560,"color":"2","label":"2 · I Process Everything"}, - {"id":"text-drop-images","type":"text","text":"## 📸 Paste any image here\n\nHere you can paste any images and I will take care of the rest.","x":-660,"y":-340,"width":520,"height":110,"color":"4"}, {"id":"gif-workflow","type":"file","file":"wiki/meta/workflow-loop.gif","x":-40,"y":-340,"width":440,"height":440}, - {"id":"text-process","type":"text","text":"Reads sources → extracts entities & concepts → cross-references everything → files it all automatically.","x":-40,"y":110,"width":440,"height":80,"color":"2"}, {"id":"main-title","type":"text","text":"# 🧠 Cosmic Brain\n### Drop anything. I'll build your knowledge base.","x":-340,"y":-620,"width":840,"height":110}, {"id":"sub-title","type":"text","text":"Images · PDFs · Markdown · Transcripts · URLs — drag, drop, or paste. I handle the rest.","x":-340,"y":-500,"width":840,"height":54,"color":"5"}, + {"id":"text-drop-images","type":"text","text":"## 📸 Paste any image here\n\nHere you can paste any images and I will take care of the rest.","x":-660,"y":-340,"width":520,"height":110,"color":"4"}, {"id":"text-drop-pdf","type":"text","text":"## 📄 Or drop PDF & Markdown files\n\nJust easy drag & drop — I'll extract everything.","x":-660,"y":60,"width":520,"height":100,"color":"4"}, {"id":"72b304484d8afa75","type":"file","file":"Cosmic Brain Clean.gif","x":-668,"y":-216,"width":536,"height":276}, - {"id":"text-brain","type":"text","text":"## 🧠 I'll create a full map/brain for you\n\nEvery source compounds the knowledge base.","x":500,"y":-340,"width":520,"height":100,"color":"6"}, - {"id":"callout-1","type":"text","text":"💡 **8–15 wiki pages**\nper source ingested","x":-680,"y":440,"width":260,"height":80,"color":"4"}, - {"id":"callout-2","type":"text","text":"⚡ **Hot cache**\ninstant session context","x":-400,"y":440,"width":260,"height":80,"color":"2"}, {"id":"example-img-2","type":"file","file":"_attachments/images/skool-hub/hub-cover.png","x":-680,"y":280,"width":260,"height":134}, {"id":"example-img-3","type":"file","file":"_attachments/images/skool-hub/claude-blog-cover.png","x":-400,"y":267,"width":160,"height":160}, - {"id":"text-result","type":"text","text":"Cross-referenced. Searchable. Gets richer every session.","x":500,"y":200,"width":520,"height":50,"color":"6"}, + {"id":"text-process","type":"text","text":"Reads sources → extracts entities & concepts → cross-references everything → files it all automatically.","x":-40,"y":110,"width":440,"height":80,"color":"2"}, + {"id":"callout-1","type":"text","text":"💡 **8–15 wiki pages**\nper source ingested","x":-680,"y":440,"width":260,"height":80,"color":"4"}, + {"id":"callout-2","type":"text","text":"⚡ **Hot cache**\ninstant session context","x":-400,"y":440,"width":260,"height":80,"color":"2"}, {"id":"callout-3","type":"text","text":"🔍 **Query anything**\nyou've ever added","x":-120,"y":440,"width":260,"height":80,"color":"5"}, {"id":"callout-4","type":"text","text":"🕸️ **Visual map**\nFibonacci graph layout","x":160,"y":440,"width":260,"height":80,"color":"6"}, - {"id":"gif-graph","type":"file","file":"wiki/meta/wiki-graph-grow.gif","x":568,"y":-225,"width":385,"height":385} + {"id":"text-brain","type":"text","text":"## 🧠 I'll create a full map/brain for you\n\nEvery source compounds the knowledge base.","x":500,"y":-340,"width":520,"height":100,"color":"6"}, + {"id":"text-result","type":"text","text":"Cross-referenced. Searchable. Gets richer every session.","x":500,"y":200,"width":520,"height":50,"color":"6"}, + {"id":"gif-graph","type":"file","file":"wiki/meta/wiki-graph-grow.gif","x":568,"y":-225,"width":385,"height":385}, + {"id":"cta-start","type":"text","text":"## 👉 Start here\n\n1. Read [[getting-started]] for a quick walkthrough\n2. Run `/wiki` in Claude Code to scaffold your vault\n3. Drop your first source into `.raw/` and say `ingest [filename]`","x":-140,"y":267,"width":560,"height":140,"color":"5"}, + {"id":"025be16f290f1830","x":500,"y":315,"width":520,"height":293,"type":"file","file":"2026-04-07 14-19-00.mkv"} ], "edges":[ {"id":"arrow-1","fromNode":"zone-input","fromSide":"right","toNode":"zone-process","toSide":"left","color":"4","label":"ingest"}, diff --git a/wiki/getting-started.md b/wiki/getting-started.md new file mode 100644 index 0000000..220b643 --- /dev/null +++ b/wiki/getting-started.md @@ -0,0 +1,100 @@ +--- +type: meta +title: "Getting Started" +updated: 2026-04-07 +tags: + - meta + - onboarding +status: evergreen +related: + - "[[index]]" + - "[[overview]]" + - "[[LLM Wiki Pattern]]" + - "[[Wiki vs RAG]]" + - "[[Wiki Map]]" +--- + +# Getting Started with cosmic-brain + +Welcome. This vault is your compounding knowledge base — a persistent second brain built with Claude and Obsidian. + +Every source you add gets processed into 8–15 cross-referenced wiki pages. Every question you ask pulls from everything that's been ingested. Knowledge compounds like interest. + +--- + +## Three-Step Quick Start + +### 1. Drop a source + +Put any document into the `.raw/` folder: +- PDFs, markdown files, transcripts, articles +- Or paste a URL and ask Claude to fetch it + +### 2. Ingest it + +Tell Claude in any Claude Code session: + +``` +ingest [filename] +``` + +Claude reads the source, creates 8–15 wiki pages under `wiki/`, cross-references everything, and updates `wiki/index.md`, `wiki/log.md`, and `wiki/hot.md`. + +### 3. Ask questions + +``` +what do you know about [topic]? +``` + +Claude reads the hot cache, scans the index, drills into relevant pages, and gives you a synthesized answer — citing specific wiki pages, not training data. + +--- + +## How the Hot Cache Works + +`wiki/hot.md` is a ~500-word summary of recent vault context. It loads automatically at the start of every session (via the SessionStart hook). + +You don't need to recap. Claude starts every session knowing what you've been working on. + +Update it manually at any time: `update hot cache` + +--- + +## Your First Ingest — Walkthrough + +1. Create a file in `.raw/` — copy a transcript, paste an article, or save a PDF +2. Open Claude Code in this vault folder +3. Type: `ingest [your-filename]` +4. Watch the wiki grow — Claude will report which pages it created +5. Open `wiki/index.md` — you'll see the new pages listed +6. Open Graph View in Obsidian — a new cluster of connected nodes appears + +After 3–5 ingests, the graph starts to look like a real knowledge network. Cross-references emerge automatically. + +--- + +## Key Commands + +| You say | Claude does | +|---------|-------------| +| `ingest [file]` | Creates 8–15 wiki pages from a source | +| `what do you know about X?` | Queries the wiki, cites pages | +| `/save` | Files this conversation as a wiki note | +| `/autoresearch [topic]` | Searches the web, ingests results autonomously | +| `lint the wiki` | Health check — finds orphans, gaps, stale links | +| `update hot cache` | Refreshes the session context summary | + +--- + +## Navigate the Vault + +- **[[Wiki Map]]** — visual Fibonacci graph of all wiki pages +- **[[index]]** — master catalog, all pages by type +- **[[overview]]** — executive summary of vault contents +- **[[LLM Wiki Pattern]]** — the pattern this vault is built on +- **[[Wiki vs RAG]]** — why a wiki beats RAG at human scale +- **[[dashboard]]** — live Dataview queries (requires Dataview plugin) + +--- + +*Built on the [LLM Wiki pattern](https://github.com/karpathy) by Andrej Karpathy. Hot cache and cross-project patterns by Nate Herk.* diff --git a/wiki/index.md b/wiki/index.md index 7ba0b2b..0f41522 100644 --- a/wiki/index.md +++ b/wiki/index.md @@ -23,9 +23,9 @@ related: # Wiki Index -Last updated: 2026-04-07 | Total pages: 11 | Sources ingested: 1 +Last updated: 2026-04-07 | Total pages: 15 | Sources ingested: 1 -Navigation: [[overview]] | [[log]] | [[hot]] | [[dashboard]] | [[Wiki Map]] +Navigation: [[overview]] | [[log]] | [[hot]] | [[dashboard]] | [[Wiki Map]] | [[getting-started]] --- @@ -39,23 +39,25 @@ Navigation: [[overview]] | [[log]] | [[hot]] | [[dashboard]] | [[Wiki Map]] ## Entities +- [[Andrej Karpathy]] — AI researcher, creator of the LLM Wiki pattern, former Tesla AI director (status: developing) --- ## Sources + --- ## Questions - +- [[How does the LLM Wiki pattern work]] — how the pattern works and why it outperforms RAG at human scale (status: developing) --- ## Comparisons - +- [[Wiki vs RAG]] — when to use a wiki knowledge base versus RAG; verdict: wiki wins at <1000 pages --- diff --git a/wiki/meta/dashboard.md b/wiki/meta/dashboard.md index efe50b5..c9acb2e 100644 --- a/wiki/meta/dashboard.md +++ b/wiki/meta/dashboard.md @@ -49,13 +49,21 @@ LIST FROM "wiki/entities" WHERE !sources OR length(sources) = 0 ## Open Questions ```dataview -LIST FROM "wiki/questions" WHERE answer_quality = "draft" SORT created DESC +LIST FROM "wiki/questions" WHERE status = "developing" OR status = "seed" SORT updated DESC ``` --- -## Sources by Confidence +## Comparisons ```dataview -TABLE author, date_published, confidence FROM "wiki/sources" SORT confidence ASC +TABLE verdict FROM "wiki/comparisons" SORT updated DESC +``` + +--- + +## Sources + +```dataview +TABLE author, date_published, updated FROM "wiki/sources" WHERE type = "source" SORT updated DESC LIMIT 10 ```