Skip to content
Back to search

hermes-link-curator

Hermes profile pack for archiving and browsing curated links + web dashboard app

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dodo-reach--hermes-link-curator/badge.svg)](/listings/dodo-reach--hermes-link-curator)

HTML

<a href="/listings/dodo-reach--hermes-link-curator"><img src="/api/listings/dodo-reach--hermes-link-curator/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Send your Hermes agent a message like:

> *Install https://github.com/dodo-reach/hermes-link-curator — follow the AGENT_GUIDE.md.*

The agent will read `AGENT_GUIDE.md`, create a new profile, copy the pieces, and start the dashboard. You can then start archiving:

> *archive https://github.com/some/repo*

or use the dashboard at `http://localhost:8090`.

**Prefer the manual path?** Run `./install.sh` from this repo — it asks one question (profile name) and does the same thing.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 147 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Hermes Link Curator
  2. A **link curator profile pack** for [Hermes Agent](https://github.com/NousResearch/hermes-agent) — turn any Hermes agent into a librarian. Send a URL, get it archived, tagged, summarized, and browsable in a fast Obsidian-style dashboard.
  3. ## Dashboard preview
  4. [![Hermes Link Curator dashboard running on iPhone](assets/dashboard-preview.gif)](assets/dashboard-preview.mp4)
  5. The archive is just a local web app, so it works well on desktop and mobile: list view, calendar, search, tags, day pages, graph view, and JSON stats all read from the same markdown vault.
  6. ## What this is
  7. - **2 skills** (`obsidian` + `link-curator-dashboard`) — drop into any Hermes profile
  8. - **1 dashboard** — standalone FastAPI app, Obsidian-style web UI (port 8090)
  9. - **1 SOUL template** — gives the agent a "librarian" personality (archive, don't summarize)
  10. The agent receives links on Telegram, Discord, or anywhere else → fetches content → writes entries to a local markdown vault → the dashboard reads the vault and serves a search/tag/graph view.
  11. ## Requirements and platforms
  12. Hermes Link Curator is designed for Unix-like environments:
  13. - **macOS** — supported
  14. - **Linux** — supported
  15. - **Windows via WSL** — should work if Hermes works in your WSL environment
  16. - **Windows native** — not currently supported by the installer
  17. You need [Hermes Agent](https://github.com/NousResearch/hermes-agent), Python 3.10+, and a Bash-compatible shell. The dashboard itself is a standard FastAPI app, but the installer and profile paths assume `~/.hermes/...`.
  18. ## Install (30 seconds, agent-guided)
  19. Send your Hermes agent a message like:
  20. > *Install https://github.com/dodo-reach/hermes-link-curator — follow the AGENT_GUIDE.md.*
  21. The agent will read `AGENT_GUIDE.md`, create a new profile, copy the pieces, and start the dashboard. You can then start archiving:
  22. > *archive https://github.com/some/repo*
  23. or use the dashboard at `http://localhost:8090`.
  24. **Prefer the manual path?** Run `./install.sh` from this repo — it asks one question (profile name) and does the same thing.
  25. ## Where the dashboard lives
  26. The installer copies the web app into your Hermes profile and starts it from:
  27. ```bash
  28. ~/.hermes/profiles/<profile-name>/dashboard/
  29. ```
  30. By default it listens on:
  31. ```text
  32. http://localhost:8090
  33. ```
  34. That means it is exposed only on the machine running Hermes. The dashboard reads the vault at `~/.hermes/profiles/<profile-name>/vault/`, so every archived link appears there as markdown and in the web UI.
  35. You can change the port when installing, or later by running:
  36. ```bash
  37. cd ~/.hermes/profiles/<profile-name>/dashboard
  38. ./start.sh 8091
  39. ```
  40. The dashboard binds to `127.0.0.1` by default. To make it reachable from your iPhone on the same private network, start it with:
  41. ```bash
  42. cd ~/.hermes/profiles/<profile-name>/dashboard
  43. ARCHIVE_HOST=0.0.0.0 ./start.sh 8090
  44. ```
  45. Then open `http://<your-mac-ip>:8090` from Safari on iPhone.
  46. ## Use it like an iPhone app
  47. Once the dashboard is reachable from your iPhone:
  48. 1. Open the dashboard URL in Safari.
  49. 2. Tap the Share button.
  50. 3. Tap **Add to Home Screen**.
  51. 4. Name it `Archive` or `Hermes Links`.
  52. From then on, you can launch the archive from your Home Screen like a small private app.
  53. ## Access from anywhere with Tailscale
  54. For access outside your home network, use [Tailscale](https://tailscale.com/) instead of exposing the dashboard to the public internet:
  55. 1. Install Tailscale on the hardware running Hermes and on your iPhone.
  56. 2. Sign both devices into the same tailnet.
  57. 3. Start the dashboard with `ARCHIVE_HOST=0.0.0.0`.
  58. 4. On iPhone, open `http://<mac-tailscale-name>:8090` or `http://<mac-tailscale-ip>:8090`.
  59. 5. Add that page to the Home Screen from Safari.
  60. The dashboard does not include authentication, so keep it behind localhost, your LAN, or Tailscale. Do not publish it directly to the open internet.
  61. ## Repo layout
  62. ```
  63. hermes-link-curator/
  64. ├── README.md # you are here
  65. ├── AGENT_GUIDE.md # instructions for the agent
  66. ├── install.sh # self-service installer
  67. ├── SOUL.template.md # paste into your profile's SOUL.md
  68. ├── skill-obsidian/ # the save-link skill
  69. ├── skill-link-curator-dashboard/ # the dashboard maintenance skill
  70. └── dashboard/ # standalone FastAPI web app
  71. ```
  72. ## Architecture
  73. Everything lives under `~/.hermes/profiles/<profile-name>/`. Path auto-discovery — no env vars to set, no config files to edit:
  74. ```
  75. ~/.hermes/profiles/link-curator/
  76. ├── SOUL.md # personality + triggers
  77. ├── vault/ # the archive (auto-created on first save)
  78. │ ├── INDEX.md # master list, newest first
  79. │ └── YYYY-MM-DD.md # daily notes
  80. ├── skills/note-taking/
  81. │ ├── obsidian/ # the save workflow
  82. │ └── link-curator-dashboard/ # dashboard maintenance
  83. └── dashboard/ # the FastAPI web app
  84. ├── main.py
  85. ├── archive.py # vault parser
  86. ├── validate.py # integrity checker
  87. └── start.sh # launcher
  88. ```
  89. The dashboard reads the vault and exposes: list, calendar, search, tag pages, day pages, a D3 force-directed tag graph, and a JSON stats endpoint.
  90. ## Optional upgrades
  91. The base install gets you archiving. Two more steps are documented in `AGENT_GUIDE.md`:
  92. - **Fetch context from difficult links** — add a browser-based fetcher and the Playwright MCP server for sites that need JavaScript rendering or an existing browser session
  93. - **Send links from messaging apps** — add a Telegram/Discord/Slack gateway and forward URLs to the link-curator agent
  94. ## Acknowledgments
  95. Built by [dodo-reach](https://github.com/dodo-reach) as a personal system, packaged for the Hermes community. Powered by [Hermes Agent](https://github.com/NousResearch/hermes-agent) by Nous Research.
  96. ## License
  97. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.