Skip to content

Commit 8e65854

Browse files
groksrcclaude
andauthored
docs: add v0.18.0 release notes (#9)
- Add v0.18.0 release notes with context-aware wiki link resolution, directory operations, and cloud routing improvements - Add v0.17.8-v0.17.9 release notes (cloud snapshot CLI, bug fixes) - Update whats-new page with v0.18.0 feature highlights - Update CLAUDE.md current version to v0.18.0 Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 4704214 commit 8e65854

File tree

3 files changed

+131
-10
lines changed

3 files changed

+131
-10
lines changed

CLAUDE.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ This is the documentation website for Basic Memory (`docs.basicmemory.com`), bui
1212

1313
**Repository**: https://github.com/basicmachines-co/basic-memory
1414
**Website**: https://basicmemory.com
15-
**Current Version**: v0.17.7 (released January 19, 2026)
15+
**Current Version**: v0.18.0 (released January 28, 2026)
1616

1717
**Key Features**:
1818
- 17 MCP tools for AI integration (write_note, read_note, edit_note, search_notes, build_context, etc.)
@@ -23,13 +23,11 @@ This is the documentation website for Basic Memory (`docs.basicmemory.com`), bui
2323
- Real-time file synchronization
2424
- SQLite and PostgreSQL database backends
2525

26-
**v0.17.x Major Features**:
27-
- API v2 migration complete - all MCP tools use optimized v2 endpoints
28-
- Auto-format files on save with built-in Python formatter
29-
- Anonymous usage telemetry (Homebrew-style opt-out)
30-
- CLI stability improvements - commands no longer hang on exit
31-
- Cloud mode discovery for recent_activity across projects
32-
- PostgreSQL/Neon database support as alternative to SQLite
26+
**v0.18.0 Major Features**:
27+
- Context-aware wiki link resolution with source_path support
28+
- Directory support for move_note and delete_note tools
29+
- Local MCP cloud mode routing for simultaneous local/cloud usage
30+
- Cloud snapshot CLI commands for backup management
3331

3432
### Basic Memory Cloud
3533

src/pages/latest-releases.mdx

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,73 @@ import { Card, CardGroup, Info, Warning, Note, Tip, Accordion, AccordionItem, St
1010

1111
View the latest changes to Basic Memory on [GitHub](https://github.com/basicmachines-co/basic-memory/releases)
1212

13+
## [v0.18.0](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.18.0) — 2026-01-28
14+
15+
**Focus:** Context-aware wiki link resolution, directory operations, and cloud routing improvements
16+
17+
<Info>
18+
**Highlights:**
19+
- Context-aware wiki link resolution with `source_path` support
20+
- Directory support for move and delete operations
21+
- Local MCP cloud mode routing for simultaneous local/cloud usage
22+
- MCP prompt rendering fixes
23+
</Info>
24+
25+
### Features
26+
27+
- **Context-aware wiki link resolution** ([#527](https://github.com/basicmachines-co/basic-memory/pull/527))
28+
- Add `source_path` parameter to `resolve_link()` for context-aware resolution
29+
- Relative path resolution: `[[nested/note]]` from `folder/file.md``folder/nested/note.md`
30+
- Proximity-based resolution for duplicate titles (prefers notes in same folder)
31+
- Strict mode to disable fuzzy search fallback for wiki links
32+
33+
- **Directory support for move and delete** ([#518](https://github.com/basicmachines-co/basic-memory/pull/518))
34+
- Add `is_directory` parameter to `move_note` and `delete_note` MCP tools
35+
- New `POST /move-directory` and `POST /delete-directory` API endpoints
36+
- Rename `folder``directory` parameter across codebase for consistency
37+
38+
- **Local MCP cloud mode routing** ([#522](https://github.com/basicmachines-co/basic-memory/pull/522))
39+
- Add `--local` and `--cloud` CLI routing flags
40+
- Local MCP server (`basic-memory mcp`) automatically uses local routing
41+
- Enables simultaneous use of local Claude Desktop and cloud-based clients
42+
- Environment variable `BASIC_MEMORY_FORCE_LOCAL=true` for global override
43+
44+
### Bug Fixes
45+
46+
- **Fix MCP prompt rendering errors** ([#524](https://github.com/basicmachines-co/basic-memory/pull/524))
47+
- Fix "Error rendering prompt recent_activity" error
48+
- Change `TimeFrame` to `str` in prompt type annotations for FastMCP compatibility
49+
50+
**Full Changelog**: https://github.com/basicmachines-co/basic-memory/compare/v0.17.9...v0.18.0
51+
52+
---
53+
54+
## [v0.17.8-v0.17.9](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.17.9) — 2026-01-24
55+
56+
**Focus:** Cloud mode bug fixes and snapshot CLI commands
57+
58+
### Features
59+
60+
- **Cloud snapshot CLI commands** ([#476](https://github.com/basicmachines-co/basic-memory/pull/476))
61+
- New `basic-memory cloud snapshot` commands: `create`, `list`, `delete`, `show`, `browse`
62+
- Manage cloud backups directly from the command line
63+
64+
### Bug Fixes
65+
66+
- **Fix `get_default_project()` returning multiple results** ([#521](https://github.com/basicmachines-co/basic-memory/pull/521))
67+
- Query incorrectly matched any project with non-NULL `is_default` (both True and False)
68+
- Now correctly checks for `is_default=True` only
69+
70+
- **Fix `remove_project()` checking stale config in cloud mode** ([#523](https://github.com/basicmachines-co/basic-memory/pull/523))
71+
- In cloud mode, only check database `is_default` field (source of truth)
72+
- Config file can become stale when users set default project via v2 API
73+
74+
- **Read default project from database in cloud mode** ([#520](https://github.com/basicmachines-co/basic-memory/pull/520))
75+
76+
**Full Changelog**: https://github.com/basicmachines-co/basic-memory/compare/v0.17.7...v0.17.9
77+
78+
---
79+
1380
## [v0.17.7](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.17.7) — 2026-01-19
1481

1582
**Focus:** MCP Registry publication and bug fixes

src/pages/whats-new.mdx

Lines changed: 58 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
layout: '@/layouts/DocsLayout.astro'
3-
title: "What's New - Basic Memory Cloud is live!"
4-
description: 'Bring your knowledge to the cloud. All your existing notes, connections, and context - accessible from anywhere.'
3+
title: "What's New in Basic Memory"
4+
description: 'Latest features and improvements in Basic Memory - context-aware wiki links, directory operations, and cloud sync.'
55
---
66

77
import { Card, CardGroup, Info, Warning, Note, Tip, Accordion, AccordionItem, Steps, Step } from '@/components'
@@ -14,6 +14,62 @@ import { Card, CardGroup, Info, Warning, Note, Tip, Accordion, AccordionItem, St
1414

1515
Work with your knowledge base across multiple devices using cloud sync and storage.
1616

17+
## v0.18.0
18+
19+
Basic Memory v0.18.0 introduces context-aware wiki link resolution, directory operations, and improved cloud routing.
20+
21+
<Info>
22+
**Key improvements:**
23+
- Context-aware wiki link resolution with `source_path` support
24+
- Directory support for `move_note` and `delete_note` tools
25+
- Local MCP cloud mode routing for simultaneous local/cloud usage
26+
- MCP prompt rendering fixes
27+
</Info>
28+
29+
### Context-Aware Wiki Link Resolution
30+
31+
Wiki links now resolve intelligently based on where they appear in your knowledge base.
32+
33+
**Relative path resolution:**
34+
When you write `[[nested/note]]` in a file at `folder/file.md`, Basic Memory first looks for `folder/nested/note.md` before searching globally.
35+
36+
**Proximity-based resolution:**
37+
If you have notes with the same title in different folders, links resolve to the note closest to your current location. A link to `[[Meeting Notes]]` from `projects/alpha/tasks.md` prefers `projects/alpha/Meeting Notes.md` over `projects/beta/Meeting Notes.md`.
38+
39+
**Strict mode:**
40+
The resolve endpoint now supports strict mode to disable fuzzy search fallback, ensuring exact matches only.
41+
42+
### Directory Operations
43+
44+
Move and delete entire folders of notes with database consistency:
45+
46+
```python
47+
# Move all notes in a directory
48+
move_note("old-folder", "new-folder", is_directory=True)
49+
50+
# Delete all notes in a directory
51+
delete_note("archive/old-project", is_directory=True)
52+
```
53+
54+
### Local/Cloud Routing
55+
56+
Use local Claude Desktop and cloud-based clients simultaneously:
57+
58+
```bash
59+
# Force local routing (when cloud mode is enabled)
60+
basic-memory status --local
61+
basic-memory project list --local
62+
63+
# Force cloud routing
64+
basic-memory status --cloud
65+
```
66+
67+
The local MCP server (`basic-memory mcp`) automatically uses local routing, so you can run both without conflicts.
68+
69+
See the [complete v0.18.0 changelog](/latest-releases) for full details.
70+
71+
---
72+
1773
## v0.17.0
1874

1975
Basic Memory v0.17.0 completes the API v2 migration, adds auto-formatting, and improves CLI stability.

0 commit comments

Comments
 (0)