This repository was archived by the owner on May 31, 2026. It is now read-only.
v0.3.0
Added
- Per-call project routing on every
bm_*tool. All eight tools now accept optionalproject(name) andproject_id(UUID frombm_projects) parameters. The agent can write or read against a project other than the Hermes-configured one — useful when the user asks to write into a different cloud project (e.g. a personalmainproject) without reconfiguring the plugin.project_idtakes precedence overproject; both fall back to the configured default when omitted. Workspace routing is handled transparently by BM viaproject_id— no separate workspace parameter is needed. bm_projectsandbm_workspacesagent tools. Promotes the discovery logic previously available only as/bm-projectand/bm-workspaceslash commands to agent-facing tools.bm_projectsreturns JSON withnameandexternal_id(UUID) per project so the agent can hand the UUID tobm_write/bm_read/ etc. viaproject_id— the unambiguous form across cloud workspaces.bm_workspaceslists BM Cloud workspaces (name, type, role, default flag). Together with per-call routing, these unblock the workflow Drew's friction note flagged: agent picks the right project + workspace before writing, instead of silently operating against the active Hermes memory project.- SKILL.md cross-project workflow documenting the discovery → route → write → verify recipe end-to-end. Adds a "Permalinks" section covering the three canonical shapes (short, project-qualified, workspace-qualified) and the round-trip property where
bm_write's returned permalink self-routes for follow-up reads. A "Cross-project routing" section explainsproject(including workspace-qualified syntax like"personal/main") vsproject_idand when to use each. Also backfillsbm_recentdocumentation (the tool shipped in 0.2.0 but the skill hadn't been updated). - SKILL.md "Further reading" section linking to the official docs at docs.basicmemory.com, with raw-markdown URLs (
/raw/<path>.md) the agent canWebFetchon demand for deeper material — knowledge format, observations & relations, memory URL wildcards, semantic search, cloud routing, BM's full MCP tool surface, and thellms.txtsitemap.
Notes
- Addresses the routing, discovery, and documentation gaps in the real-world note "Hermes Basic Memory Cloud Task Experience." A proposed
bm_importtool was evaluated and dropped —read_file+bm_writealready composes the same operation with no new capability, at the cost of one more tool in the surface. - The slash commands
/bm-projectand/bm-workspacestill exist and behave identically — they continue to calllist_memory_projects/list_workspacesdirectly via the actor. No behavior change for human use.