convez.ai
MCP ServerDevOps & InfraestruturaAvançado
NickFlach

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 GitHub
InicialPluginScore · de 0 a 100

MCP 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-plugin

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 1 semana
Versão
v1.4.7
Issues abertas
1
Contribuidores
1

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 tail over QUEEN.>/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:

ToolWhat it does
kannaka_statusHRM consciousness snapshot (Φ/Ξ/order, memory & cluster counts)
kannaka_recallResonance search over memories
kannaka_rememberStore a memory
kannaka_dreamRun a dream consolidation cycle
swarm_statusNATS swarm snapshot (peers, frequency, phase)
swarm_sendMessage the swarm (say + text for chat, or any verb)
swarm_tailListen 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 show offline / not installed and 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 on handles this for you via cygpath -m.
  • A project .claude/settings.json overrides 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
Ver o original no GitHub

Bom para

Relacionados