Features
- Add move-project-to-workspace and workspace reparenting - Move projects between workspaces and reparent workspaces in the hierarchy
MoveProjectToWorkspaceAsyncatomically moves a project and all its descendants to a target workspace- Workspace reparenting with circular-reference guard to prevent invalid hierarchies
- Full support across REST API, MCP tools, and Web UI with modal dialogs
- Add canonical URL support to MCP tool responses - MCP tool responses now include clickable URLs to the web UI for memories, workspaces, and projects
- Configure via
Server:CanonicalUrlsetting to enable links in MCP responses - URLs included in
Store,Get,SearchMemories,GetMany,CreateWorkspace,CreateProject,GetWorkspace, andGetProjectContextresponses
- Configure via
Bug Fixes
- Make optional Guid MCP parameters resilient to client schema variations - Fixes compatibility with MCP clients (notably Cursor) that send empty strings or
"null"for optional Guid parameters instead of proper JSON null
Features
- Improve search quality with hybrid text + vector search - Combines PostgreSQL full-text search with vector similarity search using Reciprocal Rank Fusion (RRF) to dramatically improve search relevance
- Queries like "race condition", "phobos", and "dependency injection" that previously returned zero results now surface relevant matches
- AND-prefix FTS matching handles stemming mismatches (e.g., "postgres" matches "postgresql")
- Adaptive weighting favors text matching for short queries, both methods equally for longer queries
- Workspace and project search also use hybrid approach for better name matching
- New database migration adds
search_vectortsvector column with GIN index
Bug Fixes
- Fix inconsistent memory counts by excluding system memories from user-facing queries - Memory list and stats no longer inflate counts with internal system index memories
Updates
Improvements
- Add link to homepage on sidebar Memorizer logo - Sidebar logo is now clickable and navigates to the Memorizer homepage
Bug Fixes
- Fix Docker commands in README for PostgreSQL backup - Corrected container name from
memorizer-postgrestopostgmem-postgresin backup instructions
Documentation
- Add commands reference documentation for Memorizer - New reference guide documenting all available Memorizer commands
- Update README with detailed update instructions - Added step-by-step bash commands for the upgrade process
Major Release - Memorizer V2 Merge
This release merges all Memorizer V2 features into the open-source repository, bringing significant new capabilities for organizing and managing AI agent memories.
Caution
Back up your database before upgrading. Memorizer 2.0 runs automatic schema migrations on startup that alter tables and add new columns. These migrations are not reversible. Create a pg_dump of your database before pulling the new image. See the Upgrading to Memorizer 2.0 section in the README for backup instructions.
Breaking Changes
- MCP endpoint moved from
/to/mcp. Update client configs fromhttp://localhost:5000tohttp://localhost:5000/mcp - Web UI moved from
/uito/. The Web UI is now at the root path.
New Features
- Workspaces: Organize memories into isolated workspaces with independent configurations
- Projects: Group related memories within workspaces for better organization
- Provider Settings: Configure AI providers (embedding models, LLM endpoints) per-workspace
- Structured Memory Types: Support for documents, records, and references with distinct behaviors
- Memory Archiving: Archive memories instead of deleting them, with restore capability
- System Memories: Hidden system index memories for semantic project/workspace search
- Unit Tests: New unit test project for core domain logic
Database Migrations
- Migrations 011-019 run automatically on startup
- Existing V1 databases will be upgraded seamlessly with new tables for workspaces, projects, provider settings, and structured memory types
V2 Release History (from private development)
- 2.0.9: Fix broken navigation links, add Archetype field to MemorySummaryDto
- 2.0.8: Fix archived memories filtering, add archetype visibility to MCP tools
- 2.0.7: Add system memories for semantic project/workspace search
Features
- Add memory versioning with full audit trail and diff support - Comprehensive version tracking system that records all changes to memories with complete history
- Edit Tool: Targeted text replacements with automatic version snapshots
- UpdateMetadata Tool: Update memory metadata (type, tags, confidence, title) without changing content
- RevertToVersion Tool: Restore previous versions of memories
- Visual Diffs: Line-by-line comparison between versions in Web UI
- Event Audit Log: Complete operation history for compliance and debugging
- Add memory similarity discovery feature - Surface related memories using vector similarity search with optional relationship persistence
- On-demand similarity queries with configurable threshold (50-95%)
- UI slider to adjust similarity sensitivity
- Create bidirectional
similar-torelationships with scores - Helps evaluate embedding model quality and build knowledge graphs
- Add automatic embedding dimension detection and migration - Automatically detect and migrate embeddings when switching between models with different dimensions
- Detects dimension mismatches at startup
- Provides UI warnings and migration tools
- Preserves existing data during model transitions
Improvements
- Switch search and similarity to use metadata embeddings - MCP search and similarity discovery now use metadata embeddings (title + tags) instead of full content embeddings for significantly better keyword query results
- Treats metadata as higher weight than body content for similarity matching
- Aligns MCP tool behavior with web UI search
- Add lightweight search results to optimize context window usage - MCP search returns lightweight results by default to prevent swamping agent context windows
- Returns ID, title, type, tags, similarity score, and creation date
- Agents use
GetorGetManytools to retrieve full content as needed - Configurable via
Search:ReturnFullContentsetting (default:false)
Bug Fixes
- Rename Search tool to SearchMemories - Fixes compatibility issues with Qwen Code CLI and Gemini that disallow tools named "search"
- Fix version history display and add version selector to compare view - Improved version history UI with proper comparison capabilities
- Fix dimension migration bugs and add integration tests - Resolved issues with embedding dimension migration process
- Fix warning button text visibility in dark mode - Dimension mismatch warning button now visible in dark theme
Documentation
- Add Qwen3 embedding models and reorganize README - Updated embedding model documentation with Qwen3 support
- Add embedding documentation links to README - Improved documentation for embedding configuration
Updates
- Bump Npgsql from 9.0.4 to 10.0.0 - Major PostgreSQL driver update with performance improvements
- Bump Microsoft.AspNetCore.Mvc.Testing from 9.0.10 to 10.0.0 - Updated to .NET 10 testing framework
- Bump OpenTelemetry.Instrumentation.AspNetCore from 1.12.0 to 1.14.0
- Bump OpenTelemetry.Instrumentation.Http from 1.12.0 to 1.14.0
- Bump OpenTelemetry.Instrumentation.Runtime from 1.12.0 to 1.14.0
- Bump OpenTelemetry.Exporter.OpenTelemetryProtocol from 1.12.0 to 1.14.0
- Bump OpenTelemetry.Extensions.Hosting from 1.12.0 to 1.14.0
- Bump OllamaSharp from 5.3.6 to 5.4.11 - Latest model support
- Bump Akka.Streams from 1.5.55 to 1.5.56
- Bump Microsoft.NET.Test.Sdk from 18.0.0 to 18.0.1
- Bump DiffPlex from 1.7.2 to 1.9.0
- Bump xunit.runner.visualstudio from 3.1.4 to 3.1.5
- Bump Registrator.Net from 3.1.0 to 3.2.4
Improvements
- Switch search and similarity to use metadata embeddings - MCP search and similarity discovery now use metadata embeddings (title + tags) instead of full content embeddings for significantly better keyword query results
- Treats metadata as higher weight than body content for similarity matching
- Aligns MCP tool behavior with web UI search
- Add lightweight search results to optimize context window usage - MCP search returns lightweight results by default to prevent swamping agent context windows
- Returns ID, title, type, tags, similarity score, and creation date
- Agents use
GetorGetManytools to retrieve full content as needed - Configurable via
Search:ReturnFullContentsetting (default:false)
Bug Fixes
- Fix warning button text visibility in dark mode - Dimension mismatch warning button now visible in dark theme
Updates
Features
- Add memory similarity discovery feature - Surface related memories using vector similarity search with optional relationship persistence
- On-demand similarity queries with configurable threshold (50-95%)
- UI slider to adjust similarity sensitivity
- Create bidirectional
similar-torelationships with scores - Helps evaluate embedding model quality and build knowledge graphs
- Add automatic embedding dimension detection and migration - Automatically detect and migrate embeddings when switching between models with different dimensions
- Detects dimension mismatches at startup
- Provides UI warnings and migration tools
- Preserves existing data during model transitions
Bug Fixes
- Fix version history display and add version selector to compare view - Improved version history UI with proper comparison capabilities
- Fix dimension migration bugs and add integration tests - Resolved issues with embedding dimension migration process
Documentation
- Add Qwen3 embedding models and reorganize README - Updated embedding model documentation with Qwen3 support
- Add embedding documentation links to README - Improved documentation for embedding configuration
Features
- Add memory versioning with full audit trail and diff support - Comprehensive version tracking system that records all changes to memories with complete history
- Edit Tool: Targeted text replacements with automatic version snapshots
- UpdateMetadata Tool: Update memory metadata (type, tags, confidence, title) without changing content
- RevertToVersion Tool: Restore previous versions of memories
- Visual Diffs: Line-by-line comparison between versions in Web UI
- Event Audit Log: Complete operation history for compliance and debugging
Bug Fixes
- Rename Search tool to SearchMemories - Fixes compatibility issues with Qwen Code CLI and Gemini that disallow tools named "search"
Updates
- Bump Npgsql from 9.0.4 to 10.0.0 - Major PostgreSQL driver update with performance improvements
- Bump Microsoft.AspNetCore.Mvc.Testing from 9.0.10 to 10.0.0 - Updated to .NET 10 testing framework
- Updated OpenTelemetry packages to 1.14.0 for improved observability
- Updated OllamaSharp from 5.3.6 to 5.4.11 for latest model support
- Updated Akka.Streams from 1.5.55 to 1.5.56
- Updated Microsoft.NET.Test.Sdk from 18.0.0 to 18.0.1
Features
- Unified Embedding Regeneration Tool - Regenerate embeddings for both memory content and metadata, enabling model changes and dimension updates without data loss
- .NET 10 SSE support - Upgraded to .NET 10 with improved Server-Sent Events capabilities for real-time progress tracking
- Add Mermaid.js support and dark/light theme switcher - Enhanced documentation visualization with Mermaid diagrams and automatic theme detection
Updates
- Updated Model Context Protocol (MCP) packages to 0.4.0-preview.3 - Latest MCP protocol improvements and bug fixes
- Updated Akka.NET and .NET dependencies to latest versions - Including Akka.Persistence.Sql.Hosting, Akka.Hosting, Akka.Hosting.TestKit, and Microsoft.NET.Test.Sdk
Bug Fixes
- Fix footer link styling in light and dark themes - Improved visibility and consistency of footer links across themes
Breaking Changes
- MCP Endpoint Configuration Updated: The recommended MCP endpoint has changed from
/sseto the root path/to use modern Streamable HTTP transport (MCP spec 2025-03-26+)- Before:
"url": "http://localhost:5000/sse" - After:
"url": "http://localhost:5000" - The
/sseendpoint still works for backward compatibility but is no longer recommended - Update MCP endpoint from /sse to root path for Streamable HTTP
- Before:
Bug Fixes
- Enable stateless mode for MCP HTTP transport - Fixes "Session not found" errors when clients reconnect or server restarts by enabling sessionless operation
Updates
- Bump ModelContextProtocol from 0.3.0-preview.4 to 0.4.0-preview.2 - Fixes server notification bugs and improves protocol compatibility
- Bump ModelContextProtocol.AspNetCore from 0.3.0-preview.4 to 0.4.0-preview.2 - Adds Streamable HTTP transport support
Features
- Add configurable CORS support for MCP SSE endpoints - Enables MCP clients to connect with customizable CORS policies
- Make embedding dimensions configurable - Support different embedding models via
Dimensionssetting
Updates
- Bump all MSFT dependencies to 9.0.9 - Updated to .NET 9 framework
- Bump ModelContextProtocol from 0.3.0-preview.3 to 0.3.0-preview.4 - Framework improvements and bug fixes
- Bump ModelContextProtocol.AspNetCore from 0.3.0-preview.3 to 0.3.0-preview.4 - Framework improvements and bug fixes