Skip to content
This repository was archived by the owner on May 31, 2026. It is now read-only.

v0.3.0

Choose a tag to compare

@github-actions github-actions released this 12 May 21:05

Added

  • Per-call project routing on every bm_* tool. All eight tools now accept optional project (name) and project_id (UUID from bm_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 personal main project) without reconfiguring the plugin. project_id takes precedence over project; both fall back to the configured default when omitted. Workspace routing is handled transparently by BM via project_id — no separate workspace parameter is needed.
  • bm_projects and bm_workspaces agent tools. Promotes the discovery logic previously available only as /bm-project and /bm-workspace slash commands to agent-facing tools. bm_projects returns JSON with name and external_id (UUID) per project so the agent can hand the UUID to bm_write / bm_read / etc. via project_id — the unambiguous form across cloud workspaces. bm_workspaces lists 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 explains project (including workspace-qualified syntax like "personal/main") vs project_id and when to use each. Also backfills bm_recent documentation (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 can WebFetch on demand for deeper material — knowledge format, observations & relations, memory URL wildcards, semantic search, cloud routing, BM's full MCP tool surface, and the llms.txt sitemap.

Notes

  • Addresses the routing, discovery, and documentation gaps in the real-world note "Hermes Basic Memory Cloud Task Experience." A proposed bm_import tool was evaluated and dropped — read_file + bm_write already composes the same operation with no new capability, at the cost of one more tool in the surface.
  • The slash commands /bm-project and /bm-workspace still exist and behave identically — they continue to call list_memory_projects / list_workspaces directly via the actor. No behavior change for human use.