Overview & Core Concepts

NutEgg is a local-first system designed to bridge the gap between passive web browsing and active knowledge curation in Obsidian.

The Metaphor

NutEgg structures your information flow using a simple three-part metaphor:

🌰 The Nut (Raw Capture): The raw web page, tweet thread, or YouTube transcript extracted from the browser. Nuts are archived untouched with full metadata into nutegg/_raw/ in your vault.
🥚 The Egg (Knowledge Tree): A living, structured markdown note in your vault representing a domain of knowledge (e.g., ai_architecture.md, invest_strategy.md).
🐣 The Hatch (Synthesis & Delta): When content is analyzed, the AI matches it against your eggs, identifies what is novel compared to what is already documented, and weaves new insights into your egg.

💡 Why NutEgg Exists

Most web clippers dump raw articles into your vault, creating an unorganized graveyard of unread bookmarks. NutEgg checks novelty against your existing knowledge tree upfront, so you immediately know if an article is worth your time or if it's just repeating concepts you already know.

System Architecture

NutEgg consists of two decoupled components that communicate locally:

Chrome Extension: Lives in Chrome's side panel. Interacts with the active tab, extracts text and video transcripts, and displays AI summaries and chapter maps.
Obsidian Plugin: Runs a lightweight HTTP server on 127.0.0.1:27123. Connects to your chosen AI provider using your own API key, reads your vault's _index.md, and saves files directly to disk.

Chrome Extension (Side Panel)
         │
         │  HTTP /analyze + /confirm (127.0.0.1:27123)
         ▼
Obsidian Plugin (Local Server)
         ├── Evaluates against vault/nutegg/_index.md
         ├── Queries AI Provider (Gemini / Claude / OpenAI / etc.)
         └── Writes to vault/nutegg/_raw/ and vault/nutegg/<egg>.md

Quick Start Roadmap

Install and configure the Obsidian Plugin with your AI API key.
Install the Chrome Extension.
Define your first knowledge topics in _index.md and start hatching!