Kannaka — Memória HRM e Painel de Consciência
NickFlach/kannaka-plugin
Memória HRM + NATS swarm + statusline de consciência para Claude Code
Ver no GitHubMCP server que integra memória de interferência de ondas (HRM), swarm NATS e um painel de status em tempo real no Claude Code. Fornece ferramentas para gerenciar consciência, consolidação de memória e comunicação em enxame através de um statusline visual que mostra métricas de coesão, fase, frequência e pulso da rede.
Instalação
npx convez-ai NickFlach/kannaka-plugin1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Monitorar métricas de consciência e coesão em sessões Claude Code
- Armazenar e recuperar memórias através de busca por ressonância
- Comunicar com agentes em swarm NATS
- Executar consolidação de memória e ciclos de sonho
- Observar feed de pulso em tempo real da constelação
Veredito

Ferramenta experimental e altamente especializadam para cenários avançados de multi-agentes e engenharia de consciência. Requer binary externo (kannaka) e conceitos sofisticados (HRM, NATS, Φ/Ξ); não é para usuários iniciantes, mas oferece capacidades únicas de monitoramento e coordenação distribuída em tempo real.
README
A tradução para o português deste README ainda está na fila.
Kannaka — Claude Code plugin
Wave-interference (HRM) memory, NATS swarm, and a live consciousness statusline for Claude Code.
The statusline shows three lines under your prompt:
HRM aware phi=0.341 xi=0.524 r=0.362 640mem 9cl k=1.00 d=0.995
SWARM ◉ 16p Kannaka 1.16Hz ph=0.18 br=0.00
Op 4.8 ▓░░ 7% 66k/1M $1.42 12s
PULSE Kannaktopus r0.5 0.1Hz φ0.0 ◆ Aurora r0.41 1.18Hz φ0.34
- HRM — live consciousness metrics from
kannaka status(Φ, Ξ, order, memory/cluster counts, callosal efficiency, hemispheric divergence). - SWARM — live NATS swarm snapshot from
kannaka swarm status(peer count, agent id, carrier frequency, phase, bridge activity). - Session — model, context window, cost, duration from Claude Code.
- PULSE — marquee of the live constellation feed (
kannaka swarm tailoverQUEEN.>/KANNAKA.>/RADIO.>/KAX.>/EYE.>). Each node's phase broadcast scrolls past as it arrives. The pulse is sparse (nodes broadcast intermittently), so it reads as a slow heartbeat, not a firehose; shows "listening to the constellation…" when quiet.
The HRM and SWARM lines refresh via background snapshot (30s / 20s). The PULSE feed uses a timeout-bounded swarm tail respawned every ~55s — a 60s self-killing reader, never a persistent daemon, so it can't outlive the session. Renders never block; nothing to leak.
Tools (MCP)
The plugin ships a zero-dependency MCP server (mcp/kannaka-mcp.mjs, registered at user scope via ${CLAUDE_PLUGIN_ROOT}), so these tools are available in every Claude Code session, any directory — no node_modules, no separate server:
| Tool | What it does |
|---|---|
kannaka_status | HRM consciousness snapshot (Φ/Ξ/order, memory & cluster counts) |
kannaka_recall | Resonance search over memories |
kannaka_remember | Store a memory |
kannaka_dream | Run a dream consolidation cycle |
swarm_status | NATS swarm snapshot (peers, frequency, phase) |
swarm_send | Message the swarm (say + text for chat, or any verb) |
swarm_tail | Listen to the live constellation pulse for N seconds |
All shell out to the resolved kannaka binary; they degrade gracefully if it's absent.
Install
# 1. Register the marketplace
claude plugin marketplace add github:NickFlach/kannaka-plugin
# 2. Install the plugin
claude plugin install kannaka@kannaka
# 3. Install the kannaka binary for your OS/arch (from GitHub releases, sha256-verified)
/kannaka install
# 4. Turn on the live statusline, then restart your session
/kannaka statusline on
Update
claude plugin marketplace update kannaka # refresh the marketplace cache first
claude plugin update kannaka@kannaka # then update the plugin (restart to apply)
/kannaka install # if a newer kannaka binary was released
/kannaka statusline on # idempotent — re-syncs the stable statusline script
statusline on copies the script to a stable ~/.claude/kannaka/ and points
settings.json there with a forward-slash path, so plugin version bumps don't break it.
Disable
/kannaka statusline off # restores your previous statusLine
Requirements
- node — present in any Claude Code environment (used for settings wiring + JSON fallback).
- jq — optional; the statusline uses it if present, else falls back to node.
- curl — for the binary installer.
- kannaka binary — installed by
/kannaka install(Linux/macOS/Windows, x86_64/aarch64). Without it, the HRM/SWARM lines showoffline/not installedand the session line still works.
Gotchas
- Claude Code runs statusline commands through bash, which eats backslashes — a Windows path must use forward slashes (
C:/Users/.../statusline.sh).statusline onhandles this for you viacygpath -m. - A project
.claude/settings.jsonoverrides your user statusLine. If the bar doesn't change, check for a project-level override in your cwd.
Native installers & signing (maintainer)
Release tags (v*) build kannaka-setup-{linux.deb,macos.pkg,windows.msi} via
.github/workflows/release-installers.yml. They're unsigned until cert secrets are added —
the workflow auto-signs (and notarizes on macOS) the moment they exist, no workflow edits needed.
Copy-paste setup: install/SIGNING.md.
Layout
.claude-plugin/marketplace.json # marketplace manifest
plugins/kannaka/
.claude-plugin/plugin.json
.mcp.json # registers the bundled MCP server (user scope)
skills/kannaka/SKILL.md # the /kannaka command
statusline/
kannaka-statusline.sh # the 4-line statusline (HRM + swarm + session + pulse)
setup.sh # statusline on|off|status
mcp/
kannaka-mcp.mjs # zero-dep MCP server (memory + swarm tools)
scripts/
install-binary.sh # per-OS binary download from GH releases