docs: add What's New highlights, integration pages, and site fixes

- Add What's New highlight pages for Agent Skills, OpenClaw Plugin, and AI-Friendly Docs
- Add full integration pages for Agent Skills and OpenClaw Plugin
- Add cloud routing documentation page
- Add X/Twitter social link to footer and community nav
- Fix broken /cloud/cloud-app/notes-interface links → /cloud/web-app
- Remove stale TODO screenshot comments
- Update docs content for v0.19.0 (search, schemas, semantic search, CLI reference)
- Replace robots.txt with _robots.txt for Nuxt/Nitro handling

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

Author: phernandez

CLAUDE.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.18.0 (released January 28, 2026)
+**Current Version**: v0.19.0 (released March 2026)
 
 **Key Features**:
 - 17 MCP tools for AI integration (write_note, read_note, edit_note, search_notes, build_context, etc.)
@@ -23,11 +23,14 @@ This is the documentation website for Basic Memory (`docs.basicmemory.com`), bui
 - Real-time file synchronization
 - SQLite and PostgreSQL database backends
 
-**v0.18.0 Major Features**:
-- Context-aware wiki link resolution with source_path support
-- Directory support for move_note and delete_note tools
-- Local MCP cloud mode routing for simultaneous local/cloud usage
-- Cloud snapshot CLI commands for backup management
+**v0.19.0 Major Features**:
+- Schema system for note structure validation
+- Semantic vector search with hybrid fusion
+- Per-project cloud routing
+- Project-prefixed permalinks
+- `write_note` overwrite guard
+- JSON output mode for all MCP tools
+- Unified metadata search (search_by_metadata merged into search_notes)
 
 ### Basic Memory Cloud
 
@@ -59,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.19.x release and includes cloud product documentation.
 
 ## Development Commands
 
@@ -169,13 +172,13 @@ pip install basic-memory
 
 ## 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.19.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.19.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

app/app.config.ts

