Skip to main content

Current Release

Current package documentation for localnest-mcp@0.3.0-beta.2, covering the modernization update, interactive TUI dashboard, refactored CLI infrastructure, and the active canonical localnest_* tool contract.

Channel

Beta release track

Use this page when you need docs that match the modernizing LocalNest experience.

Package

Beta package

Use this page for the interactive TUI and refactored CLI contracts.

Current

0.3.0-beta.2 — The Modernization Update

Full visual overhaul with a premium ANSI styling engine, interactive TUI dashboard, and structured diagnostics.

Install BetaInstall using npm install -g localnest-mcp@beta to get the modernization update.Configure MCPUse the generated MCP block, supported client setup, and startup timeout guidance.Stable: 0.1.0See the archived 0.1.0 release notes for the production-ready stable track.

What it includes​

  • Modern Interactive CLI with a premium design language
  • Interactive TUI Dashboard for real-time monitoring
  • 74 MCP tools across KG, nests, traversal, diary, ingest, dedup, and hooks
  • lexical, semantic, and hybrid retrieval
  • temporal knowledge graph with multi-hop traversal
  • nest/branch hierarchy for organized memory
  • agent-scoped memory with private diary entries
  • semantic dedup and conversation ingestion
  • hooks system for pre/post operation callbacks
  • opt-in local memory tools plus high-level task-context and capture-outcome workflow
  • setup-time memory consent and config migration
  • localnest top-level CLI command path (dashboard, setup, doctor, upgrade)

What changed in 0.3.0-beta.2​

  • Visual Overhaul: Replaced hardcoded escape sequences with a centralized ANSI styling utility.
  • TUI Dashboard: Added a real-time terminal interface to monitor the LocalNest state.
  • Structured Help: Refactored all help renderers to use premium box-drawing and badges.
  • Diagnostic Upgrade: Redesigned localnest doctor with categorized checks and status symbols.
  • Automation Ready: Standardized --json and --quiet flags across the entire CLI.

Upgrade Snapshot​

If you are upgrading from 0.1.0

Expected user-facing changes

The CLI output is now much cleaner and more structured. Tool names and API contracts are fully preserved. Config is automatically migrated.

If you are validating a fresh install

Fastest verification path

Run localnest dashboard to see the state of your nest, or localnest doctor --verbose for a full health scan.

How to use this page​

  • Treat this page as the source of truth for the current beta track behavior.
  • Use the Release Matrix when you need to see exactly when a feature was introduced.
  • Use archived release pages when you need a frozen contract for debugging older installs.

Need a Different Release View?​

  • Use Version Selection when you need exact install commands.
  • Use Release Matrix when you need the full release-to-page mapping.
  • Use 0.1.0 for the initial TypeScript migration.
  • Use 0.0.7-beta.2 for the archived beta with knowledge graph and traversal.

Version Source​

This page is based on the current beta package version and maintained changelog in the repository.

  • package version: 0.3.0-beta.2
  • release date: 2026-04-13
  • changelog sections document the changes shipped in this beta package
  • production-ready stable published release docs remain archived under 0.1.0