basicmachines-co · nellins · Aug 25, 2026 · Aug 25, 2026 · Aug 25, 2026 · Aug 25, 2026
diff --git a/app/components/content/DocsVideo.vue b/app/components/content/DocsVideo.vue
@@ -0,0 +1,21 @@
+<template>
+  <span class="block">
+    <video
+      :src="src"
+      :poster="poster"
+      :aria-label="alt"
+      class="block w-full rounded border border-default"
+      controls
+      playsinline
+      preload="metadata"
+    />
+  </span>
+</template>
+
+<script setup lang="ts">
+defineProps<{
+  src: string
+  poster?: string
+  alt?: string
+}>()
+</script>
diff --git a/content/0.welcome.md b/content/0.welcome.md
@@ -11,7 +11,10 @@ seo:
 **Basic Memory** is real memory for your AI — a knowledge base you own. Built-in AI memory is small, vendor-owned, and usually invisible. Basic Memory is large, structured, and inspectable: a knowledge graph written in plain Markdown. Open it in any editor, hand it to any AI tool, and keep it forever.
 
 ::note{icon="i-lucide-megaphone"}
-**New in v0.23:** the search release — reranking, Milvus, and a deadlock-free indexing core. See [What's New in v0.23](/whats-new/v0-23). Also new in Basic Memory Cloud: [Comments and Suggestions](/whats-new/comments-and-suggestions) and the [Interactive MCP App](/whats-new/interactive-mcp-app) for ChatGPT and Claude.
+**New in v0.23:** the search release — reranking, Milvus, and a deadlock-free indexing core. See [What's New in v0.23](/whats-new/v0-23). Also new in Basic Memory Cloud: [Comments and Suggestions](/whats-new/comments-and-suggestions) and the [Pocketbook](/whats-new/interactive-mcp-app) for ChatGPT and Claude.
+::
+
+::docs-video{src="/videos/hero.mp4" poster="/videos/posters/hero.png" alt="What Basic Memory is, in one minute"}
 ::
 
 ## Pick your path

diff --git a/content/01.start-here/1.what-is-basic-memory.md b/content/01.start-here/1.what-is-basic-memory.md
@@ -8,7 +8,7 @@ Basic Memory is real memory for your AI — a knowledge base you own. It stores
 Instead of losing valuable insights in conversation history, you build a persistent knowledge base that every AI tool you use can read, write, and enhance — Claude, ChatGPT, Codex, OpenClaw, Hermes, and all your team's agents, working from one shared memory.
 
 ---
-:video{autoplay controls loop muted src="https://basicmemory.com/videos/explainer-video.mp4"}
+:video{controls poster="/videos/posters/hero.png" src="/videos/hero.mp4"}
 
 ## Why Basic Memory?
 

diff --git a/content/01.start-here/2.quickstart-cloud.md b/content/01.start-here/2.quickstart-cloud.md
@@ -5,6 +5,9 @@ description: Connect Basic Memory Cloud and create your first note in 2 minutes.
 
 Basic Memory Cloud gives you a hosted MCP endpoint and a web app. Connect your AI assistant and start writing notes in minutes - no installation required.
 
+::docs-video{src="/videos/docs-quickstart.mp4" poster="/videos/posters/docs-quickstart.png" alt="Meet your workspace and write your first notes"}
+::
+
 ::mermaid
 ---
 code: |
@@ -121,7 +124,7 @@ I've created "My First Note" in your knowledge base. The note covers:
 
 Open [app.basicmemory.com/notes](https://app.basicmemory.com/notes) to see your new note in the sidebar. Notes written by your agent appear live — no refresh needed — and show up in the **Activity** view alongside your own edits.
 
-In a compatible MCP client, you can also ask `Open Basic Memory` to browse the interactive app directly in the conversation. See [Interactive MCP App](/cloud/mcp-app).
+In a compatible MCP client, you can also ask `Open Basic Memory` to browse the interactive app directly in the conversation. See [Pocketbook](/cloud/mcp-app).
 
 **What you can do in the web app:**
 - Browse all your notes in the folder tree

diff --git a/content/02.whats-new/01.v0-23.md b/content/02.whats-new/01.v0-23.md
@@ -5,6 +5,9 @@ description: Reranked semantic search, pluggable vector indexes with Milvus, dea
 
 **Basic Memory v0.23** shipped in August 2026 ([v0.23.0 release notes](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.23.0)). The theme is search you can trust: semantic search matures with cross-encoder reranking and pluggable vector indexes, the indexing core stops deadlocking under concurrent writers, and a new inspector shows exactly why a search returned what it did.
 
+::docs-video{src="/videos/docs-semantic-search.mp4" poster="/videos/posters/docs-semantic-search.png" alt="Semantic search answering a plain-language question"}
+::
+
 ## Search that ranks
 
 ### Opt-in cross-encoder reranking

diff --git a/content/02.whats-new/02.comments-and-suggestions.md b/content/02.whats-new/02.comments-and-suggestions.md
@@ -5,6 +5,9 @@ description: Leave feedback and propose changes without overwriting a Basic Memo
 
 Basic Memory Cloud now has a review workflow built directly into the note editor. People and connected AI assistants can comment on a passage or suggest a precise change while keeping the original text available for review.
 
+::docs-video{src="/videos/docs-comments-suggestions.mp4" poster="/videos/posters/docs-comments-suggestions.png" alt="Suggesting edits and reviewing them with an AI assistant"}
+::
+
 ::theme-image{light="/screenshots/cloud-app/critic-inline-replacement-light.png" dark="/screenshots/cloud-app/critic-inline-replacement-dark.png" alt="A replacement suggestion shown inline with the original and proposed text"}
 ::
 
@@ -28,7 +31,7 @@ The note toolbar shows the number of unresolved comments and suggestions. Open i
 
 ## Review with an AI assistant
 
-Comments and suggestions are stored with the Markdown using portable CriticMarkup. That means a connected assistant can review a note without immediately rewriting it, and the same open items remain available in the Cloud editor and the interactive MCP App.
+Comments and suggestions are stored with the Markdown using portable CriticMarkup. That means a connected assistant can review a note without immediately rewriting it, and the same open items remain available in the Cloud editor and Pocketbook.
 
 Try asking:
 
@@ -50,7 +53,7 @@ Add comments, propose each kind of edit, and work through unresolved review item
 
 ::card
 ---
-title: Interactive MCP App
+title: Pocketbook
 icon: i-lucide-panels-top-left
 to: /cloud/mcp-app
 ---

diff --git a/content/02.whats-new/03.interactive-mcp-app.md b/content/02.whats-new/03.interactive-mcp-app.md
@@ -1,13 +1,16 @@
 ---
-title: Interactive MCP App
+title: Pocketbook
 description: Browse, search, graph, edit, and review Basic Memory inside ChatGPT and Claude conversations.
 ---
 
 Basic Memory Cloud can now open as an interactive app inside supported AI conversations. Browse your knowledge base, choose where the assistant writes, and work with notes without switching to a separate browser tab.
 
+::docs-video{src="/videos/docs-pocketbook.mp4" poster="/videos/posters/docs-pocketbook.png" alt="The Pocketbook inside a conversation"}
+::
+
 The app works in **ChatGPT web and desktop** and **Claude web and desktop** through the hosted Basic Memory Cloud connector.
 
-::theme-image{light="/screenshots/mcp-app/mcp-app-open-light.png" dark="/screenshots/mcp-app/mcp-app-open-dark.png" alt="The Basic Memory MCP App open inside an AI conversation"}
+::theme-image{light="/screenshots/mcp-app/mcp-app-open-light.png" dark="/screenshots/mcp-app/mcp-app-open-dark.png" alt="The Pocketbook open inside an AI conversation"}
 ::
 
 ## Your knowledge base inside the conversation
@@ -47,7 +50,7 @@ Clients without interactive MCP App support can still use the normal Basic Memor
 :::card-group
 ::card
 ---
-title: Interactive MCP App Guide
+title: Pocketbook Guide
 icon: i-lucide-panels-top-left
 to: /cloud/mcp-app
 ---

diff --git a/content/02.whats-new/05.changelog.md b/content/02.whats-new/05.changelog.md
@@ -25,14 +25,14 @@ This release also removes MCP tools and legacy API routes and changes several CL
 
 ---
 
-## August 2026 — Cloud review and interactive MCP Apps
+## August 2026 — Cloud review and Pocketbook
 
 *August 2026 · Basic Memory Cloud*
 
 Two new Cloud collaboration surfaces make it easier to work with people and AI assistants without leaving your notes or conversation:
 
 - **[Comments and Suggestions](/whats-new/comments-and-suggestions)** — add attributed comments or propose insertions, deletions, and replacements. Reviewers can reply, resolve comments, and accept or reject each suggestion individually.
-- **[Interactive MCP App](/whats-new/interactive-mcp-app)** — browse, search, graph, read, edit, and review Basic Memory inside ChatGPT and Claude on web or desktop. Set an active writing folder or add a specific note to the conversation as context.
+- **[Pocketbook](/whats-new/interactive-mcp-app)** — browse, search, graph, read, edit, and review Basic Memory inside ChatGPT and Claude on web or desktop. Set an active writing folder or add a specific note to the conversation as context.
 
 These are Basic Memory Cloud product updates. The versioned Core release notes continue under [All releases](#all-releases).
 

diff --git a/content/02.whats-new/08.cloud.md b/content/02.whats-new/08.cloud.md
@@ -9,7 +9,7 @@ Work with your knowledge base across multiple devices using cloud sync and stora
 
 Compatible MCP clients can now open a focused Basic Memory workspace directly in the conversation. Browse projects and folders, search notes, follow wiki links, explore the knowledge graph, edit notes, toggle tasks, and review suggested changes without leaving the chat.
 
-Ask your assistant to “Open Basic Memory” or “Open Basic Memory search for…” to use it. See [Interactive MCP App](/cloud/mcp-app).
+Ask your assistant to “Open Basic Memory” or “Open Basic Memory search for…” to use it. See [Pocketbook](/cloud/mcp-app).
 
 ## Comments and suggested edits
 

diff --git a/content/03.cloud/01.cloud-guide.md b/content/03.cloud/01.cloud-guide.md
@@ -5,6 +5,9 @@ description: Cloud remote MCP setup, web editor, CLI tools, and snapshots for Ba
 
 Basic Memory Cloud provides hosted MCP access with no local installation required. Bring your knowledge to the cloud - all your existing notes, connections, and context accessible from anywhere.
 
+::docs-video{src="/videos/hero.mp4" poster="/videos/posters/hero.png" alt="What Basic Memory is, in one minute"}
+::
+
 ::note{icon="i-lucide-cloud"}
 **Why use Basic Memory Cloud?**
 - Access from any device
@@ -61,7 +64,7 @@ Browse, edit, and collaborate on your cloud notes directly in your browser at [a
 For the complete web app guide including editing modes, drafts, AI collaboration, importing, and project management, see the [Web App Guide](/cloud/web-app).
 ::
 
-Compatible MCP clients can also open a focused Basic Memory workspace inside the conversation for browsing, search, graph exploration, editing, and review. See [Interactive MCP App](/cloud/mcp-app).
+Compatible MCP clients can also open a focused Basic Memory workspace inside the conversation for browsing, search, graph exploration, editing, and review. See [Pocketbook](/cloud/mcp-app).
 
 ---
 

diff --git a/content/03.cloud/02.web-app.md b/content/03.cloud/02.web-app.md
@@ -28,6 +28,9 @@ Click a folder in the sidebar to filter the note list. Select a note to open it
 
 ## Navigating notes
 
+::docs-video{src="/videos/docs-navigating-notes.mp4" poster="/videos/posters/docs-navigating-notes.png" alt="Folders, search, and pinning in the note list"}
+::
+
 ### Browse by folder
 
 Expand folders in the sidebar to navigate your project structure. Click a folder to filter the note list to that location.
@@ -64,6 +67,9 @@ The **Activity** view in the sidebar keeps you aware of what's happening across
 
 Open **Graph** in the sidebar for the Knowledge Graph, then pick a view: **Project** (cards), **Structured**, or **Explore** — a 2D/3D rendering of your knowledge graph, notes as nodes, relations as links. Drag to orbit, scroll to zoom, click a node to open the note, and filter by relation type or search for a note to focus on.
 
+::docs-video{src="/videos/docs-graph.mp4" poster="/videos/posters/docs-graph.png" alt="Focusing a node and its typed relations in the knowledge graph"}
+::
+
 ---
 
 ## Projects
@@ -91,6 +97,9 @@ Upload entire folders and folder trees via the [command line tools](/cloud/cloud
 
 Bring existing content into a writable project from **Settings → Import** — pick the team, target project, and an optional destination folder.
 
+::docs-video{src="/videos/docs-import.mp4" poster="/videos/posters/docs-import.png" alt="Importing a ZIP of Markdown into a project"}
+::
+
 | Import type | File |
 |-------------|------|
 | **Project ZIP** | A ZIP of a folder of Markdown files — directory structure is preserved (up to 100MB) |

diff --git a/content/03.cloud/03.note-editor.md b/content/03.cloud/03.note-editor.md
@@ -11,6 +11,9 @@ Notes in the [web app](/cloud/web-app) open ready to edit, and everything you wr
 
 The app has three modes, switchable from the toolbar or with keyboard shortcuts:
 
+::docs-video{src="/videos/docs-note-editor.mp4" poster="/videos/posters/docs-note-editor.png" alt="Switching between the three editing modes"}
+::
+
 | Mode | Shortcut | Description |
 |------|----------|-------------|
 | **Rich editor** | Cmd/Ctrl + Shift + I | WYSIWYG editing — type and format directly, with tables, code blocks, callouts, and task lists |
@@ -45,6 +48,9 @@ Press **Cmd/Ctrl + /** to see all formatting shortcuts.
 
 Open the **Frontmatter** panel from the toolbar (or the command palette) to edit a note's YAML metadata separately from its content.
 
+::docs-video{src="/videos/docs-frontmatter.mp4" poster="/videos/posters/docs-frontmatter.png" alt="Showing and editing a note's frontmatter"}
+::
+
 ::theme-image{light="/screenshots/cloud-app/v2-frontmatter-light.png" dark="/screenshots/cloud-app/v2-frontmatter-dark.png" alt="Edit Frontmatter"}
 ::
 
@@ -54,7 +60,7 @@ Open the **Frontmatter** panel from the toolbar (or the command palette) to edit
 
 Select text in the rich editor to add a comment or suggest an insertion, deletion, or replacement. Review items stay with the Markdown note so people and connected assistants can discuss and accept changes individually.
 
-See [Comments and Suggestions](/cloud/comments-and-suggestions) for the complete web app, MCP App, and CriticMarkup workflow.
+See [Comments and Suggestions](/cloud/comments-and-suggestions) for the complete web app, Pocketbook, and CriticMarkup workflow.
 
 ---
 
@@ -113,6 +119,9 @@ Every save creates a new version. Click the **File history** icon (clock) in a n
 
 ## Keyboard Shortcuts
 
+::docs-video{src="/videos/docs-command-palette.mp4" poster="/videos/posters/docs-command-palette.png" alt="The command palette"}
+::
+
 The web app is designed for keyboard-first navigation. Press **Cmd/Ctrl + /** to see the full list in the app.
 
 ### Command palette

diff --git a/content/03.cloud/04.ai-collaboration.md b/content/03.cloud/04.ai-collaboration.md
@@ -17,6 +17,9 @@ Select text in the editor and it appears in the agent pane, where you can send a
 
 If you want to review changes before applying them, ask the agent to leave **CriticMarkup comments and suggestions** instead of rewriting the passage. Basic Memory renders that feedback in the review rail, where you can reply to comments, resolve threads, and accept or reject each proposed edit. See [Comments and Suggestions](/cloud/comments-and-suggestions).
 
+::docs-video{src="/videos/docs-comments-suggestions.mp4" poster="/videos/posters/docs-comments-suggestions.png" alt="Suggesting edits and reviewing them with an AI assistant"}
+::
+
 ## The agent pane
 
 The agent pane shows the session: what the agent is working on, its progress, and a place to steer it ("Ask for a rewrite, summary, or next step…"). Updates flow into the note in real time, so you can follow along while it writes.

diff --git a/content/03.cloud/07.themes.md b/content/03.cloud/07.themes.md
@@ -5,6 +5,9 @@ description: Personalize the web app with color themes and light, dark, or syste
 
 The Basic Memory web app ships with a set of curated color themes, each with coordinated palettes for light and dark mode. Pick both under **Settings → General**, in the **Look & Feel** card.
 
+::docs-video{src="/videos/docs-themes.mp4" poster="/videos/posters/docs-themes.png" alt="Choosing a theme and color mode"}
+::
+
 ---
 
 ## Color mode

diff --git a/content/03.cloud/14.comments-and-suggestions.md b/content/03.cloud/14.comments-and-suggestions.md
@@ -5,7 +5,10 @@ description: Review notes with comments, suggested edits, and portable CriticMar
 
 Basic Memory keeps review feedback with the note, so people and connected AI assistants can discuss a passage or propose a change without overwriting the original text.
 
-Under the rich editor, comments and suggestions use portable [CriticMarkup](https://github.com/CriticMarkup/CriticMarkup-toolkit). You can review the same note in the Cloud web app or the **Basic Memory MCP App** inside a compatible AI conversation.
+Under the rich editor, comments and suggestions use portable [CriticMarkup](https://github.com/CriticMarkup/CriticMarkup-toolkit). You can review the same note in the Cloud web app or the **Pocketbook** inside a compatible AI conversation.
+
+::docs-video{src="/videos/docs-comments-suggestions.mp4" poster="/videos/posters/docs-comments-suggestions.png" alt="Suggesting edits and reviewing them with an AI assistant"}
+::
 
 ---
 
@@ -109,7 +112,7 @@ Basic Memory adds stable IDs and attributed review records when it creates a thr
 
 ## Review inside a conversation
 
-The [Basic Memory MCP App](/cloud/mcp-app) brings the same focused review workflow into compatible AI clients. From the embedded note reader you can:
+The [Pocketbook](/cloud/mcp-app) brings the same focused review workflow into compatible AI clients. From the embedded note reader you can:
 
 - Add attributed comments
 - Suggest insertions, deletions, and replacements
@@ -142,7 +145,7 @@ Connect assistants that can read, write, and review your notes.
 
 ::card
 ---
-title: Interactive MCP App
+title: Pocketbook
 icon: i-lucide-panels-top-left
 to: /cloud/mcp-app
 ---
-Original file line number
+Diff line change
@@ Expand Up @@
     The Basic Memory web app ships with a set of curated color themes, each with coordinated palettes for light and dark mode. Pick both under **Settings → General**, in the **Look & Feel** card.
+    ::docs-video{src="/videos/docs-themes.mp4" poster="/videos/posters/docs-themes.png" alt="Choosing a theme and color mode"}
+    ::
     ---
     ## Color mode
@@ Expand Down @@