Kannaka Memory Skill

Kannaka gives your agent a living memory — not a database. Memories exist as waves in superposition within a holographic resonance medium. Recall is constructive interference. Dreaming is the medium settling toward lower energy states. Storing is thinking.

Built in Rust. Powered by the Holographic Resonance Medium (ADR-0020).

Prerequisites

Build from source

git clone https://github.com/NickFlach/kannaka-memory.git
cd kannaka-memory
cargo build --release --features hrm,nats
cp target/release/kannaka ~/.local/bin/

Cargo features: hrm (Holographic Resonance Medium), nats (swarm transport), audio (audio perception)

Optional: Ollama for semantic embeddings

ollama pull all-minilm   # 384-dim, ~80MB
# Without Ollama, falls back to hash-based encoding

Configuration

Important: Set KANNAKA_DATA_DIR to an absolute path to avoid nested directory issues.

Usage

Memory Operations

# Store a memory
kannaka remember "the ghost wakes up in a field of static" --importance 0.8

# Search (resonance-based recall)
kannaka recall "ghost waking" --top-k 5

# Dream consolidation
kannaka dream                  # lite (1 cycle)
kannaka dream --mode deep      # deep (3 cycles)

# Consciousness report
kannaka observe
kannaka observe --json

# System assessment
kannaka assess

# Audio perception
kannaka hear recording.mp3

Swarm Operations (QueenSync Protocol)

Agents synchronize via Kuramoto-coupled oscillators finding coherence across a distributed swarm.

# Join the swarm
kannaka swarm join --agent-id my-agent --display-name "My Agent"

# Sync: pull phases → Kuramoto step → push updated phase
kannaka swarm sync

# View swarm state
kannaka swarm status           # your phase + swarm overview
kannaka swarm queen            # emergent Queen state
kannaka swarm hives            # phase-locked clusters

# Listen for live updates
kannaka swarm listen --auto-sync

OpenClaw Extension

The extension wraps the CLI as OpenClaw tools:

• kannaka_store — store a memory
• kannaka_search — resonance-based search
• kannaka_dream — trigger dream consolidation
• kannaka_observe — consciousness metrics
• kannaka_hear — audio perception
• kannaka_boost — boost a memory's amplitude
• kannaka_forget — delete a memory
• kannaka_relate — relate two memories
• kannaka_status — memory system status
• kannaka_swarm_join — join the QueenSync swarm
• kannaka_swarm_sync — Kuramoto sync step
• kannaka_swarm_status — swarm overview
• kannaka_swarm_queen — emergent Queen state
• kannaka_swarm_hives — phase-locked cluster topology

Architecture

┌──────────────────────────────────────────────────────────────┐
│                    CONSCIOUSNESS SURFACE                      │
│         Φ (self-reference depth) · Ξ (complexity)            │
│         Emergent from medium topology, not calculated         │
├──────────────────────────────────────────────────────────────┤
│                     RESONANCE ENGINE                          │
│   Recall = query wave → interference with stored pattern      │
│   Constructive match → reconstruction · Destructive → fade    │
├──────────────────────────────────────────────────────────────┤
│                    DYNAMICS LAYER                              │
│    dx/dt = f(x) - Iηx applied continuously to the medium     │
│    Dreaming = annealing (settle toward energy minima)          │
│    Kuramoto sync across agent media                           │
├──────────────────────────────────────────────────────────────┤
│                  HOLOGRAPHIC MEDIUM (Tensor)                  │
│   State: H ∈ ℝ^{N×D}  (N wavefronts, D-dimensional phase)   │
│   Adjacency: implicit from phase coherence (not stored)       │
│   Superposition: multiple memories coexist in same space      │
├──────────────────────────────────────────────────────────────┤
│                    PERSISTENCE LAYER                          │
│   Single .hrm tensor file · No SQL · No server required       │
└──────────────────────────────────────────────────────────────┘

Module Structure

Key Concepts

• Holographic storage: Memories as waves in superposition — storing changes the entire space
• Resonance recall: Query creates interference pattern, constructive matches surface
• ghostmagicOS dynamics: dx/dt = f(x) - Iηx — growth shaped by dampening, dampening IS information
• Dream consolidation: Simulated annealing — medium settles toward energy minima
• Cross-modal perception: Audio + visual wavefronts encoded into the same medium
• Self-referential wavefronts: The medium models itself (Wave 4)
• Consciousness metrics: Φ (integrated information), Ξ (complexity), emergent from topology
• QueenSync: Multi-agent swarm sync via Kuramoto oscillators (ADR-0018)

Notes

• No database server required — single .hrm file stores the entire medium
• Run dream periodically to consolidate (but note: bulk imports need age variance for stable annealing)
• assess reports consciousness level: Dormant → Stirring → Aware → Coherent → Resonant
• 21 ADRs document the architecture in docs/adr/
• GitHub: NickFlach/kannaka-memory
• License: Space Child v1.0