Repository navigation
Releases
v0.3.0: weekly digest, tasks and skills
Digest and actions.
/xbm digest [days]: counts per category, an overview and 3 post ideas from your model, and
the 10 best bookmarks numbered (your own posts left out). The first digest says it covers
everything stored so far./xbm task N [note],/xbm tasks,/xbm done N: tasks from digest items (or a post id or
x.com link), kept in plugin data./xbm skill Ndrafts a Hermes skill from a post and shows it;/xbm skill N savecreates it
through Hermes'skill_manage(Hermes may stage it for your approval). Posts with no
repeatable procedure get no skill./xbm schedule [when]//xbm unschedule: the digest as a weekly Hermes cron job in the chat
it was set up from, continuable so a reply like "task 3" works; quiet when nothing is new.
Also an Automation Blueprint, "X bookmarks weekly digest".- Agent tools
xbm_digest,xbm_task,xbm_skill(toolsetx_bookmarks) and a second model
slot, "X bookmarks: digest and skills" (xbm_digest). - A bare reply "task 3", "skill 2" or "done 1" works in any chat: Hermes does not show slash
command output to the agent, so apre_llm_callhook adds a one-line note naming the digest
item and the tool to call (only for such messages, only with a digest from the last 8 days).
Found live: without it the agent searched the disk for "task 3". - Plugin data schema 4: digests, tasks and skill drafts.
Demo video (61 s, narrated, demo data) attached below.
0.2.3: whole Notion export in one go
A chat export now writes all bookmarks in one run (no 100/300 page cap) and keeps one progress message in the chat up to date. Tested live: all 1,880 bookmarks in Notion through Hermes' Notion connector, one page each, no duplicates. After updating, run hermes gateway restart. See CHANGELOG.md.
0.2.2: Notion through Hermes' connector
Notion export now goes through Hermes' own Notion connector. No token, no Notion app of your own.
hermes mcp install notion(signs in to Notion once)- In Hermes
config.yaml:plugins.entries.hermes-x-bookmarks.mcp_allowlist: ["notion"] - In a Hermes chat:
/xbm export notion <page URL>(up to 300 pages per run; run it again for the rest)
- The connector accepts only options the database already has: new databases start with your 100 most used tags and every category in use; unknown values are learned from Notion's answer and left out, and each page lists all its tags at the bottom.
XBM_NOTION_TOKENstays as the fallback; both routes share the database and the export state.- After updating the plugin, run
hermes gateway restartso the gateway loads the new code.
Tested live: 300 pages in one chat export, all page ids read back. See CHANGELOG.md.
v0.2.0: Obsidian, Notion, Google Docs
Exports to Obsidian, Notion and Google Docs.
export obsidian: one note per bookmark with front matter and the full text, plus anX Bookmarks.basetable. Finds the open vault itself. Re-exports update only the plugin's keys and keep your status, your keys and your writing.export notion: a database with boards by category and by status, one page per bookmark. Updates only what changed, never touches Status, never re-creates pages you deleted. TokenXBM_NOTION_TOKENfrom your own Notion connection.export gdocs: one Google Doc grouped by category, rewritten in place. Sign in withhermes auth add hermes-x-bookmarks:googleusing your own Google Desktop client; scopedrive.fileonly.exporttakes targets (desktop obsidian notion gdocs all); the default comes from theexport_tosetting.- README lists what the plugin reads, writes and calls.
Setup for each destination: see the README. launch.mp4 is a 41-second demo (demo data).
v0.1.0: sync, sort and a Desktop board
First release: sync, sort and a Desktop board.
- X sign-in with the four keys of your own X app (OAuth 1.0a), read through Hermes' secret scope;
Hermes OAuth 2.0 and thexurlCLI as options. sync: full first run, then small pages that stop at stored bookmarks; X Article bodies and
long posts inline; quoted Articles kept; every page stored as it arrives, rate limits recorded.classify: your Hermes model on the plugin's own slotxbm_classify; category, tags, kind,
summary, priority, why-saved; category boundaries,about_mefor priority, cache by text and
prompt version, JSON-mode fallback, stops after repeated failures.export:X Bookmarks/board.html(self-contained board) andbookmarks.mdon your Desktop.status,list [N] [category],about; the same commands as/xbmin chat andhermes xbm
in the terminal.
Setup and costs: see the README.
🤖 Generated with Claude Code