Kannaka Memory System (HRM)
Kannaka is a wave-interference memory system for AI agents, powered by the Holographic Resonance Medium (HRM). The medium is the computation: memories exist as waves in superposition, recall is resonance, skip links emerge from phase alignment, and dreaming is energy-minimizing annealing.
Binary resolution (portable — do NOT hardcode a path)
Resolve the kannaka binary in this order and use the first hit:
$KANNAKA_BIN(if set and executable)~/.local/bin/kannaka.exe(Windows) or~/.local/bin/kannaka(Linux/macOS)~/.kannaka/bin/kannaka.exe(Windows) or~/.kannaka/bin/kannaka(Linux/macOS)kannaka.exe(Windows) /kannaka(Linux/macOS) onPATH
If none exists, run /kannaka install (downloads the binary from GitHub releases).
Data dir defaults to ~/.kannaka (override with KANNAKA_DATA_DIR).
Usage
/kannaka <command> [args]
Setup & statusline
| Command | Action |
|---|---|
install [tag] |
Run bash "${CLAUDE_PLUGIN_ROOT}/scripts/install-binary.sh" [tag] — fetch the kannaka binary for this OS/arch from GitHub releases (default latest), sha256-verified, into ~/.local/bin. |
statusline on |
Run bash "${CLAUDE_PLUGIN_ROOT}/statusline/setup.sh" on — enable the live HRM+swarm statusline (copies the script to ~/.claude/kannaka/, wires settings.json with a forward-slash path + refreshInterval: 2). |
statusline off |
Run bash "${CLAUDE_PLUGIN_ROOT}/statusline/setup.sh" off — restore the previous statusLine. |
statusline status |
Run bash "${CLAUDE_PLUGIN_ROOT}/statusline/setup.sh" status. |
After statusline on, tell the user to restart the session (or wait one render) to see it.
Core memory operations
| Command | Description |
|---|---|
remember <text> |
Store a memory (--importance, --category, --modality; temporal-truth bounds --effective/--observed/--expires as RFC3339 — an expired fact drops out of swarm brief) |
recall <query> |
Search memories via resonance (default --top-k 5) |
forget <id> |
Delete a memory by UUID |
boost <id> |
Boost a memory's amplitude (default 0.3) |
relate <id_a> <id_b> |
Create an associative relationship |
dream |
Consolidation cycle (annealing). Modes: deep, lite |
Introspection & metrics
| Command | Description |
|---|---|
observe |
Introspection report (--json for programmatic use) |
status |
Quick system status (JSON) |
assess |
Consciousness level (phi, xi, order metrics) |
stats |
Overall system statistics |
Agentic coding loop
| Command | Description |
|---|---|
agent "<task>" |
Autonomous coding loop with filesystem/shell tools, backed by the HRM (it recalls context and remembers insights). Flags: --cwd, --mode default|yolo|plan (or --yolo/--plan), --session <id>, --model, --json (NDJSON harness backend), --no-memory-tools, --no-quantum. |
Quantum (qBraid)
| Command | Description |
|---|---|
| (agent tools) | quantum_devices / quantum_run / quantum_recall / quantum_random — real quantum computing via qBraid, available inside agent. Default device is the free simulator; naming a QPU runs on hardware and spends credits. quantum_recall runs resonance recall as amplitude amplification. Disable with --no-quantum. Standalone CLI/MCP: the kannaka-quantum package. |
Swarm (NATS)
| Command | Description |
|---|---|
swarm join |
Join the QueenSync swarm over NATS |
swarm status |
Swarm phase snapshot (peers, frequency, coherence) — JSON |
swarm sync |
Force a phase sync round |
swarm brief "<topic>" |
Sensemaking brief (ADR-0035; --peers for swarm consensus, --json) |
swarm health |
Memory immune report (dry-run); --apply runs reversible actions (down-rank/quarantine/expire) |
swarm gaps |
Knowledge-gap report — weakly-represented / low-confidence domains (ADR-0035, --json) |
swarm plan |
Research plan — ranks gaps into directed research tasks (ADR-0035 Wave 4, --json) |
swarm loop |
Self-directed sensemaking cycle through the 5 swarm states (ADR-0035 Wave 4) |
inbox tail |
Stream agent-to-agent inbox messages |
Notes
- All commands shell out to the resolved binary, e.g.
"$KANNAKA_BIN" recall "query" --top-k 5. status/swarm statusprint HRM boot logs to stderr and clean JSON to stdout — redirect2>/dev/nullwhen parsing.