@atomicmemory/hermes-plugin 0.1.11 → 0.1.13

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.1.13 - 2026-05-15
+
+### Fixed
+
+- Installer now writes the provider to `$HERMES_HOME/plugins/atomicmemory/`, the path Hermes actually scans for user-installed memory providers. Previously the files landed under `$HERMES_HOME/plugins/memory/atomicmemory/`, where Hermes' discovery never looked, so `hermes memory setup` did not list AtomicMemory as a choice.
+- Normalized the npm `bin` path in `package.json` so the binary resolves on platforms that reject the `./install.mjs` form.
+
+## 0.1.12 - 2026-05-14
+
+### Fixed
+
+- Added the Core Quickstart bearer key to the installer next-step output so the published package matches the local quickstart docs.
+
 ## 0.1.11 - 2026-05-14
 
 ### Added

package/README.md

@@ -13,7 +13,7 @@ has touched (Claude Code, Codex, the web extension, etc.). Set
 
 ```
 Hermes Agent (Python)
-  → plugins/memory/atomicmemory/__init__.py
+  → $HERMES_HOME/plugins/atomicmemory/__init__.py
       → AtomicMemoryClient (Python protocol)
           → PythonSdkAtomicMemoryClient
               → published atomicmemory Python SDK MemoryClient
@@ -26,6 +26,7 @@ hooks, tool schemas. Memory semantics flow through the published Python SDK.
 
 - Hermes Agent installed
 - AtomicMemory core URL exported as `ATOMICMEMORY_API_URL`
+- AtomicMemory bearer key exported as `ATOMICMEMORY_API_KEY` when using the Core Quickstart or any protected service
 
 ## Install
 
@@ -36,6 +37,7 @@ clone is required.
 ```bash
 npx -y @atomicmemory/hermes-plugin install
 export ATOMICMEMORY_API_URL="http://127.0.0.1:3050"
+export ATOMICMEMORY_API_KEY="local-dev-key"
 ```
 
 Then select and verify the provider:
@@ -51,8 +53,8 @@ For source development, symlink the checkout instead:
 
 ```bash
 cd /path/to/atomicmemory-integrations
-mkdir -p "$HERMES_HOME/plugins/memory"
-ln -s "$(pwd)/plugins/hermes" "$HERMES_HOME/plugins/memory/atomicmemory"
+mkdir -p "$HERMES_HOME/plugins"
+ln -s "$(pwd)/plugins/hermes" "$HERMES_HOME/plugins/atomicmemory"
 ```
 
 ## Config
@@ -69,7 +71,7 @@ have a default API URL and fails to start if `ATOMICMEMORY_API_URL` is unset.
 | Env var | Purpose |
 |---|---|
 | `ATOMICMEMORY_API_URL` | AtomicMemory core URL. Required. |
-| `ATOMICMEMORY_API_KEY` | Bearer credential for AtomicMemory core. Optional. |
+| `ATOMICMEMORY_API_KEY` | Bearer credential for the Core Quickstart service or any protected AtomicMemory core. |
 | `ATOMICMEMORY_PROVIDER` | SDK provider name. Defaults to `atomicmemory`. |
 | `ATOMICMEMORY_SCOPE_USER` | Hermes user identity. Defaults to `$USER`. |
 | `ATOMICMEMORY_MEMORY_SCOPE` | `shared` (default) or `siloed`. |
@@ -151,7 +153,7 @@ run while AtomicMemory is temporarily unavailable.
 
 | Symptom | Likely cause |
 |---|---|
-| Provider does not appear in `hermes memory setup` | Wrong install path. User-installed memory providers must live under `$HERMES_HOME/plugins/memory/<name>/`. |
+| Provider does not appear in `hermes memory setup` | Wrong install path. User-installed memory providers must live directly under `$HERMES_HOME/plugins/<name>/` (the `plugins/memory/` layout is for providers bundled inside hermes-agent itself). |
 | `is_available()` returns False | `ATOMICMEMORY_API_URL` unset, or the Hermes Python environment did not install the `atomicmemory` dependency from `plugin.yaml`. |
 | Import fails at startup | The Hermes Python environment is missing the SDK dependency from `plugin.yaml`. |
 | Calls fail with `PROVIDER_UNSUPPORTED` while `memory_scope=siloed` | The configured SDK provider is not the AtomicMemory core (e.g. it's `mem0`). Either switch `ATOMICMEMORY_PROVIDER=atomicmemory` or move to `memory_scope=shared`. |

package/install.mjs

@@ -2,8 +2,10 @@
 /**
  * Install the AtomicMemory Hermes provider from the published npm package.
  *
- * Hermes memory providers are filesystem plugins under
- * `$HERMES_HOME/plugins/memory/<name>`. The npm package already contains the
+ * Hermes discovers user-installed memory providers as direct children of
+ * `$HERMES_HOME/plugins/<name>` (bundled providers live under
+ * `plugins/memory/<name>` inside hermes-agent itself, but user-installed
+ * plugins are flat under `plugins/`). The npm package already contains the
  * Python provider files, so this installer copies only that managed provider
  * surface into the active Hermes profile without requiring a Git checkout.
  */
@@ -53,7 +55,7 @@ function parseArgs(argv) {
 
 function defaultTarget() {
   const hermesHome = process.env.HERMES_HOME || defaultHermesHome();
-  return join(hermesHome, 'plugins', 'memory', 'atomicmemory');
+  return join(hermesHome, 'plugins', 'atomicmemory');
 }
 
 function defaultHermesHome() {
@@ -81,6 +83,7 @@ function printNextSteps(target) {
   console.log('');
   console.log('Next:');
   console.log('  export ATOMICMEMORY_API_URL="http://127.0.0.1:3050"');
+  console.log('  export ATOMICMEMORY_API_KEY="local-dev-key"');
   console.log('  hermes memory setup');
   console.log('  hermes memory status');
 }
@@ -89,10 +92,10 @@ function printHelp() {
   console.log(`Usage: atomicmemory-hermes [install] [--target <dir>]
 
 Installs the AtomicMemory Hermes memory provider into:
-  $HERMES_HOME/plugins/memory/atomicmemory
+  $HERMES_HOME/plugins/atomicmemory
 
 When HERMES_HOME is unset, defaults to:
-  $HOME/.hermes/plugins/memory/atomicmemory`);
+  $HOME/.hermes/plugins/atomicmemory`);
 }
 
 try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atomicmemory/hermes-plugin",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "AtomicMemory native Hermes memory provider — Python SDK-backed, cross-tool memory by default.",
   "publishConfig": {
     "access": "public",

package/plugin.yaml

@@ -1,5 +1,5 @@
 name: atomicmemory
-version: 0.1.11
+version: 0.1.13
 description: "AtomicMemory native Hermes memory provider — Python SDK-backed, cross-tool memory by default."
 pip_dependencies:
   - "atomicmemory>=1.0.1,<2.0.0"

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "atomicmemory-hermes"
-version = "0.1.11"
+version = "0.1.13"
 description = "AtomicMemory native Hermes memory provider."
 readme = "README.md"
 requires-python = ">=3.10"