Skip to main content
View the latest changes to Basic Memory on GitHub

​
v0.14.2 — 2025-07-02

​
Bug Fixes

  • #204: Fix MCP Error with MCP-Hub integration (3621bb7)
    • Resolve compatibility issues with MCP-Hub
    • Improve error handling in project management tools
    • Ensure stable MCP tool integration across different environments
  • Modernize datetime handling and suppress SQLAlchemy warnings (f80ac0e)
    • Replace deprecated datetime.utcnow() with timezone-aware alternatives
    • Suppress SQLAlchemy deprecation warnings for cleaner output
    • Improve future compatibility with Python datetime best practices

​
v0.14.1 — 2025-07-01

​
Bug Fixes

  • #203: Constrain fastmcp version to prevent breaking changes (827f7cf)
    • Pin fastmcp to compatible version range to avoid API breaking changes
    • Ensure stable MCP server functionality across updates
    • Improve dependency management for production deployments
  • #190: Fix Problems with MCP integration (bd4f551)
    • Resolve MCP server initialization and communication issues
    • Improve error handling and recovery in MCP operations
    • Enhance stability for AI assistant integrations

​
Features

  • Add Cursor IDE integration button - One-click setup for Cursor IDE users (5360005)
    • Direct installation button for Cursor IDE in README
    • Streamlined setup process for Cursor users
    • Enhanced developer experience for AI-powered coding
  • Add Homebrew installation instructions - Official Homebrew tap support (39f811f)
    • Official Homebrew formula in basicmachines-co/basic-memory tap
    • Simplified installation process for macOS users
    • Package manager integration for easier dependency management

​
v0.14.0 — 2025-06-26

​
Features

  • Docker Container Registry Migration - Switch from Docker Hub to GitHub Container Registry for better security and integration (616c1f0)
    • Automated Docker image publishing via GitHub Actions CI/CD pipeline
    • Enhanced container security with GitHub’s integrated vulnerability scanning
    • Streamlined container deployment workflow for production environments
  • Enhanced Search Documentation - Comprehensive search syntax examples for improved user experience (a589f8b)
    • Detailed examples for Boolean search operators (AND, OR, NOT)
    • Advanced search patterns including phrase matching and field-specific queries
    • User-friendly documentation for complex search scenarios
  • Cross-Project File Management - Intelligent move operations with project boundary detection (db5ef7d)
    • Automatic detection of cross-project move attempts with helpful guidance
    • Clear error messages when attempting unsupported cross-project operations

​
Bug Fixes

  • #184: Preserve permalinks when editing notes without frontmatter permalinks (c2f4b63)
    • Fix permalink preservation during note editing operations
    • Ensure consistent permalink handling across different note formats
    • Maintain note identity and searchability during incremental edits
  • #183: Implement project-specific sync status checks for MCP tools (12b5152)
    • Fix sync status reporting to correctly reflect current project state
    • Resolve inconsistencies where sync status showed global instead of project-specific information
    • Improve project isolation for sync operations and status reporting
  • #180: Handle Boolean search syntax with hyphenated terms (546e3cd)
    • Fix search parsing issues with hyphenated terms in Boolean queries
    • Improve search query tokenization for complex term structures
    • Enhanced search reliability for technical documentation and multi-word concepts
  • #174: Respect BASIC_MEMORY_HOME environment variable in Docker containers (9f1db23)
    • Fix Docker container configuration to properly honor custom home directory settings
    • Improve containerized deployment flexibility with environment variable support
    • Ensure consistent behavior between local and containerized installations
  • #168: Scope entity queries by project_id in upsert_entity method (2a3adc1)
    • Fix entity isolation issues in multi-project setups
    • Prevent cross-project entity conflicts during database operations
    • Strengthen project boundary enforcement at the database level
  • #166: Handle None from_entity in Context API RelationSummary (8a065c3)
    • Fix null pointer exceptions in relation processing
    • Improve error handling for incomplete relation data
    • Enhanced stability for knowledge graph traversal operations
  • #164: Remove log level configuration from mcp_server.run() (224e4bf)
    • Simplify MCP server startup by removing redundant log level settings
    • Fix potential logging configuration conflicts
    • Streamline server initialization process
  • #162: Ensure permalinks are generated for entities with null permalinks during move operations (f506507)
    • Fix move operations for entities without existing permalinks
    • Automatic permalink generation during file move operations
    • Maintain database consistency during file reorganization

