What's Changed

chore: Cloud auth by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/213
docs: improve virtual environment setup instructions by @jope-bm in https://github.com/basicmachines-co/basic-memory/pull/222
fix: path traversal security vulnerability in mcp tools by @jope-bm in https://github.com/basicmachines-co/basic-memory/pull/223
fix: basic memory home env var not respected when project path is changed. by @jope-bm in https://github.com/basicmachines-co/basic-memory/pull/239
fix: handle missing 'name' key in memory JSON import by @jope-bm in https://github.com/basicmachines-co/basic-memory/pull/241
chore: minor cleanup by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/228
fix: replace recursive traversemessages with iterative approach to handle deep conversation threads by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/235
fix: enhance character conflict detection and error handling for sync operations by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/201

New Contributors

@jope-bm made their first contribution in https://github.com/basicmachines-co/basic-memory/pull/222

Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.14.2...v0.14.3

- Python
Published by github-actions[bot] 7 months ago

What's Changed

fix: replace deprecated datetime.utcnow() with timezone-aware alternatives and suppress SQLAlchemy warnings by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/211
fix: MCP Error with MCP-Hub #204 by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/212

Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.14.1...v0.14.2

- Python
Published by github-actions[bot] 8 months ago

What's Changed

feat: Add to cursor button by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/200
fix: Problems with MCP #190 by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/202
fix: constrain fastmcp version to prevent breaking changes by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/203

Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.14.0...v0.14.1

- Python
Published by github-actions[bot] 8 months ago

What's Changed

feat: add Docker container support with volume mounting by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/131
fix: fastmcp deprecation warning by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/150
fix: resolve project state inconsistency between MCP and CLI by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/149
fix: reset command now clears project configuration by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/152
feat: implement Docker CI workflow for automated image publishing by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/159
fix: scope entity queries by projectid in upsertentity method by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/168
fix: handle None from_entity in Context API RelationSummary by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/166
fix: ensure permalinks are generated for entities with null permalinks during move operations by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/162
feat: enhance move_note tool with cross-project detection and guidance by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/161
fix: respect BASICMEMORYHOME environment variable in Docker containers by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/174
fix: handle Boolean search syntax with hyphenated terms by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/180
test: add more tests for search_repository by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/181
fix: implement project-specific sync status checks for MCP tools by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/183
fix: preserve permalink when editing notes without frontmatter permalink by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/184
feat: enhance search_notes tool documentation with comprehensive syntax examples by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/186

Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.13.7...v0.14.0

- Python
Published by github-actions[bot] 8 months ago

What's Changed

fix: scope entity queries by projectid in upsertentity method by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/168
fix: handle None from_entity in Context API RelationSummary by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/166
fix: ensure permalinks are generated for entities with null permalinks during move operations by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/162
feat: enhance move_note tool with cross-project detection and guidance by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/161
fix: respect BASICMEMORYHOME environment variable in Docker containers by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/174
fix: handle Boolean search syntax with hyphenated terms by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/180
test: add more tests for search_repository by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/181
fix: implement project-specific sync status checks for MCP tools by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/183

Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.13.8-dev1...v0.14.0b1

- Python
Published by github-actions[bot] 8 months ago

What's Changed

feat: add Docker container support with volume mounting by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/131
fix: fastmcp deprecation warning by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/150
fix: resolve project state inconsistency between MCP and CLI by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/149
fix: reset command now clears project configuration by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/152
feat: implement Docker CI workflow for automated image publishing by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/159

Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.13.7...v0.13.8-dev1

- Python
Published by github-actions[bot] 8 months ago

What's Changed

feat: Automatically update Homebrew by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/147

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

- Python
Published by github-actions[bot] 8 months ago

basic-memory - v0.13.6

What's Changed

fix: correct spelling error "Chose" to "Choose" in continue_conversation prompt by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/141
fix: UNIQUE constraint failed: entity.permalink issue #139 by @groksrc in https://github.com/basicmachines-co/basic-memory/pull/140
fix: add entitytype parameter to writenote MCP tool by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/145
fix: eliminate redundant database migration initialization by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/146

New Contributors

@groksrc made their first contribution in https://github.com/basicmachines-co/basic-memory/pull/141

Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.13.5...v0.13.6

- Python
Published by github-actions[bot] 8 months ago

