basicmachines-co · phernandez · Aug 27, 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,54 @@
+<template>
+  <span class="block">
+    <video
+      ref="videoElement"
+      :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">
+const props = defineProps<{
+  src: string
+  poster?: string
+  posterDark?: string
+  alt?: string
+}>()
+
+const videoElement = ref<HTMLVideoElement>()
+let colorModeObserver: MutationObserver | undefined
+
+onMounted(() => {
+  const root = document.documentElement
+  const syncPoster = () => {
+    if (!props.poster || !videoElement.value) {
+      return
+    }
+
+    const poster = root.classList.contains('dark')
+      ? props.posterDark ?? props.poster.replace(/(\.[^./]+)$/, '-dark$1')
+      : props.poster
+
+    if (videoElement.value.getAttribute('poster') !== poster) {
+      videoElement.value.setAttribute('poster', poster)
+    }
+  }
+
+  colorModeObserver = new MutationObserver(syncPoster)
+  colorModeObserver.observe(root, {
+    attributes: true,
+    attributeFilter: ['class'],
+  })
+  syncPoster()
+})
+
+onBeforeUnmount(() => {
+  colorModeObserver?.disconnect()
+})
+</script>
diff --git a/content/0.welcome.md b/content/0.welcome.md
@@ -11,9 +11,11 @@ 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. The latest patch, v0.23.2, adds complete PostgreSQL full-text search and prevents case-duplicate folders. 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. The latest patch, v0.23.2, adds complete PostgreSQL full-text search and prevents case-duplicate folders. 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 [Pocketbook (Interactive MCP App)](/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
 
 :::card-group
@@ -72,7 +74,7 @@ title: Teams
 icon: i-lucide-users
 to: /teams/about
 ---
-Share one knowledge base with your team — roles, invites, and real-time editing.
+Share one knowledge base with your team — roles, invites, and shared projects.
 ::
 
 ::card

diff --git a/content/01.start-here/1.what-is-basic-memory.md b/content/01.start-here/1.what-is-basic-memory.md
@@ -7,8 +7,8 @@ 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"}
+::docs-video{src="/videos/hero.mp4" poster="/videos/posters/hero.png" alt="What Basic Memory is, in one minute"}
+::
 
 ## 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: |
@@ -31,6 +34,9 @@ The published ChatGPT and Claude listings are the quickest setup paths. Choose y
 
 ### For Claude
 
+::docs-video{src="/videos/docs-connect-claude.mp4" poster="/videos/posters/docs-connect-claude.png" alt="Installing the Basic Memory Cloud connector in Claude and verifying it"}
+::
+
 1. Open the [Claude Directory](https://claude.ai/directory), or go to **Settings → Customize → Connectors** and select **+**.
 2. Search for **Basic Memory Cloud**, open the published connector, and select **Install**.
 3. Complete authorization, then ask Claude to list your Basic Memory projects.
@@ -39,6 +45,9 @@ The remote connector works across Claude web, desktop, mobile, Cowork, and Claud
 
 ### For ChatGPT
 
+::docs-video{src="/videos/docs-connect-chatgpt.mp4" poster="/videos/posters/docs-connect-chatgpt.png" alt="Installing the Basic Memory Cloud plugin in ChatGPT and using it in a chat"}
+::
+
 ::steps
 ### Open the plugin
 
@@ -121,7 +130,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
@@ -143,6 +152,9 @@ Basic Memory is better shared — one knowledge base for you, your teammates, an
 
 Invite people from **Settings → Members** in the web app — they get an email, sign in, and start working in the shared projects right away. See [Basic Memory Teams](/teams/about) for workspaces, roles, and seats.
 
+::docs-video{src="/videos/docs-teams-invite.mp4" poster="/videos/posters/docs-teams-invite.png" alt="Inviting a teammate by email, and what they see when they accept"}
+::
+
 ---
 
 ## What you can do now

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,7 +5,10 @@ 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.
 
-::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"}
+::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" class="mt-6"}
 ::
 
 ## Review without rewriting
@@ -28,7 +31,7 @@ The note toolbar shows the number of unresolved comments and suggestions. Open i
 
 ## Review with an AI assistant
 
-Connected assistants now use the Cloud `review_note` MCP tool to add comments or insertion, deletion, and replacement suggestions without immediately rewriting the note. The same attributed threads appear in the Cloud editor and the interactive MCP App, where people and assistants can reply, resolve comments, and accept or reject suggestions.
+Connected assistants now use the Cloud `review_note` MCP tool to add comments or insertion, deletion, and replacement suggestions without immediately rewriting the note. The same attributed threads appear in the Cloud editor and Pocketbook (the Interactive MCP App), where people and assistants can reply, resolve comments, and accept or reject suggestions.
 
 Cloud's `read_note`, `edit_note`, and `search_notes` tools are review-aware too: reads return clean prose and structured threads by default, ordinary edits preserve active review work and reject overlapping changes, and search hides CriticMarkup while reporting review-attention counts.
 
@@ -54,7 +57,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 (Interactive MCP App)
 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.
+Basic Memory Cloud can now open **Pocketbook**, its Interactive MCP 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/04.teams.md b/content/02.whats-new/04.teams.md
@@ -21,6 +21,9 @@ Teams is a cloud feature and requires a subscription with one or more seats. Bil
 
 ## Invite your team
 
+::docs-video{src="/videos/docs-teams-invite.mp4" poster="/videos/posters/docs-teams-invite.png" alt="Inviting a teammate by email, and what they see when they accept"}
+::
+
 Invite members by email from **Settings → Members** — they sign in, pick up their role, and start working in the shared projects right away. Roles, statuses, and member management are covered in [Members and Roles](/teams/members-and-roles).
 
 ## Get started

diff --git a/content/02.whats-new/05.changelog.md b/content/02.whats-new/05.changelog.md
@@ -27,14 +27,16 @@ 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. The Cloud `review_note` MCP tool gives connected assistants the same reply, resolve, accept, and reject workflow with checksum conflict protection.
-- **[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 (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.
+
+AI-assisted review is integrated across the Cloud note tools. `read_note` returns clean prose, typed review threads, and a revision checksum; `edit_note` preserves open review work and blocks changes that overlap reviewed text; and `search_notes` keeps review markup out of results while reporting items that still need attention. See [Review with an AI assistant](/cloud/comments-and-suggestions#review-with-an-ai-assistant) for the complete workflow.
 
 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/07.hermes-plugin.md b/content/02.whats-new/07.hermes-plugin.md
@@ -22,9 +22,22 @@ The [hermes-basic-memory](https://github.com/basicmachines-co/basic-memory/tree/
 
 ## Quick Install
 
-Managed installation requires a Hermes Agent release containing the
-[manifest-v2 installer fix](https://github.com/NousResearch/hermes-agent/pull/85893).
-Hermes Agent v0.20.5 (`v2026.8.19`) and earlier are not supported.
+::warning
+**Managed install is currently blocked upstream.** This plugin ships
+`manifest_version: 2`, but `hermes plugins install` caps at version 1 on every
+released Hermes Agent (latest: v0.20.5 / `v2026.8.19`), so the command fails with
+*"requires manifest_version 2, but this installer only supports up to 1."* The fix
+is [an open pull request](https://github.com/NousResearch/hermes-agent/pull/85893)
+that has not shipped in a release yet, so updating Hermes will not help.
+
+Until it lands, clone the repo and link the plugin in directly — the Hermes
+*runtime* loads manifest v2 without trouble; only the installer is capped:
+
+```bash
+git clone https://github.com/basicmachines-co/basic-memory.git
+ln -snf "$PWD/basic-memory/integrations/hermes" ~/.hermes/plugins/basic-memory
+```
+::
 
 ```bash
 hermes plugins install basicmachines-co/basic-memory/integrations/hermes

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/02.whats-new/10.openclaw-plugin.md b/content/02.whats-new/10.openclaw-plugin.md
@@ -7,6 +7,9 @@ The [openclaw-basic-memory](https://github.com/basicmachines-co/basic-memory/tre
 
 [Basic Memory](/start-here/what-is-basic-memory) is a knowledge base that you and your AI share. This plugin connects it to OpenClaw so your agent remembers past conversations, decisions, and context.
 
+::docs-video{src="/videos/docs-openclaw-remembers.mp4" poster="/videos/posters/docs-openclaw-remembers.png" alt="An agent recalling open tasks at session start, then writing back to the note"}
+::
+
 ::tip
 **[Read the full OpenClaw Plugin guide →](/integrations/openclaw)** — configuration options, the complete tool reference, slash commands, and bundled skills.
 ::
@@ -23,13 +26,18 @@ The [openclaw-basic-memory](https://github.com/basicmachines-co/basic-memory/tre
 
 ## Quick Install
 
+::docs-video{src="/videos/docs-openclaw-cloud.mp4" poster="/videos/posters/docs-openclaw-cloud.png" alt="Installing the plugin and pointing it at a Basic Memory Cloud project"}
+::
+
 ```bash
 openclaw plugins install @basicmemory/openclaw-basic-memory
-openclaw plugins enable openclaw-basic-memory --slot memory
 openclaw gateway restart
 ```
 
-Works out of the box with zero configuration.
+That's it. Installing enables the plugin and claims OpenClaw's `memory` slot
+automatically — no config editing required. Verify with
+`openclaw plugins doctor`. See the [OpenClaw plugin guide](/integrations/openclaw)
+for pointing it at an existing project.
 
 ## Next Steps
 

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.
@@ -58,12 +61,18 @@ Open a note's `⋮` menu (or use the command palette) and choose **Pin Note**. P
 
 The **Activity** view in the sidebar keeps you aware of what's happening across the workspace — operations in progress (imports, indexing, large edits) and recent completed changes from every member **and connected agent**, with direct links to the affected notes. When your assistant writes a note over MCP, it shows up here live.
 
+::docs-video{src="/videos/docs-activity.mp4" poster="/videos/posters/docs-activity.png" alt="The Activity feed showing recent changes"}
+::
+
 ---
 
 ## Explore the graph
 
 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 +100,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) |