Skip to content

v0.3.0

Latest
Latest

Choose a tag to compare

View all tags
@GrumpyChubbyCat GrumpyChubbyCat released this 22 Jun 20:18
· 6 commits to main since this release
v0.3.0
5284532

kaeru v0.3.0

Two new front doors to your agent's memory — a rig adapter and a 3D galaxy you can fly through — plus the HTTP fix that lets narrow-Accept MCP clients (Claude Code among them) actually connect.

New

  • kaeru-rig — rig framework adapter. The full curator verb set exposed as discrete rig::tool::Tools over an embedded Arc<Store> — generated by the mem_tool! macro, store work on spawn_blocking. A rig agent gets kaeru's whole memory toolset with no cloud HTTP: it embeds kaeru-core directly.
  • kaeru-viz — 3D knowledge-graph visualizer. A browser galaxy of your vault (Vite + three.js / 3d-force-graph): a cluster per initiative, nodes sized by memory layer, edges by weight. Colour by initiative / tier / layer, replay a reasoning chain node-by-node, scrub the bi-temporal time-lapse, or frame one project up close.
  • /graph.json — read-only visualizer endpoint on kaeru-mcp (opt-in via KAERU_MCP_VIZ_ENABLE), backed by a new whole-graph JSON export in kaeru-core. Point kaeru-viz at it, or bring your own viewer.
  • Connect from any MCP client. rmcp's Streamable HTTP transport answered 406 to clients that don't advertise both application/json and text/event-stream — silently locking out Claude Code's HTTP transport and the claude mcp list health check. The daemon now normalizes Accept on the MCP mount path, so those clients connect; /sse and /graph.json pass through untouched.

Fixes

  • Initiative-scope race — closed in both adapters. Concurrent sessions share one Arc<Store>; a bare set-scope-then-run let them interleave each other's initiative across threads. kaeru-rig (the spawn_blocking pool) and kaeru-mcp now both route through Store::scoped, which holds a guard across the set-then-operate sequence.
  • Bounded graceful shutdown. SIGTERM no longer hangs the daemon for up to 90s — shutdown is deadline-bounded.
  • v0.2.0 schema backfill. Pre-existing vaults get the v0.2.0 schema backfilled on open, so older vaults upgrade cleanly.
  • viz hardening — /graph.json endpoint safety, same-origin default, chain meta-nodes hidden from the galaxy, rig link-weight clamped to 0..1.

Docs

  • README Status now reflects the shipped kaeru-rig adapter and the Store::scoped scope-serialization; the MCP-concurrency caveat is narrowed to ordering only (a read can still land before a not-yet-applied write).

Upgrade (seamless from 0.2.1)

No schema break — your vault carries over untouched. Still pre-1.0, so export your initiatives to markdown first if you want a safety net.

cd kaeru && git pull           # local daemon
cargo install --path kaeru-mcp --force
systemctl --user restart kaeru-mcp

docker compose build && docker compose up -d   # team cloud

Prebuilt binaries

OS Arch Asset
Linux x86_64 kaeru-v0.3.0-x86_64-unknown-linux-musl.tar.gz (static musl)
macOS aarch64 kaeru-v0.3.0-aarch64-apple-darwin.tar.gz (Apple Silicon)
Windows x86_64 kaeru-v0.3.0-x86_64-pc-windows-msvc.zip (static CRT — no VC++ redistributable)

Verify with SHA256SUMS.

Assets 6
Loading