​
Technical Improvements

  • Comprehensive Test Coverage - Extensive test suites for new features and edge cases
    • Enhanced test coverage for project-specific sync status functionality
    • Additional test scenarios for search syntax validation and edge cases
    • Integration tests for Docker CI workflow and container publishing
    • Comprehensive move operations testing with project boundary validation
  • Docker CI/CD Pipeline - Production-ready automated container publishing (74847cc)
    • Automated Docker image building and publishing on release
    • Multi-architecture container support for AMD64 and ARM64 platforms
    • Integrated security scanning and vulnerability assessments
    • Streamlined deployment pipeline for production environments
  • Release Process Improvements - Enhanced automation and quality gates (a52ce1c)
    • Homebrew formula updates limited to stable releases only
    • Improved release automation with better quality control
    • Enhanced CI/CD pipeline reliability and error handling
  • Code Quality Enhancements - Improved error handling and validation
    • Better null safety in entity and relation processing
    • Enhanced project isolation validation throughout the codebase
    • Improved error messages and user guidance for edge cases
    • Strengthened database consistency guarantees across operations

​
Infrastructure

  • GitHub Container Registry Integration - Modern container infrastructure
    • Migration from Docker Hub to GitHub Container Registry (ghcr.io)
    • Improved security with integrated vulnerability scanning
    • Better integration with GitHub-based development workflow
    • Enhanced container versioning and artifact management
  • Enhanced CI/CD Workflows - Robust automated testing and deployment
    • Automated Docker image publishing on releases
    • Comprehensive test coverage validation before deployment
    • Multi-platform container building and publishing
    • Integration with GitHub’s security and monitoring tools

​
Migration Guide

This release includes several behind-the-scenes improvements and fixes. All changes are backward compatible:
  • Docker Users: Container images now served from ghcr.io/basicmachines-co/basic-memory instead of Docker Hub
  • Search Users: Enhanced search syntax handling - existing queries continue to work unchanged
  • Multi-Project Users: Improved project isolation - all existing projects remain fully functional
  • All Users: Enhanced stability and error handling - no breaking changes to existing workflows

​
Installation

# Latest stable release
uv tool install basic-memory

# Update existing installation
uv tool upgrade basic-memory

# Docker (new registry)
docker pull ghcr.io/basicmachines-co/basic-memory:latest
Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.13.7…v0.14.0

​
v0.13.7 — 2025-06-18

​
What’s Changed

NOTE: This version is the same package as v0.13.6. The version bump is to test the CI and make sure the Homebrew auto-update process is completely working. Installation by Homebrew is now fully supported. Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.13.6…v0.13.7

​
v0.13.6 — 2025-06-18

Bug Fixes

​
New Contributors

Full Changelog

​
v0.13.5 — 2025-06-12

Bug Fixes
  • MCP Tools: Renamed create_project tool to create_memory_project for namespace isolation
  • Namespace: Continued namespace isolation effort to prevent conflicts with other MCP servers
Changes
  • Tool functionality remains identical – only the name changed from create_project to create_memory_project
  • All integration tests updated to use the new tool name
  • Completes namespace isolation for project management tools alongside list_memory_projects
Full Changelog

​
v0.13.4 — 2025-06-12

Bug Fixes
  • MCP Tools: Renamed list_projects tool to list_memory_projects to avoid naming conflicts with other MCP servers
  • Namespace: Improved tool naming specificity for better MCP server integration and isolation
Changes
  • Tool functionality remains identical – only the name changed from list_projects to list_memory_projects
  • All integration tests updated to use the new tool name
  • Better namespace isolation for Basic Memory MCP tools
Full Changelog

​
v0.13.3 — 2025-06-12

Bug Fixes
  • Projects: Fixed case-insensitive project switching where switching succeeded but subsequent operations failed due to session state inconsistency
  • Config: Enhanced config manager with case-insensitive project lookup using permalink-based matching
  • MCP Tools: Updated project management tools to store canonical project names from database instead of user input
  • API: Improved project service to handle both name and permalink lookups consistently
Full Changelog

​
v0.13.2 — 2025-06-11

What’s Changed
  • fix: project cli commands and case sensitivity when switching projects by @phernandez
Full Changelog

​
v0.13.1 — 2025-06-11

Bug Fixes
  • CLI: Fixed basic-memory project project management commands that were not working in v0.13.0
  • Projects: Resolved case sensitivity issues when switching between projects that caused “Project not found” errors
  • API: Standardized CLI project command endpoints and improved error handling
  • Core: Implemented consistent project name handling using permalinks to avoid case-related conflicts
Changes
  • Renamed basic-memory project sync command to basic-memory project sync-config for clarity
  • Improved project switching reliability across different case variations
  • Removed redundant server status messages from CLI error outputs
Full Changelog