# Wax Memory Maintenance

> Maintain the Wax memory store used by the Hermes wax-memory provider.

- Skill: `christopherkarani/wax-memory-maintenance` (Agent Skill)
- Install (CLI): `npx skillmds@latest add christopherkarani/wax-memory-maintenance`
- Raw SKILL.md: https://api.skillmd.com/api/skills/christopherkarani/wax-memory-maintenance/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: christopherkarani (https://skillmd.com/u/christopherkarani)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/christopherkarani/wax-memory-maintenance

---


# Wax Memory Maintenance

Use when the active Hermes memory provider is `wax-memory`.

## Checks

1. Confirm the broker is reachable: `hermes wax-memory doctor`
2. Prefer `wax_recall` for assembled context and `wax_search` for raw hits
3. Store durable facts with `wax_remember` and `memory_type` from `note`, `user_preference`, `decision`, `lesson`, `handoff`, `constraint`, `fact`; `task_state` is session-local working state and requires an active session
4. Write session continuity with `wax_handoff`; do not dump raw transcripts
5. Use structured tools (`wax_entity_upsert`, `wax_fact_assert`, `wax_facts_query`) only for stable knowledge-graph facts

## Recovery

- If recall is empty, run `npx waxmcp --embedder minilm --transport http`
- If vector search is disabled, rebuild both `wax-cli` and `wax-mcp` with MiniLM/Arctic traits
- After `/reset` or `/resume`, rely on the provider session switch — do not invent a new session id