View the latest changes to Basic Memory on GitHub

​
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