"Too lazy to file it yourself? I got you." An intelligent, agent-driven web clipping ecosystem that leverages the Hermes Agent to autonomously organize, research, and refine your knowledge directly into your Obsidian vault.
Hermes Clipper is not just another bookmarking tool. It's a decentralized suite designed to turn the friction of web-clipping into a Contextual Nutrient System for your AI Agent. Instead of hoarding links in a digital graveyard, Hermes Clipper feeds your research directly to your "Second Brain," allowing the Hermes Agent to categorize, cross-link, and synthesize your knowledge in real-time.
- Zero Friction: One-click from your browser, handled by an agent.
- Agent-First: Stop picking folders. Let Hermes decide where it belongs based on your vault's existing context.
- Token Sovereignty 2.0: Deeply optimized for LLM efficiency.
- Smart Duplicate Detection: Local
grepsieve prevents redundant Agent research. - Vault Structural Index: Auto-generated folder map eliminates expensive recursive listings.
- Linguistic Compression: Built-in Caveman Mode support to slash LLM costs by ~75%.
- Smart Duplicate Detection: Local
- Local Sovereignty: Your data stays in your vault. Secure bridge with API key protection.
Hermes Clipper is composed of five modular components:
- 🧠 The Brain (Skill): Optimized procedural logic for Hermes Agent. Now features Head Extraction (~4k chars) for categorization efficiency.
- 📡 The Bridge (FastAPI): A secure local gateway connecting browsers and plugins to the Agent.
- 🛰️ The Scout (Extension): A sleek Chrome/Firefox extension for 1-click capture.
- 🔨 The Hand (CLI): A powerful standalone tool featuring a smart setup wizard that auto-provisions your Agent's memory.
- 🏡 The Garden (Plugin): An Obsidian ribbon interface for synthesis and status monitoring.
- Hermes Agent installed and configured.
- Python 3.8+
- Obsidian
-
Clone & Install CLI:
git clone https://github.com/frostmute/hermes-clipper.git cd hermes-clipper pip install -e .
-
Run Setup:
hermes-clip setup
Note: This generates your API Key, deploys the optimized Skill to Hermes, and builds your Vault Structural Index.
-
Install Browser Extension:
- Open Chrome/Firefox Extensions page.
- Enable "Developer Mode".
- "Load unpacked" and select the
extension/folder in this repo. - Configuration: Open the extension popup, right-click and select "Inspect", then run this in the console to save your API Key:
localStorage.setItem('hermes_api_key', 'YOUR_API_KEY_HERE');
-
Install Obsidian Plugin:
- Copy
obsidian-plugin/contents to<vault>/.obsidian/plugins/hermes-clipper/. - Enable in Obsidian settings and enter your API Key.
- Copy
Click the ⚡ Hermes icon in your browser to send the current page to your Clippings/ folder.
Click Agent Research in the extension. Hermes will research the topic, check your vault for context, and file it intelligently.
Click the 🧠 Brain icon in your Obsidian ribbon. Hermes will:
- Read the note.
- Fix formatting & typos.
- Cross-link to other notes.
- Move it from
Clippings/to a permanent home (e.g.,Research/).
Hermes Clipper uses a local-first bridge with:
- X-API-Key Header: All requests to the bridge require your unique key.
- CORS Restricted: Only listens to your browser extension and Obsidian app.
- Privacy: No cloud storage. No data leaks.
Every clip you save expands your Agent's context. By integrating clipping into your inherent workflow, you are building a sharper, more integrated AI that understands your research interests better with every note.
If Hermes Clipper has saved you a mountain of tokens or made your vault a better place, consider throwing some dollarbucks my way!
- Caveman Mode: Methodology by Julius Brussee.
- Hermes Agent: The foundational intelligence ecosystem.
Licensed under the MIT License.
⚡ Build a better garden. Grunt.