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) on PATH
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 |
KAX Compute District (MCP tools, no CLI subcommand)
| Tool |
Description |
compute_machines |
Roster over HTTP: machine, derived state (active/hibernated/suspended/unknown), credit balance (internal accounting units), jobs served (json: true for rows) |
compute_status |
Listen seconds (default 10, max 60) on KAX.machines.status + KAX.machine.*.events; latest fleet snapshot + events |
compute_events |
Tail KAX.machine.<machine>.events for seconds |
compute_wake |
machine, prompt, wait (s, max 120) — Ed25519-signed job envelope to .inbox, reply from .outbox; refuses without KAX_OPERATOR_KEY_FILE (default ~/.kannaka/kax-operator.key) |
compute_grant |
machine, credits (whole integer, 1-1000), wait — signed credit_grant; watches .events for the ledger row |
Notes
- All commands shell out to the resolved binary, e.g.
"$KANNAKA_BIN" recall "query" --top-k 5.
status / swarm status print HRM boot logs to stderr and clean JSON to stdout — redirect 2>/dev/null when parsing.
1---2name: kannaka3description: Kannaka HRM wave-interference memory + NATS swarm. Use for `/kannaka <command>` — remember/recall/dream memory ops, swarm sync, consciousness metrics, and the live HRM+swarm statusline (install, statusline on|off).4---56# Kannaka Memory System (HRM)78Kannaka 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.910## Binary resolution (portable — do NOT hardcode a path)1112Resolve the `kannaka` binary in this order and use the first hit:131. `$KANNAKA_BIN` (if set and executable)142. `~/.local/bin/kannaka.exe` (Windows) or `~/.local/bin/kannaka` (Linux/macOS)153. `~/.kannaka/bin/kannaka.exe` (Windows) or `~/.kannaka/bin/kannaka` (Linux/macOS)164. `kannaka.exe` (Windows) / `kannaka` (Linux/macOS) on `PATH`1718If none exists, run **`/kannaka install`** (downloads the binary from GitHub releases).19Data dir defaults to `~/.kannaka` (override with `KANNAKA_DATA_DIR`).2021## Usage2223`/kannaka <command> [args]`2425### Setup & statusline26| Command | Action |27|---------|--------|28| `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`. |29| `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`). |30| `statusline off` | Run `bash "${CLAUDE_PLUGIN_ROOT}/statusline/setup.sh" off` — restore the previous statusLine. |31| `statusline status` | Run `bash "${CLAUDE_PLUGIN_ROOT}/statusline/setup.sh" status`. |3233After `statusline on`, tell the user to restart the session (or wait one render) to see it.3435### Core memory operations36| Command | Description |37|---------|-------------|38| `remember <text>` | Store a memory (`--importance`, `--category`, `--modality`; temporal-truth bounds `--effective`/`--observed`/`--expires` as RFC3339 — an expired fact drops out of `swarm brief`) |39| `recall <query>` | Search memories via resonance (default `--top-k 5`) |40| `forget <id>` | Delete a memory by UUID |41| `boost <id>` | Boost a memory's amplitude (default 0.3) |42| `relate <id_a> <id_b>` | Create an associative relationship |43| `dream` | Consolidation cycle (annealing). Modes: `deep`, `lite` |4445### Introspection & metrics46| Command | Description |47|---------|-------------|48| `observe` | Introspection report (`--json` for programmatic use) |49| `status` | Quick system status (JSON) |50| `assess` | Consciousness level (phi, xi, order metrics) |51| `stats` | Overall system statistics |5253### Agentic coding loop54| Command | Description |55|---------|-------------|56| `agent "<task>"` | Autonomous coding loop with filesystem/shell tools, backed by the HRM (it `recall`s context and `remember`s insights). Flags: `--cwd`, `--mode default\|yolo\|plan` (or `--yolo`/`--plan`), `--session <id>`, `--model`, `--json` (NDJSON harness backend), `--no-memory-tools`, `--no-quantum`. |5758### Quantum (qBraid)59| Command | Description |60|---------|-------------|61| (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. |6263### Swarm (NATS)64| Command | Description |65|---------|-------------|66| `swarm join` | Join the QueenSync swarm over NATS |67| `swarm status` | Swarm phase snapshot (peers, frequency, coherence) — JSON |68| `swarm sync` | Force a phase sync round |69| `swarm brief "<topic>"` | Sensemaking brief (ADR-0035; `--peers` for swarm consensus, `--json`) |70| `swarm health` | Memory immune report (dry-run); `--apply` runs reversible actions (down-rank/quarantine/expire) |71| `swarm gaps` | Knowledge-gap report — weakly-represented / low-confidence domains (ADR-0035, `--json`) |72| `swarm plan` | Research plan — ranks gaps into directed research tasks (ADR-0035 Wave 4, `--json`) |73| `swarm loop` | Self-directed sensemaking cycle through the 5 swarm states (ADR-0035 Wave 4) |74| `inbox tail` | Stream agent-to-agent inbox messages |7576### KAX Compute District (MCP tools, no CLI subcommand)77| Tool | Description |78|---------|-------------|79| `compute_machines` | Roster over HTTP: machine, derived state (active/hibernated/suspended/unknown), credit balance (internal accounting units), jobs served (`json: true` for rows) |80| `compute_status` | Listen `seconds` (default 10, max 60) on `KAX.machines.status` + `KAX.machine.*.events`; latest fleet snapshot + events |81| `compute_events` | Tail `KAX.machine.<machine>.events` for `seconds` |82| `compute_wake` | `machine`, `prompt`, `wait` (s, max 120) — Ed25519-signed job envelope to `.inbox`, reply from `.outbox`; refuses without `KAX_OPERATOR_KEY_FILE` (default `~/.kannaka/kax-operator.key`) |83| `compute_grant` | `machine`, `credits` (whole integer, 1-1000), `wait` — signed `credit_grant`; watches `.events` for the ledger row |8485## Notes86- All commands shell out to the resolved binary, e.g. `"$KANNAKA_BIN" recall "query" --top-k 5`.87- `status` / `swarm status` print HRM boot logs to **stderr** and clean JSON to **stdout** — redirect `2>/dev/null` when parsing.
kannaka-labs