release: v1.2.0 — community-ready, full docs, PDF guide

Critical fixes: - marketplace.json: fix version 1.0.0→1.2.0, fix email to ***REMOVED*** - main.canvas: remove 5 broken file references (gitignored files) - community-plugins.json: deduplicate from 6→4 canonical entries Vault onboarding: - wiki/getting-started.md: new onboarding page inside the vault - wiki/index.md: populate Entities, Sources, Questions, Comparisons sections - wiki/meta/dashboard.md: fix Dataview queries (was referencing non-existent fields) - welcome.canvas: add CTA node pointing to getting-started - CLAUDE.md: replace placeholder text with actual vault description Docs: - README.md: complete Plugins section (pre-installed + recommended), CSS Snippets section, Banner usage section, file structure updated - bin/setup-vault.sh: expanded success message listing all plugins and CSS snippets - docs/install-guide.md + docs/install-guide.pdf: printable community install guide Version: 1.1.0 → 1.2.0 Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 14:20:23 +03:00
parent 5632763da6
commit c8c27141d7
13 changed files with 434 additions and 42 deletions
--- 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"
--- 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",
--- 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"
+  "obsidian-banners",
+  "calendar",
+  "thino"
 ]
--- 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

--- 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
--- 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"
--- a/docs/install-guide.md
+++ 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*
--- a/docs/install-guide.pdf
+++ b/docs/install-guide.pdf
--- 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":[]
 }
--- 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"},
--- a/wiki/getting-started.md
+++ 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.*
--- 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

+<!-- Source pages are created automatically by ingest. Add your first source: "ingest [filename]" -->

 ---

 ## Questions

-<!-- Add question entries here after queries or /save -->
+- [[How does the LLM Wiki pattern work]] — how the pattern works and why it outperforms RAG at human scale (status: developing)

 ---

 ## Comparisons

-<!-- Add comparison entries here -->
+- [[Wiki vs RAG]] — when to use a wiki knowledge base versus RAG; verdict: wiki wins at <1000 pages

 ---

--- 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
 ```