@onemem/claude-code-plugin
v0.1.1
Published
OneMem plugin for Claude Code — captures SessionStart, PostToolUse, and Stop hooks into verifiable on-chain traces
Readme
@onemem/claude-code-plugin
OneMem plugin for Claude Code — turns each Claude Code session's tool calls into
a verifiable on-chain trace (Merkle-chained ActionCalls on Sui, content
Seal-encrypted on Walrus). Coexists with claude-mem (semantic memory) — OneMem
owns verifiable on-chain trace; claude-mem owns local conversation summary.
How it works (hooks)
| Hook | Script | What it does |
|---|---|---|
| SessionStart | inject.js | Opens a OneMem TraceSession, persists the mapping |
| PostToolUse | observe.js | Buffers the tool call locally — instant, never blocks Claude |
| Stop | summarize.js | Flushes the buffer on-chain (one ActionCall per tool, Seal-encrypted -> Walrus) + closes the session |
Buffering keeps the editor responsive; the on-chain work happens once at session end, producing one tamper-evident trace you can verify or share.
Configure (env)
ONEMEM_NAMESPACE_ID+ONEMEM_RW_CAP_ID— the OneMem namespace + ReadWrite cap to record into (required; the plugin no-ops without them).ONEMEM_PRIVATE_KEY—suiprivkey1…signer (else the sui keystore's first key).SUI_NETWORK—testnet(default) |mainnet| …
Bundled MCP
The plugin root includes .mcp.json, so Claude Code can expose the same OneMem
MCP server alongside the lifecycle hooks. The MCP server is the dependable
memory/search/replay/share/verify layer and works independently of hook trace
capture.
Install From The Public Repository Marketplace
claude plugin marketplace add Blockchain-Oracle/onemem
claude plugin install onemem@onememPublication/proof note, 2026-06-19: this GitHub marketplace path is current.
@onemem/[email protected] contains the Stop hook fix plus bundled
MCP config. A trusted live Claude Code session emitted testnet TraceSession
0x9c88993b6197a8460f4fbd4a886c6353505d36383bf35035e5305088b64825e7;
onemem verify returned ok: true, callCount: 1, and matching Merkle roots.
The gated tests/plugin.integration.test.ts script remains available for
simulated SessionStart -> PostToolUse -> Stop coverage when
ONEMEM_INTEGRATION=1.
This GitHub marketplace path requires .claude-plugin/marketplace.json and
packages/plugin-claude-code/ to be present on the repository branch Claude Code
fetches.
Install From A Local Checkout During Development
claude plugin marketplace add /absolute/path/to/onemem
claude plugin install onemem@onememSpec: docs/05-our-architecture/03-runtimes/claude-code-plugin.md.