basic-memory - v0.13.5

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: https://github.com/basicmachines-co/basic-memory/compare/v0.13.4...v0.13.5

- Python
Published by github-actions[bot] 8 months ago

basic-memory - v0.13.4

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: https://github.com/basicmachines-co/basic-memory/compare/v0.13.3...v0.13.4

- Python
Published by github-actions[bot] 8 months ago

basic-memory - v0.13.3

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: https://github.com/basicmachines-co/basic-memory/compare/v0.13.2...v0.13.3

- Python
Published by github-actions[bot] 8 months ago

basic-memory - v0.13.2

What's Changed

fix: project cli commands and case sensitivity when switching projects by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/130

Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.13.1...v0.13.2

- Python
Published by github-actions[bot] 8 months ago

basic-memory - v0.13.1

Bug Fixes

CLI: Fixed basic-memory project project management commands that were not working in v0.13.0 (#129)
Projects: Resolved case sensitivity issues when switching between projects that caused "Project not found" errors (#127)
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: https://github.com/basicmachines-co/basic-memory/compare/v0.13.0...v0.13.1

- Python
Published by github-actions[bot] 8 months ago

basic-memory - v0.13.0

What's Changed

Overview

Basic Memory v0.13.0 is a major release that transforms Basic Memory into a true multi-project knowledge management system. This release introduces fluid project switching, advanced note editing capabilities, and robust file management - all while maintaining full backward compatibility.

What's New for Users: - 🎯 Switch between projects instantly during conversations with Claude - ✏️ Edit notes incrementally without rewriting entire documents - 📁 Move and organize notes with full database consistency - 📖 View notes as formatted artifacts for better readability in Claude Desktop - 🔍 Search frontmatter tags to discover content more easily - ⚡ Development builds automatically published for beta testing

Key v0.13.0 Accomplishments: - ✅ Complete Project Management System - Project switching and project-specific operations - ✅ Advanced Note Editing - Incremental editing with append, prepend, find/replace, and section operations
- ✅ View Notes as Artifacts in Claude Desktop/Web - Use the view_note tool to view a note as an artifact - ✅ File Management System - Full move operations with database consistency and rollback protection - ✅ Enhanced Search Capabilities - Frontmatter tags now searchable, improved content discoverability - ✅ Unified Database Architecture - Single app-level database for better performance and project management

Major Features

1. Multiple Project Management

Switch between projects instantly during conversations:

``` 💬 "What projects do I have?" 🤖 Available projects: • main (current, default) • work-notes • personal-journal • code-snippets

💬 "Switch to work-notes" 🤖 ✓ Switched to work-notes project

Project Summary: • 47 entities • 125 observations
• 23 relations

💬 "What did I work on yesterday?" 🤖 [Shows recent activity from work-notes project] ```

Key Capabilities: - Instant Project Switching: Change project context mid-conversation without restart - Project-Specific Operations: Operations work within the currently active project context - Project Discovery: List all available projects with status indicators - Session Context: Maintains active project throughout conversation - Backward Compatibility: Existing single-project setups continue to work seamlessly

2. Advanced Note Editing

Edit notes incrementally without rewriting entire documents:

```python

Append new sections to existing notes

edit_note("project-planning", "append", "\n## New Requirements\n- Feature X\n- Feature Y")

Prepend timestamps to meeting notes

edit_note("meeting-notes", "prepend", "## 2025-05-27 Update\n- Progress update...")

Replace specific sections under headers

editnote("api-spec", "replacesection", "New implementation details", section="## Implementation")

Find and replace with validation

editnote("config", "findreplace", "v0.13.0", findtext="v0.12.0", expectedreplacements=2) ```

Key Capabilities: - Append Operations: Add content to end of notes (most common use case) - Prepend Operations: Add content to beginning of notes - Section Replacement: Replace content under specific markdown headers - Find & Replace: Simple text replacements with occurrence counting - Smart Error Handling: Helpful guidance when operations fail - Project Context: Works within the active project with session awareness

3. Smart File Management

Move and organize notes:

```python

Simple moves with automatic folder creation

move_note("my-note", "work/projects/my-note.md")

Organize within the active project

move_note("shared-doc", "archive/old-docs/shared-doc.md")

Rename operations

move_note("old-name", "same-folder/new-name.md") ```

Key Capabilities: - Database Consistency: Updates file paths, permalinks, and checksums automatically - Search Reindexing: Maintains search functionality after moves - Folder Creation: Automatically creates destination directories - Project Isolation: Operates within the currently active project - Link Preservation: Maintains internal links and references

4. Enhanced Search & Discovery

Find content more easily with improved search capabilities:

Frontmatter Tag Search: Tags from YAML frontmatter are now indexed and searchable
Improved Content Discovery: Search across titles, content, tags, and metadata
Project-Scoped Search: Search within the currently active project
Better Search Quality: Enhanced FTS5 indexing with tag content inclusion

Example:

```yaml

title: Coffee Brewing Methods

tags: [coffee, brewing, equipment]

``` Now searchable by: "coffee", "brewing", "equipment", or "Coffee Brewing Methods"

5. Unified Database Architecture

Single app-level database for better performance and project management:

Migration from Per-Project DBs: Moved from multiple SQLite files to single app database
Project Isolation: Proper data separation with project_id foreign keys
Better Performance: Optimized queries and reduced file I/O

Complete MCP Tool Suite

New Project Management Tools

list_projects() - Discover and list all available projects with status
switch_project(project_name) - Change active project context during conversations
get_current_project() - Show currently active project with statistics
set_default_project(project_name) - Update default project configuration
sync_status() - Check file synchronization status and background operations

New Note Operations Tools

edit_note() - Incremental note editing (append, prepend, find/replace, section replace)
move_note() - Move notes with database consistency and search reindexing
view_note() - Display notes as formatted artifacts for better readability in Claude Desktop

Enhanced Existing Tools

All existing tools now support: - Session context awareness (operates within the currently active project) - Enhanced error messages with project context metadata - Improved response formatting with project information footers - Project isolation ensures operations stay within the correct project boundaries

User Experience Improvements

Installation Options

Multiple ways to install and test Basic Memory:

```bash

Stable release

uv tool install basic-memory

Beta/pre-releases

uv tool install basic-memory --pre ```

Bug Fixes & Quality Improvements

Major issues resolved in v0.13.0:

#118: Fixed YAML tag formatting to follow standard specification
#110: Fixed --project flag consistency across all CLI commands
#107: Fixed write_note update failures with existing notes
#93: Fixed custom permalink handling in frontmatter
#52: Enhanced search capabilities with frontmatter tag indexing
FTS5 Search: Fixed special character handling in search queries
Error Handling: Improved error messages and validation across all tools

Breaking Changes & Migration

For Existing Users

Automatic Migration: First run will automatically migrate existing data to the new unified database structure. No manual action required.

What Changes: - Database location: Moved to ~/.basic-memory/memory.db (unified across projects) - Configuration: Projects defined in ~/.basic-memory/config.json are synced with database

What Stays the Same: - All existing notes and data remain unchanged - Default project behavior maintained for single-project users - All existing MCP tools continue to work without modification

Documentation & Resources

New Documentation

Project Management Guide - Multi-project workflows
Note Editing Guide - Advanced editing techniques

Updated Documentation

README.md - Installation options and beta build instructions
CONTRIBUTING.md - Release process and version management
CLAUDE.md - Development workflow and CI/CD documentation
Claude.ai Integration - Updated MCP tool examples

Quick Start Examples

Project Switching: 💬 "Switch to my work project and show recent activity" 🤖 [Calls switch_project("work") then recent_activity()]

Note Editing: 💬 "Add a section about deployment to my API docs" 🤖 [Calls edit_note("api-docs", "append", "## Deployment\n...")]

File Organization: 💬 "Move my old meeting notes to the archive folder" 🤖 [Calls move_note("meeting-notes", "archive/old-meetings.md")] Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.12.3...v0.13.0

- Python
Published by github-actions[bot] 8 months ago

basic-memory - v0.13.0b6

Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.13.0b5...v0.13.0b6

- Python
Published by github-actions[bot] 9 months ago

basic-memory - v0.13.0b5

Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.13.0b4...v0.13.0b5

- Python
Published by github-actions[bot] 9 months ago

basic-memory - v0.13.0b4

Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.13.0b3...v0.13.0b4

- Python
Published by github-actions[bot] 9 months ago

basic-memory - v0.13.0b3

Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.13.0b2...v0.13.0b3

- Python
Published by github-actions[bot] 9 months ago

basic-memory - v0.13.0b2

Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.13.0b1...v0.13.0b2

- Python
Published by github-actions[bot] 9 months ago

basic-memory - v0.13.0b1

What's Changed

feat: Multi-project support, OAuth authentication, and major improvements by @bm-claudeai in https://github.com/basicmachines-co/basic-memory/pull/119
feat: Add Claude Code GitHub Workflow by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/120
feat: v0.13.0 pre by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/122

Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.12.3...v0.13.0b1

- Python
Published by github-actions[bot] 9 months ago

basic-memory - v0.12.3

v0.12.3 (2025-04-17)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Add extra logic for permalink generation with mixed Latin unicode and Chinese characters (73ea91f)

- Modify recent_activity args to be strings instead of enums (`3c1cc34`)

Detailed Changes: v0.12.2...v0.12.3

What's Changed

Update name of function search_notes in error output by @AmadeusW in https://github.com/basicmachines-co/basic-memory/pull/92
fix: preserve Chinese characters in permalinks by @andyxinweiminicloud in https://github.com/basicmachines-co/basic-memory/pull/103
fix: add extra logic for permalink generation with mixed Latin unicode and Chinese characters by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/104
fix: relax recent_activity args by @phernandez in https://github.com/basicmachines-co/basic-memory/pull/105

New Contributors

@AmadeusW made their first contribution in https://github.com/basicmachines-co/basic-memory/pull/92
@andyxinweiminicloud made their first contribution in https://github.com/basicmachines-co/basic-memory/pull/103

Full Changelog: https://github.com/basicmachines-co/basic-memory/compare/v0.12.2...v0.12.3

- Python
Published by github-actions[bot] 10 months ago

basic-memory - v0.12.2

v0.12.2 (2025-04-08)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Utf8 for all file reads/write/open instead of default platform encoding (#91, 2934176)

Signed-off-by: phernandez paul@basicmachines.co

Detailed Changes: v0.12.1...v0.12.2

- Python
Published by github-actions[bot] 11 months ago

basic-memory - v0.12.1

v0.12.1 (2025-04-07)

This release is published under the AGPL-3.0-or-later License.

This is a bug fix release.

Bug Fixes

Run migrations and sync when starting mcp (#88, 78a3412)

Detailed Changes: v0.12.0...v0.12.1

- Python
Published by github-actions[bot] 11 months ago

basic-memory - v0.12.0

v0.12.0 (2025-04-06)

This release is published under the AGPL-3.0-or-later License.

This release fixes all reported bugs from the project issues and adds extra config options for - updating permalinks when a file is moved (default False) - syncing in real time when the mcp process starts (default True)

Note: - The real time sync means that it is no longer necessary to run the basic-memory sync --watch process in a a terminal to sync changes to the db (so the AI can see them). This will be done automatically.

The config file for Basic Memory is in the home directory under .basic-memory/config.json.

To change the properties, set the following values: ~/.basic-memory/config.json { "sync_changes": true, "update_permalinks_on_move": true }

Thanks for using Basic Memory!

Bug Fixes

Fix extra # character accumulation in markdown frontmatter tags prop (#79, 6c19c9e)
Fix cursor errors calling search tool (#78, 9d581ce)
Some notes never exit "modified" status (#77, 7930ddb)
Fix write_note Tool Fails to Update Existing Files in Some Situations (absolute paths). (#80, 9bff1f7)
Set default mcp log level to ERROR (#81, 248214c)
Write_note preserves frontmatter fields in content (#84, 3f4d9e4)

Documentation

Add VS Code instructions to README (#76, 43cbb7b)
Updated basicmachines.co links to be https (#69, 40ea28b)

Features

Add watch to mcp process (#83, 00c8633)
Permalink enhancements (#82, 617e60b)
- Avoiding "useless permalink values" for files without metadata
- Enable permalinks to be updated on move via config setting

Detailed Changes: v0.11.0...v0.12.0

- Python
Published by github-actions[bot] 11 months ago

basic-memory - v0.11.0

v0.11.0 (2025-03-29)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

delete db/recreate for reset db instead of using migrations. (#65, 0743ade)
Make logs for each process - mcp, sync, cli (#64, f1c9570)

Documentation

Update broken "Multiple Projects" link in README.md (#55, 3c68b7d)

Features

Add bm command alias for basic-memory (#67, 069c0a2)
Rename search tool to search_notes (#66, b278276)

Detailed Changes: v0.10.1...v0.11.0

- Python
Published by github-actions[bot] 11 months ago

basic-memory - v0.10.1

v0.10.1 (2025-03-25)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Make setdefaultproject also activate project for current session to fix #37 (cbe72be)
Move aiassistantguide.md into package resources to fix #39 (390ff9d)
Preserve custom frontmatter fields when updating notes (78f234b)

Chores

Remove duplicate code in entity_service.py from bad merge (681af5d)

Documentation

Add help docs to mcp cli tools (731b502)
Add mcp badge, update cli reference, llms-install.md (b26afa9)
Update CLAUDE.md (#33, dfaf0fe)

Refactoring

Move project stats into project subcommand (2a881b1)

Detailed Changes: v0.10.0...v0.10.1

- Python
Published by github-actions[bot] 11 months ago

basic-memory - v0.10.0

v0.10.0 (2025-03-15)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Don't sync *.tmp files on watch (#31, 6b110b2)
Drop search_index table on db reindex (31cca6f)
Improve utf-8 support for file reading/writing (#32, eb5e4ec)

Documentation

Add glama badge. Fix typos in README.md (#28, 9af913d)
Update CLAUDE.md with GitHub integration capabilities (#25, fea2f40)

Features

Add Smithery integration for easier installation (#24, eb1e7b6)

Detailed Changes: v0.9.0...v0.10.0

- Python
Published by github-actions[bot] 11 months ago

basic-memory - v0.9.0

v0.9.0 (2025-03-07)

This release is published under the AGPL-3.0-or-later License.

Chores

Pre beta prep (#20, 6a4bd54)

fix: drop search_index table on db reindex

fix: airesourceguide.md path

chore: remove logfire

Signed-off-by: phernandez paul@basicmachines.co

Documentation

Update README.md and CLAUDE.md (182ec78)

Features

Add project_info tool (#19, d2bd75a)

Signed-off-by: phernandez paul@basicmachines.co

Beta work (#17, e6496df)

feat: Add multiple projects support

feat: enhanced read_note for when initial result is not found

fix: merge frontmatter when updating note

fix: handle directory removed on sync watch

Implement boolean search (#18, 90d5754)

Detailed Changes: v0.8.0...v0.9.0

- Python
Published by github-actions[bot] 12 months ago

basic-memory - v0.8.0

v0.8.0 (2025-02-28)

This release is published under the AGPL-3.0-or-later License.

Chores

Formatting (93cc637)
Refactor logging setup (f4b703e)

Features

Add enhanced prompts and resources (#15, 093dab5)

Summary - Add comprehensive documentation to all MCP prompt modules - Enhance search prompt with detailed contextual output formatting - Implement consistent logging and docstring patterns across prompt utilities - Fix type checking in prompt modules

Prompts Added/Enhanced - `search.py`: New formatted output with relevance scores, excerpts, and next steps - `recent_activity.py`: Enhanced with better metadata handling and documentation - `continue_conversation.py`: Improved context management

Resources Added/Enhanced - `ai_assistant_guide`: Resource with description to give to LLM to understand how to use the tools

Technical improvements - Added detailed docstrings to all prompt modules explaining their purpose and usage - Enhanced the search prompt with rich contextual output that helps LLMs understand results - Created a consistent pattern for formatting output across prompts - Improved error handling in metadata extraction - Standardized import organization and naming conventions - Fixed various type checking issues across the codebase

This PR is part of our ongoing effort to improve the MCP's interaction quality with LLMs, making the system more helpful and intuitive for AI assistants to navigate knowledge bases.

🤖 Generated with Claude Code

Co-authored-by: phernandez phernandez@basicmachines.co

Add new canvas tool to create json canvas files in obsidian. (#14, 0d7b0b3)

Add new canvas tool to create json canvas files in obsidian.

Co-authored-by: phernandez phernandez@basicmachines.co

Incremental sync on watch (#13, 37a01b8)
incremental sync on watch
sync non-markdown files in knowledge base
experimental read_resource tool for reading non-markdown files in raw form (pdf, image)

Detailed Changes: v0.7.0...v0.8.0

- Python
Published by github-actions[bot] 12 months ago

basic-memory - v0.7.0

v0.7.0 (2025-02-19)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Add logfire instrumentation to tools (3e8e3e8)
Add logfire spans to cli (00d23a5)
Add logfire spans to cli (812136c)
Search query pagination params (bc9ca07)

Chores

Fix tests (57984aa)
Remove unused tests (2c8ed17)

Features

Add cli commands for mcp tools (f5a7541)
Add pagination to buildcontext and recentactivity (0123544)
Add pagination to read_notes (02f8e86)

Detailed Changes: v0.6.0...v0.7.0

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.6.0

v0.6.0 (2025-02-18)

This release is published under the AGPL-3.0-or-later License.

Features

Configure logfire telemetry (#12, 6da1438)

Co-authored-by: phernandez phernandez@basicmachines.co

Detailed Changes: v0.5.0...v0.6.0

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.5.0

v0.5.0 (2025-02-18)

This release is published under the AGPL-3.0-or-later License.

Features

Return semantic info in markdown after write_note (#11, 0689e7a)

Co-authored-by: phernandez phernandez@basicmachines.co

Detailed Changes: v0.4.3...v0.5.0

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.4.3

v0.4.3 (2025-02-18)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Re do enhanced read note format (#10, 39bd5ca)

Co-authored-by: phernandez phernandez@basicmachines.co

Detailed Changes: v0.4.2...v0.4.3

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.4.2

v0.4.2 (2025-02-17)

This release is published under the AGPL-3.0-or-later License.

Detailed Changes: v0.4.1...v0.4.2

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.4.1

v0.4.1 (2025-02-17)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Fix alemic config (71de8ac)

Detailed Changes: v0.4.0...v0.4.1

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.4.0

v0.4.0 (2025-02-16)

This release is published under the AGPL-3.0-or-later License.

Features

Import chatgpt conversation data (#9, 56f47d6)

Co-authored-by: phernandez phernandez@basicmachines.co

Import claude.ai data (#8, a15c346)

Import Claude.ai conversation and project data to basic-memory Markdown format.

Co-authored-by: phernandez phernandez@basicmachines.co

Detailed Changes: v0.3.0...v0.4.0

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.3.0

v0.3.0 (2025-02-15)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Refactor db schema migrate handling (ca632be)

Detailed Changes: v0.2.21...v0.3.0

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.21

v0.2.21 (2025-02-15)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Fix osx installer github action (65ebe5d)

Detailed Changes: v0.2.20...v0.2.21

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.20

v0.2.20 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Fix installer artifact (8de84c0)

Detailed Changes: v0.2.19...v0.2.20

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.19

v0.2.19 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Get app artifact for installer (fe8c3d8)

Detailed Changes: v0.2.18...v0.2.19

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.18

v0.2.18 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Don't zip app on release (8664c57)

Detailed Changes: v0.2.17...v0.2.18

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.17

v0.2.17 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Fix app zip in installer release (8fa197e)

Detailed Changes: v0.2.16...v0.2.17

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.16

v0.2.16 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Debug inspect build on ci (1d6054d)

Detailed Changes: v0.2.15...v0.2.16

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.15

v0.2.15 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Debug installer ci (dab9573)

Detailed Changes: v0.2.14...v0.2.15

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.14

v0.2.14 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Detailed Changes: v0.2.13...v0.2.14

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.13

v0.2.13 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Refactor release.yml installer (a152657)

Detailed Changes: v0.2.12...v0.2.13

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.12

v0.2.12 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Fix cx_freeze options for installer (854cf83)

Detailed Changes: v0.2.11...v0.2.12

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.11

v0.2.11 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Ci installer app fix #37 (2e215fe)

Detailed Changes: v0.2.10...v0.2.11

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.10

v0.2.10 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Fix build on github ci for app installer (29a2594)

Detailed Changes: v0.2.9...v0.2.10

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.9

v0.2.9 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Detailed Changes: v0.2.8...v0.2.9

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.8

v0.2.8 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Detailed Changes: v0.2.7...v0.2.8

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.7

v0.2.7 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Detailed Changes: v0.2.6...v0.2.7

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.6

v0.2.6 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Bump project patch version (01d4672)

Detailed Changes: v0.2.5...v0.2.6

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.5

v0.2.5 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Refix vitual env in installer build (052f491)

Detailed Changes: v0.2.4...v0.2.5

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.4

v0.2.4 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Detailed Changes: v0.2.3...v0.2.4

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.3

v0.2.3 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Detailed Changes: v0.2.2...v0.2.3

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.2

v0.2.2 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Detailed Changes: v0.2.1...v0.2.2

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.1

v0.2.1 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Trigger installer build on release (f11bf78)

Detailed Changes: v0.2.0...v0.2.1

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.2.0

v0.2.0 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Features

Build installer via github action (#7, 7c381a5)
feat(ci): build installer via github action
enforce conventional commits in PR titles
feat: add icon to installer

Co-authored-by: phernandez phernandez@basicmachines.co

Detailed Changes: v0.1.2...v0.2.0

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.1.2

v0.1.2 (2025-02-14)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Fix installer for mac (dde9ff2)
Remove unused FileChange dataclass (eb3360c)
Update uv installer url (2f9178b)

Detailed Changes: v0.1.1...v0.1.2

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.1.1

v0.1.1 (2025-02-07)

This release is published under the AGPL-3.0-or-later License.

Detailed Changes: v0.1.0...v0.1.1

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.1.0

v0.1.0 (2025-02-07)

This release is published under the AGPL-3.0-or-later License.

Bug Fixes

Create virtual env in test workflow (8092e6d)
Fix permalink uniqueness violations on create/update/sync (135bec1)
Fix recent activity bug (3d2c0c8)
Install fastapi deps after removing basic-foundation (51a741e)
Remove basic-foundation from deps (b8d0c71)
Run tests via uv (4eec820)

Chores

Rename import tool (af6b7dc)

Features

Add memory-json importer, tweak observation content (3484e26)

Detailed Changes: v0.0.1...v0.1.0

- Python
Published by github-actions[bot] about 1 year ago

basic-memory - v0.0.1

v0.0.1 (2025-02-04)

Bug Fixes

Fix versioning for 0.0.1 release (ba1e494)

Detailed Changes: v0.0.0...v0.0.1

- Python
Published by github-actions[bot] about 1 year ago

Recent Releases of basic-memory

basic-memory - v0.14.3

What's Changed

New Contributors

basic-memory - v0.14.2

What's Changed

basic-memory - v0.14.1

What's Changed

basic-memory - v0.14.0

What's Changed

basic-memory - v0.14.0b1

What's Changed

basic-memory - v0.13.8-dev1

What's Changed

basic-memory - v0.13.7

What's Changed

basic-memory - v0.13.6

What's Changed

New Contributors

basic-memory - v0.13.5

Bug Fixes

Changes

basic-memory - v0.13.4

Bug Fixes

Changes

basic-memory - v0.13.3

Bug Fixes

basic-memory - v0.13.2

What's Changed

basic-memory - v0.13.1

Bug Fixes

Changes

basic-memory - v0.13.0

What's Changed

Overview

Major Features

1. Multiple Project Management

2. Advanced Note Editing

Append new sections to existing notes

Prepend timestamps to meeting notes

Replace specific sections under headers

Find and replace with validation

3. Smart File Management

Simple moves with automatic folder creation

Organize within the active project

Rename operations

4. Enhanced Search & Discovery

```yaml

tags: [coffee, brewing, equipment]

5. Unified Database Architecture

Complete MCP Tool Suite

New Project Management Tools

New Note Operations Tools

Enhanced Existing Tools

User Experience Improvements

Installation Options

Stable release

Beta/pre-releases

Bug Fixes & Quality Improvements

Breaking Changes & Migration

For Existing Users

Documentation & Resources

New Documentation

Updated Documentation

Quick Start Examples

basic-memory - v0.13.0b6

basic-memory - v0.13.0b5

basic-memory - v0.13.0b4

basic-memory - v0.13.0b3

basic-memory - v0.13.0b2

basic-memory - v0.13.0b1

What's Changed

basic-memory - v0.12.3

v0.12.3 (2025-04-17)

Bug Fixes

- Modify recent_activity args to be strings instead of enums (3c1cc34)

What's Changed

New Contributors

basic-memory - v0.12.2

v0.12.2 (2025-04-08)

- Modify recent_activity args to be strings instead of enums (`3c1cc34`)

Prompts Added/Enhanced - `search.py`: New formatted output with relevance scores, excerpts, and next steps - `recent_activity.py`: Enhanced with better metadata handling and documentation - `continue_conversation.py`: Improved context management

Resources Added/Enhanced - `ai_assistant_guide`: Resource with description to give to LLM to understand how to use the tools