docs: add v0.18.0 release documentation

- Add v0.17.8 and v0.17.9 release notes to latest-releases.mdx
- Document directory operations for move_note and delete_note MCP tools
- Add cloud snapshot commands (create, list, show, browse, delete)
- Document --local and --cloud routing flags for CLI
- Add v0.18.0 section to whats-new.mdx
- Update CLAUDE.md to reflect v0.18.0 release

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: phernandez

.claude/agents/basic-memory-docs-writer.md

@@ -12,7 +12,7 @@ This is the documentation website for Basic Memory (`docs.basicmemory.com`), bui
 
 **Repository**: https://github.com/basicmachines-co/basic-memory
 **Website**: https://basicmemory.com
-**Current Version**: v0.17.7 (released January 19, 2026)
+**Current Version**: v0.18.0 (released January 26, 2026)
 
 **Key Features**:
 - 17 MCP tools for AI integration (write_note, read_note, edit_note, search_notes, build_context, etc.)
@@ -23,12 +23,13 @@ This is the documentation website for Basic Memory (`docs.basicmemory.com`), bui
 - Real-time file synchronization
 - SQLite and PostgreSQL database backends
 
-**v0.17.x Major Features**:
+**v0.18.x Major Features**:
+- Directory operations - move and delete entire directories with MCP tools
+- Local/cloud routing flags - `--local` and `--cloud` CLI flags for explicit routing control
+- Cloud snapshots - create, list, browse, and restore point-in-time snapshots
 - API v2 migration complete - all MCP tools use optimized v2 endpoints
 - Auto-format files on save with built-in Python formatter
-- Anonymous usage telemetry (Homebrew-style opt-out)
-- CLI stability improvements - commands no longer hang on exit
-- Cloud mode discovery for recent_activity across projects
+- Cloud mode stability improvements
 - PostgreSQL/Neon database support as alternative to SQLite
 
 ### Basic Memory Cloud
@@ -61,7 +62,7 @@ This documentation site covers both:
 1. **Basic Memory** (local-first product) - Installation, MCP tools, CLI, integrations, knowledge format
 2. **Basic Memory Cloud** (upcoming) - Cloud-specific features, authentication, sync, billing
 
-The site documents the latest v0.17.x release and includes cloud product documentation.
+The site documents the latest v0.18.x release and includes cloud product documentation.
 
 ## Development Commands
 
@@ -207,13 +208,13 @@ The sidebar automatically highlights the current page based on `href` matching `
 
 ## Documentation Status & Priorities
 
-Documentation is up-to-date for v0.17.x release. Cloud product documentation is complete.
+Documentation is up-to-date for v0.18.x release. Cloud product documentation is complete.
 
 ### Reference Materials
 
 When documenting features:
 - **Basic Memory CHANGELOG**: `gh api repos/basicmachines-co/basic-memory/contents/CHANGELOG.md`
-- **Release Notes**: `gh release view v0.17.2 --repo basicmachines-co/basic-memory`
+- **Release Notes**: `gh release view v0.18.0 --repo basicmachines-co/basic-memory`
 - **Basic Memory README**: https://github.com/basicmachines-co/basic-memory
 - **Cloud README**: https://github.com/basicmachines-co/basic-memory-cloud
 - **Cloud CLAUDE.md**: https://github.com/basicmachines-co/basic-memory-cloud/blob/main/CLAUDE.md

CLAUDE.md

@@ -35,6 +35,21 @@ bm cloud upload ~/my-notes --project research --create-project
 
 # Set up sync (one-time)
 bm cloud setup
+
+# Create a snapshot of your cloud bucket
+bm cloud snapshot create "Before major reorganization"
+
+# List all snapshots
+bm cloud snapshot list
+
+# Show snapshot details
+bm cloud snapshot show <snapshot-id>
+
+# Browse snapshot contents
+bm cloud snapshot browse <snapshot-id>
+
+# Delete a snapshot
+bm cloud snapshot delete <snapshot-id>
 ```
 
 <Tip>
