agentandClaude
677a8dde4f
Fork of DanielCheer/obsidian-web-viewer (MIT, 2026-04) with Lukas' first additions for the Hermes Wiki workflow. Additive customization layer (vault-custom.js) — keeps upstream-merge trivial via a one-line script tag in vault.html. Features added: 1. Current-page highlighting in 3D Graph — current node gold+glow, connected nodes light-blue, others dim to 20% opacity 2. Click-to-navigate on graph — Three.js raycaster triggers file load 3. Responsive layout — graph collapses below 1024px, tree below 768px 4. URL-based deep-linking via ?file=<path> query param 5. Server-side ?file= support in /api/vault/file/ endpoint Modified files: - server.py: +7 lines (Lukas-add: ?file= query param parsing) - vault.html: +1 line (script tag for vault-custom.js) New files: - vault-custom.js: 11KB, all customizations in one place under HermesCustom namespace - README.md: fork intro, quick start, customization guide - CHANGELOG.md: Lukas-additions tracking - docs/ARCHITECTURE.md: design rationale - docs/CUSTOMIZATIONS.md: feature spec - .gitignore: standard 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
98 lines
3.6 KiB
Markdown
98 lines
3.6 KiB
Markdown
# Hermes Wiki Viewer
|
|
|
|
A customizable Obsidian-vault viewer with 3D Graph visualization, current-page highlighting, and responsive layout. Designed specifically for Lukas Huber's [Hermes Wiki](https://github.com/NousResearch/hermes-agent) workflow.
|
|
|
|
**This is a side-project fork of [DanielCheer/obsidian-web-viewer](https://github.com/DanielCheer/obsidian-web-viewer)** (MIT, 2026-04) with customizations layered on top via an additive `vault-custom.js`. Upstream patches merge cleanly because we touch exactly one line of `vault.html`.
|
|
|
|
## Features (in addition to upstream)
|
|
|
|
- **Current-page highlighting in 3D Graph** — the node representing the open file gets a brighter material and a glow outline; connected nodes (via `[[wikilinks]]`) are also highlighted; unrelated nodes dim to 20% opacity
|
|
- **Click-to-navigate on 3D Graph** — Three.js raycaster triggers file navigation on node click
|
|
- **Responsive layout** — graph collapses to a bottom panel below 1024px viewport; tree collapses to hamburger menu below 768px
|
|
- **Backlinks panel** (planned) — see CHANGELOG.md
|
|
|
|
## Features (from upstream, unchanged)
|
|
|
|
- File tree sidebar (collapsible folder tree)
|
|
- Markdown rendering with code blocks, tables, blockquotes, images
|
|
- Wikilink navigation (`[[links]]` click-to-traverse)
|
|
- YAML frontmatter rendered as styled card
|
|
- Full-text search by note name and content with snippets
|
|
- 3D graph visualization (Three.js) showing note connections
|
|
- Catppuccin-inspired dark theme
|
|
- Zero client-side setup — anyone with the URL can browse
|
|
|
|
## Architecture
|
|
|
|
See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for the design rationale (why `vault-custom.js`, why the minimal `vault.html` patch, why we don't fork aggressively).
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# Clone
|
|
git clone https://github.com/LukasHuber/hermes-wiki-viewer.git
|
|
cd hermes-wiki-viewer
|
|
|
|
# Optional: PyYAML for frontmatter
|
|
pip install -r requirements.txt
|
|
|
|
# Point to your vault
|
|
python3 server.py --vault /path/to/your/vault --host 127.0.0.1 --port 8765
|
|
|
|
# Open http://localhost:8765
|
|
```
|
|
|
|
For Tailscale access (Lukas' typical setup), pair with `tailscale serve`:
|
|
|
|
```bash
|
|
tailscale serve --bg --https=443 http://127.0.0.1:8765
|
|
# Access via https://<hostname>.<tailnet>.ts.net/
|
|
```
|
|
|
|
## Customization
|
|
|
|
`vault-custom.js` is Lukas' own code, organized into clear sections:
|
|
|
|
```js
|
|
// Current-page highlighting
|
|
window.HermesCustom = window.HermesCustom || {};
|
|
HermesCustom.highlightCurrentNode = function() { ... };
|
|
|
|
// Graph click-to-navigate
|
|
HermesCustom.setupGraphClickHandler = function() { ... };
|
|
|
|
// Responsive layout
|
|
HermesCustom.responsiveLayout = function() { ... };
|
|
```
|
|
|
|
To add a new customization, add a method to `HermesCustom` and call it from `HermesCustom.init()` at the bottom of the file.
|
|
|
|
## Updating from upstream
|
|
|
|
```bash
|
|
git remote add upstream https://github.com/DanielCheer/obsidian-web-viewer.git
|
|
git fetch upstream
|
|
git merge upstream/master
|
|
# Conflicts should only occur in vault.html — the one-line patch
|
|
```
|
|
|
|
If `vault.html` has been heavily modified upstream, manually re-apply the single patch:
|
|
|
|
```html
|
|
<!-- Add before </body>: -->
|
|
<script src="vault-custom.js"></script>
|
|
```
|
|
|
|
## License
|
|
|
|
MIT — same as upstream. See [LICENSE](LICENSE).
|
|
|
|
## Author
|
|
|
|
Lukas Huber — see [Personal-Profile](https://github.com/LukasHuber) for context.
|
|
This fork exists to make the agent-wiki viewing experience fit Lukas' specific needs (3D graph focus, responsive layout for mobile reading, current-page highlighting for fast cross-page navigation).
|
|
|
|
---
|
|
|
|
Upstream: [DanielCheer/obsidian-web-viewer](https://github.com/DanielCheer/obsidian-web-viewer) © 2026 Daniel Cheer
|
|
Hermes Wiki Viewer fork © 2026 Lukas Huber |