Skip to content

mesh-mem v0.3.0

Choose a tag to compare

View all tags
@h-wata h-wata released this 25 May 03:03
· 69 commits to main since this release
v0.3.0
7f3e041
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Highlights

  • Renamed to kioku-mesh — PyPI distribution and CLI binary renamed from mesh-mem → kioku-mesh (the original name conflicted with an unrelated PyPI package meshmem). On-disk paths (~/.config/mesh-mem/, ~/.local/share/mesh-mem/), env vars (MESH_MEM_*), and the systemd unit name are intentionally preserved — existing users only need to swap the binary. See docs/migration.md for the one-line upgrade. The mesh_mem Python import name also stays unchanged.
  • Tier 0: Local backend (#109) — kioku-mesh init --mode local works with no zenohd on PATH. Single-machine persistent memory in 30 seconds.
  • Tier 1: Embedded zenoh router (#112, integration fix #120) — kioku-mesh mesh start opens an in-process zenoh router (no binary install). Multi-host ephemeral mesh without zenohd.
  • README v0.3 overhaul (#110) — hero → Tier 0/1/2 quickstart → Power users narrative.
  • MemoryBackend abstraction (#109) — unified get_backend() surface shared by CLI, MCP server, and all Tiers.
  • kioku-mesh doctor (#84) — first-touch diagnostic with embedded router status.
  • kioku-mesh mcp install (#85) — one-shot Claude Code / Codex CLI MCP registration.
  • Forward-compat for Observation schema (#75) — older readers preserve unknown fields via _extras.

New Commands

Command Description
kioku-mesh init --mode local Initialize local (Tier 0) backend — no zenohd needed
kioku-mesh mesh start [--listen tcp/0.0.0.0:17447] Start in-process zenoh router (Tier 1)
kioku-mesh mesh join Connect to a peer endpoint and verify connectivity
kioku-mesh doctor Run diagnostic checks (zenohd, config, state dir, embedded router)
kioku-mesh mcp install --client <claude-code|codex-cli> Register MCP server with one command
kioku-mesh init --mode localhost|hub|spoke|local Generate zenohd config or local config

Config file changes

~/.config/mesh-mem/config.yaml (new in v0.3):

backend: local  # Use Tier 0 SQLite-only mode

Known limitations / deferred to v0.3.1+

  • macOS smoke-test pending (#87): kioku-mesh is verified on Linux and WSL2 only. Apple Silicon / Intel macOS support is plausible but unverified — maintainer does not currently have a Mac to test on. Community reports welcome on #87. docs/macos-setup.md will land in v0.3.1 once verified.

Issues / PRs

  • #109 (PR #115): Introduce local backend for single-machine persistent mode
  • #110 (PR #114): README v0.3 overhaul — hero + Tier 0/1/2 narrative
  • #111 (PR #118): Polish README Power users section
  • #112 (PR #117): Embedded zenoh router (Tier 1) — mesh start / mesh join
  • PR #120: Tier 1 actual mesh integration (post-merge fix for #117)
  • #75 (PR #102): Forward-compat _extras for unknown Observation fields
  • #84: kioku-mesh doctor diagnostic command
  • #85: kioku-mesh mcp install one-shot MCP registration
  • #86: kioku-mesh init --install-systemd
  • #82: client_id defaults to user@host
  • #76: Shell completion via argcomplete
  • #73: Observation.references field
  • #66: Bulk delete cursor pages past MAX_SEARCH
  • #53: CLI/MCP strings unified to English

Closes #90

Assets 2
Loading