@@ -117,6 +132,26 @@ All commands support the `--project` flag to specify which project to use:
 basic-memory --project=personal mcp
 ```
 
+#### Local/Cloud Routing Flags
+
+When cloud mode is enabled, you can force routing to local or cloud using these flags:
+
+```bash
+# Force local MCP server even when cloud mode is enabled
+basic-memory --local mcp
+
+# Force cloud routing
+basic-memory --cloud mcp
+
+# These flags work with mcp, project, and tool commands
+basic-memory --local project list
+basic-memory --cloud tool search-notes --query "api"
+```
+
+<Note>
+The `--local` flag is useful when you want to work with local files while cloud mode is configured. The `--cloud` flag ensures operations go through the cloud even if local files exist.
+</Note>
+
 ### tools
 
 Direct access to MCP tools via CLI with new editing and file management capabilities:

src/pages/guides/cli-reference.mdx

@@ -48,15 +48,17 @@ Using Basic Memory Cloud? All MCP tools work the same whether you're using cloud
     - [Detailed examples →](/whats-new#view-notes-as-formatted-artifacts)
   </Card>
   <Card title="delete_note" icon="trash">
-    **Remove notes from knowledge base**
-    - Parameters: identifier, project
+    **Remove notes or directories from knowledge base**
+    - Parameters: identifier, project, is_directory
     - Removes from database and file system
+    - Use `is_directory=True` for recursive directory deletion
     - Updates search index and relations
   </Card>
   <Card title="move_note" icon="move">
-    **Move and rename notes**
-    - Parameters: identifier, new_path, project
+    **Move and rename notes or directories**
+    - Parameters: identifier, new_path, project, is_directory
     - Maintains database consistency
+    - Use `is_directory=True` to move entire folders
     - Updates search index
     - [Detailed examples →](/whats-new#smart-file-management)
   </Card>
@@ -398,6 +400,30 @@ Claude: Here's your reorganized projects folder with the new mobile-app director
 ```
 </details>
 
+**Directory Operations Flow:**
+```
+list_directory → move_note (is_directory=True) → delete_note (is_directory=True)
+```
+*Bulk organize folders, move entire directories, clean up old folders*
+
+<details>
+<summary>Example conversation</summary>
+
+```
+You: "Move the entire 'old-projects' folder to 'archive'"
+Claude: I'll move the old-projects directory to your archive folder.
+[Uses move_note with is_directory=True]
+✓ Moved old-projects/ → archive/old-projects/
+✓ All 15 files moved with database consistency maintained
+
+You: "Delete the empty 'temp' folder"
+Claude: I'll remove the temp directory and all its contents.
+[Uses delete_note with is_directory=True]
+✓ Deleted temp/ and 3 contained files
+✓ Search index and relations updated
+```
+</details>
+
 ### Integration Examples
 
 **In Claude Desktop:**

src/pages/guides/mcp-tools-reference.mdx