@@ -44,6 +44,7 @@ export default defineAppConfig({
   },
   socials: {
     github: 'https://github.com/basicmachines-co/basic-memory',
+    x: 'https://x.com/basic_memory',
     discord: 'https://discord.gg/tyvKNccgqN',
     reddit: 'https://www.reddit.com/r/basicmemory',
   },
@@ -52,6 +53,7 @@ export default defineAppConfig({
       title: 'Community',
       links: [
         { label: 'GitHub', to: 'https://github.com/basicmachines-co/basic-memory' },
+        { label: 'X / Twitter', to: 'https://x.com/basic_memory' },
         { label: 'Discord', to: 'https://discord.gg/tyvKNccgqN' },
         { label: 'Reddit', to: 'https://www.reddit.com/r/basicmemory' },
       ],

content/1.start-here/2.quickstart-cloud.md

@@ -21,7 +21,6 @@ code: |
 
 Sign up at [app.basicmemory.com](https://app.basicmemory.com). You'll need an active subscription to use the MCP endpoint.
 
-<!-- TODO: Screenshot - Cloud signup page -->
 ![Cloud signup page](/screenshots/cloud/signup.png)
 
 ---

content/1.start-here/3.quickstart-local.md

@@ -19,7 +19,7 @@ code: |
 
 ## 1. Install Basic Memory
 
-Choose your installation method. The default install includes semantic search dependencies for hybrid (keyword + meaning-based) search.
+Choose your installation method. All installs include semantic search for hybrid (keyword + meaning-based) search.
 
 ### macOS (Homebrew) - Recommended
 
@@ -28,30 +28,18 @@ brew tap basicmachines-co/basic-memory
 brew install basic-memory
 ```
 
-Homebrew includes semantic search dependencies automatically.
-
 ### All platforms (uv)
 
 First install `uv` from [astral.sh](https://docs.astral.sh/uv/getting-started/installation/), then:
 
 ```bash
-uv tool install 'basic-memory[semantic]'
+uv tool install basic-memory
 ```
 
 ::note
 **Requirements:** Python 3.13 or higher. Check with `python --version`.
 ::
 
-### Lightweight install (without semantic search)
-
-If you don't need hybrid search or want a smaller install:
-
-```bash
-uv tool install basic-memory
-```
-
-Search will use keyword-only mode. You can add semantic search later with `uv tool upgrade 'basic-memory[semantic]'`.
-
 ### Verify installation
 
 ```bash
@@ -60,7 +48,7 @@ basic-memory --version
 
 **Expected output:**
 ```bash
-basic-memory, version 0.18.x
+basic-memory, version 0.19.x
 ```
 
 ---
@@ -94,16 +82,12 @@ Add this configuration:
 
 **Restart Claude Desktop** after editing the config.
 
-<!-- TODO: Screenshot - Config file in editor -->
-![Claude Desktop config file](/screenshots/claude/config-file.png)
-
 ---
 
 ## 3. Verify the connection
 
 In Claude Desktop, click the **tools icon** (hammer) in the bottom-right of the chat interface. You should see Basic Memory tools listed.
 
-<!-- TODO: Screenshot - Claude tools menu showing Basic Memory -->
 ![Claude - Tools menu with Basic Memory](/screenshots/claude/tools-menu-local.png)
 
 Ask Claude:
@@ -118,8 +102,7 @@ You have 1 project:
 - main (default) - ~/basic-memory - 0 notes
 ```
 
-<!-- TODO: Screenshot - Claude project list response -->
-![Claude - Project list](/screenshots/claude/project-list-local.png)
+![Claude - Project list](/screenshots/claude/project-list-response.png)
 
 ---
 
@@ -148,8 +131,7 @@ It includes an overview of Basic Memory's key features:
 - Search across your knowledge base
 ```
 
-<!-- TODO: Screenshot - Claude creating a note locally -->
-![Claude - Creating first note](/screenshots/claude/create-note-local.png)
+![Claude - Creating first note](/screenshots/claude/create-first-note.png)
 
 ---
 
@@ -174,9 +156,6 @@ explorer ~/basic-memory  # Windows
 2. **Create new vault** → select `~/basic-memory`
 3. Use the **graph view** to see connections between notes
 
-<!-- TODO: Screenshot - Obsidian with Basic Memory vault and graph view -->
-![Obsidian - Basic Memory vault with graph](/screenshots/obsidian/vault-with-graph.png)
-
 ### Example note structure
 
 After creating a few notes, your folder might look like:
@@ -278,9 +257,6 @@ basic-memory import chatgpt
 basic-memory sync
 ```
 
-<!-- TODO: GIF - CLI commands in action -->
-![CLI commands demo](/screenshots/cli/commands-demo.gif)
-
 ---
 
 ## Troubleshooting

content/2.whats-new/0.v0.19.0.md

@@ -60,7 +60,7 @@ Basic Memory now includes semantic search by default — hybrid search combines
 
 Three search modes are available:
 
-- **`hybrid`** (default) — Combines keyword and semantic search with score-based fusion
+- **`hybrid`** (default) — Combines keyword and semantic search
 - **`text`** — Keyword-only search
 - **`vector`** — Pure semantic similarity search
 
@@ -83,6 +83,31 @@ See the full [Semantic Search](/concepts/semantic-search) guide for configuratio
 
 ---
 
+## Metadata Search
+
+`search_notes` now supports searching by frontmatter metadata. The `query` parameter is optional, so you can search purely by metadata fields.
+
+```python
+search_notes(metadata_filters={"status": "in-progress"})
+search_notes(metadata_filters={"tags": ["security", "oauth"]})
+search_notes(metadata_filters={"priority": {"$in": ["high", "critical"]}})
+search_notes(tags=["security"])  # convenience shorthand
+search_notes(status="draft")     # convenience shorthand
+```
+
+---
+
+## `tag:` Search Shorthand
+
+Search by tag using convenient shorthand syntax instead of structured filters:
+
+```python
+search_notes("tag:security")
+search_notes("tag:coffee AND tag:brewing")
+```
+
+---
+
 ## Per-Project Local/Cloud Routing
 
 You can now route individual projects through cloud while keeping others local. The stdio MCP server only calls local projects, while cloud projects are available via CLI commands.
@@ -104,6 +129,8 @@ The routing model has three levels:
 2. **Per-project** — `bm project set-cloud/set-local` overrides for specific projects
 3. **Per-command** — `--local` / `--cloud` flags provide one-off overrides
 
+See [Local & Cloud Routing](/cloud/routing) for the full guide, including hybrid setups and common configurations.
+
 ---
 
 ## Project-Prefixed Permalinks
@@ -119,31 +146,6 @@ This makes cross-project references unambiguous. Within notes, the `project::not
 
 ---
 
-## Unified Metadata Search
-
-`search_by_metadata` has been merged into `search_notes` — one tool for all searches. The `query` parameter is now optional, so you can search purely by frontmatter metadata.
-
-```python
-search_notes(metadata_filters={"status": "in-progress"})
-search_notes(metadata_filters={"tags": ["security", "oauth"]})
-search_notes(metadata_filters={"priority": {"$in": ["high", "critical"]}})
-search_notes(tags=["security"])  # convenience shorthand
-search_notes(status="draft")     # convenience shorthand
-```
-
----
-
-## `tag:` Search Shorthand
-
-Search by tag using convenient shorthand syntax instead of structured filters:
-
-```python
-search_notes("tag:security")
-search_notes("tag:coffee AND tag:brewing")
-```
-
----
-
 ## `write_note` Overwrite Guard
 
 `write_note` is now non-idempotent by default. If a note already exists at the target path, the tool returns an error instead of silently overwriting. This prevents accidental data loss.
@@ -187,18 +189,6 @@ The `note_type` sets the `type` frontmatter field (used for schema resolution an
 
 ---
 
-## Score-Based Hybrid Fusion
-
-The hybrid search scoring algorithm has been replaced. The old Reciprocal Rank Fusion (RRF) compressed all fused scores to ~0.016, destroying ranking differentiation. The new formula preserves dominant signals and rewards dual-source agreement:
-
-```
-score = max(vec, fts) + 0.3 * min(vec, fts)
-```
-
-Zero-score results now produce zero fused score instead of receiving a weight floor. Search result ordering may differ from v0.18 — results should be more accurate with better score differentiation.
-
----
-
 ## Dashboard (`bm project info`)
 
 `bm project info` now displays an htop-inspired compact dashboard with:
@@ -207,21 +197,37 @@ Zero-score results now produce zero fused score instead of receiving a weight fl
 - Embedding coverage bar with Unicode block characters
 - Colored status dots for at-a-glance health
 
+```
+╭────────────────────────────────────── specs ──────────────────────────────────────╮
+│ Knowledge Graph         Embeddings                                                │
+│ Entities         110    ● Semantic Search           Enabled                       │
+│ Observations     585      Provider                  fastembed                     │
+│ Relations        319      Model                     bge-small-en-v1.5             │
+│ Unresolved       131      Indexed                                                 │
+│ Isolated          27    █████░░░░░░░░░░░░░░░                                      │
+│                         26/110                                                    │
+│                           Chunks                    4085                          │
+│                         ● Status                    Reindex recommended           │
+│                           Reason                    260 orphaned chunks found     │
+│                                                     (interrupted indexing) — run: │
+│                                                     bm reindex --embeddings       │
+│                                                                                   │
+│ Note Types                                                                        │
+│               note  ████████████████████████████████████████  72                  │
+│               spec  ███████████████████░░░░░░░░░░░░░░░░░░░░░  35                  │
+│               file  █░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░   2                  │
+│           tasklist  █░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░   1                  │
+│                                                                                   │
+│                                                                                   │
+│ /specs  default: main  2026-03-02 05:14                                           │
+╰─────────────────────────────── Basic Memory 0.00.0 ───────────────────────────────╯
+```
 ---
 
 ## Entity User Tracking
 
 Entities now track `created_by` and `last_updated_by` fields for attribution, so you can see whether a note was created by a human or an AI assistant.
 
----
-
-## Improved Search Results
-
-Search results now surface more relevant context:
-
-- `matched_chunk_text` populated for FTS-only hybrid results (no more fallback to truncated content)
-- Top chunks per result increased from 3 to 5, catching answers deeper in large notes
-- Content display limit doubled from 2,000 to 4,000 characters for results without matched chunks
 
 ---
 
@@ -310,24 +316,6 @@ Existing permalinks without a project prefix still resolve correctly — resolut
 
 **Get text output:** Pass `output_format="text"` explicitly.
 
-### Hybrid search scoring algorithm
-
-The hybrid search scoring formula changed from Reciprocal Rank Fusion (RRF) to score-based fusion. The old RRF formula compressed all fused scores to ~0.016, destroying ranking differentiation. The new formula preserves dominant signals and rewards dual-source agreement.
-
-Search result ordering may differ from v0.18. Results should be more accurate with better score differentiation. Zero-score results now produce zero fused score instead of receiving a weight floor.
-
-### `search_by_metadata` removed
-
-`search_by_metadata` is no longer a standalone tool. Use `search_notes` with `metadata_filters` instead — same parameters, same behavior.
-
-```python
-# Before (v0.18)
-search_by_metadata(metadata_filters={"status": "draft"})
-
-# After (v0.19)
-search_notes(metadata_filters={"status": "draft"})
-```
-
 ### `default_project_mode` removed
 
 The `default_project_mode` setting is no longer used. Use `default_project` as the fallback when no project is explicitly passed to a tool or command. Per-project routing (`set-cloud` / `set-local`) replaces the global mode toggle.

content/2.whats-new/1.cloud.md

@@ -161,7 +161,7 @@ Get started with Basic Memory Cloud.
 ---
 title: Notes Interface
 icon: i-lucide-layout-panel-left
-to: /cloud/cloud-app/notes-interface
+to: /cloud/web-app
 ---
 Learn about the Cloud notes UI.
 ::