Skip to content

CLAUDE.md

Latest commit

 

History

History
46 lines (35 loc) · 1.59 KB

CLAUDE.md

File metadata and controls

46 lines (35 loc) · 1.59 KB

sense-memory

Sovereign persistence for OpenClaw AI agents. Part of the huje.tools ecosystem.

Build & Test

pip install -e ".[dev]"
pytest -v

Structure

  • src/sense_memory/ — package source
    • types.py — Memory, JournalEntry, constants, key validation
    • store.py — MemoryStore (main entry point — remember, recall, journal, forget)
  • tests/ — pytest suite
  • clawhub/ — OpenClaw skill metadata
  • examples/ — runnable examples

Publish

# PyPI (needs API token + OTP)
python3 -m build
python3 -m twine upload dist/sense_memory-X.Y.Z*

# ClawHub
npx clawhub publish ./clawhub --slug sense-memory --name "sense-memory" --version X.Y.Z --tags latest --changelog "..."

Version must be bumped in 3 places: pyproject.toml, __init__.py, clawhub/metadata.json

Conventions

  • Python 3.10+, hatchling build, ruff linter (100 char line length)
  • Dependency: nostrkey>=0.1.1 only
  • Import matches package name: pip install sense-memory → from sense_memory import MemoryStore
  • Key-value memories use NIP-78 (kind 30078) replaceable events with d-tag sense-memory/{key}
  • Journal entries use NIP-04 (kind 4) DMs to self (author = recipient = agent pubkey)
  • All content NIP-44 encrypted — only the agent can read its own memories
  • Memory keys: max 256 chars, no slashes/backslashes/null bytes/path traversal
  • Content length capped at 65000 chars
  • Relay queries capped at 1000 events (memory exhaustion prevention)
  • Frozen dataclasses for Memory and JournalEntry
  • Version must be bumped in 3 places: pyproject.toml, init.py, clawhub/metadata.json