Nuggets Memory

This folder now ships Nuggets as a single npm package and plugin product:

• nuggets-memory-plugin

The package contains:

• the local Nuggets memory engine
• the MCP stdio server
• install helpers for Hermes, Claude Code, and Codex

Install

Publish/install package:

npm install -g nuggets-memory-plugin

Then connect it to your host.

Hermes Agent

bash ./install.sh hermes

This writes a Hermes MCP entry that runs:

• npx -y nuggets-memory-plugin

Claude Code

bash ./install.sh claude

This writes a Claude MCP entry that runs:

• npx -y nuggets-memory-plugin

Codex

bash ./install.sh codex

Then:

1. open the generated release bundle
2. start Codex in the bundle
3. run /plugins
4. install Nuggets Memory

The Codex plugin bundle also launches:

• npx -y nuggets-memory-plugin

What Nuggets is for

Nuggets is a lightweight nudge layer for agents:

• short durable steering facts
• preferences and corrections
• tiny project hints
• not the main memory store

npm package

Package name:

• nuggets-memory-plugin

Useful commands:

npm run verify
npm run release:local
npm run publish:packages

Release outputs

npm run release:local writes:

• artifacts/npm/nuggets-memory-plugin-<version>.tgz
• artifacts/release/nuggets-memory-v<version>-<platform>/

Notes

• Hermes and Claude can use the published npm package directly through MCP config.
• Codex still installs through its plugin marketplace flow, but the plugin now points to the same npm package runtime.
• The plugin bundles under plugins/ are thin wrappers around the single published npm package.