@@ -10,6 +10,57 @@ import { Card, CardGroup, Info, Warning, Note, Tip, Accordion, AccordionItem, St
 
 View the latest changes to Basic Memory on [GitHub](https://github.com/basicmachines-co/basic-memory/releases)
 
+## [v0.17.9](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.17.9) — 2026-01-26
+
+**Focus:** Directory operations and routing improvements
+
+<Info>
+**Highlights:**
+- MCP tools now support directory operations for `move_note` and `delete_note`
+- New `--local` and `--cloud` routing flags for CLI commands
+</Info>
+
+### Features
+
+- **Directory Operations for MCP Tools** ([#525](https://github.com/basicmachines-co/basic-memory/pull/525))
+  - `move_note` now supports moving entire directories with `is_directory=True`
+  - `delete_note` now supports deleting directories recursively with `is_directory=True`
+  - Enables bulk organization of knowledge base folders
+
+- **Local/Cloud Routing Flags** ([#526](https://github.com/basicmachines-co/basic-memory/pull/526))
+  - New `--local` flag to force local MCP server even when cloud mode is enabled
+  - New `--cloud` flag to force cloud routing
+  - Applies to `mcp`, `project`, and `tool` CLI commands
+
+### Bug Fixes
+
+- **Fix `remove_project()` checking stale config in cloud mode** ([#523](https://github.com/basicmachines-co/basic-memory/pull/523))
+  - Project removal now correctly handles cloud mode configuration
+
+- **Fix MCP prompt rendering errors in `recent_activity`** ([#524](https://github.com/basicmachines-co/basic-memory/pull/524))
+  - Resolves errors when rendering recent activity prompts
+
+**Full Changelog**: https://github.com/basicmachines-co/basic-memory/compare/v0.17.8...v0.17.9
+
+---
+
+## [v0.17.8](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.17.8) — 2026-01-22
+
+**Focus:** Cloud mode stability
+
+### Bug Fixes
+
+- **Fix `get_default_project()` returning multiple results** ([#521](https://github.com/basicmachines-co/basic-memory/pull/521))
+  - Ensures only a single default project is returned in cloud mode
+
+- **Read default project from database in cloud mode** ([#520](https://github.com/basicmachines-co/basic-memory/pull/520))
+  - Default project resolution now correctly uses database in cloud mode
+  - Improves reliability of project selection for cloud users
+
+**Full Changelog**: https://github.com/basicmachines-co/basic-memory/compare/v0.17.7...v0.17.8
+
+---
+
 ## [v0.17.7](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.17.7) — 2026-01-19
 
 **Focus:** MCP Registry publication and bug fixes

src/pages/latest-releases.mdx

@@ -14,6 +14,74 @@ import { Card, CardGroup, Info, Warning, Note, Tip, Accordion, AccordionItem, St
 
 Work with your knowledge base across multiple devices using cloud sync and storage.
 
+## v0.18.0
+
+Basic Memory v0.18.0 adds directory operations to MCP tools, local/cloud routing control, and cloud snapshots.
+
+<Info>
+**Key improvements:**
+- Move and delete entire directories with MCP tools
+- New `--local` and `--cloud` flags for routing control
+- Cloud snapshot commands for backup and recovery
+- Improved cloud mode stability
+</Info>
+
+### Directory Operations
+
+MCP tools now support bulk directory operations:
+
+**Move entire directories:**
+```python
+# Move a folder and all its contents
+move_note("old-projects", "archive/old-projects", is_directory=True)
+```
+
+**Delete directories recursively:**
+```python
+# Remove a folder and all contained files
+delete_note("temp-folder", is_directory=True)
+```
+
+This enables efficient bulk organization of your knowledge base without moving files one at a time.
+
+### Local/Cloud Routing Flags
+
+New CLI flags give you explicit control over where operations are routed:
+
+```bash
+# Force local MCP server even when cloud mode is enabled
+basic-memory --local mcp
+
+# Force cloud routing
+basic-memory --cloud tool search-notes --query "api"
+```
+
+Useful when you want to work with local files while cloud mode is configured, or ensure operations go through the cloud.
+
+### Cloud Snapshots
+
+Create and manage point-in-time snapshots of your cloud bucket:
+
+```bash
+# Create a snapshot before major changes
+bm cloud snapshot create "Before reorganization"
+
+# List all snapshots
+bm cloud snapshot list
+
+# Browse snapshot contents
+bm cloud snapshot browse <snapshot-id>
+
+# Restore from snapshot (browse and download files)
+bm cloud snapshot show <snapshot-id>
+```
+
+Snapshots provide a safety net for major reorganizations or experiments with your knowledge base.
+
+See the [complete v0.18.0 changelog](/latest-releases) for full details.
+
+---
+
 ## v0.17.0
 
 Basic Memory v0.17.0 completes the API v2 migration, adds auto-formatting, and improves CLI stability.