basicmachines-co
diff --git a/‎app/components/content/DocsVideo.vue‎
Lines changed: 54 additions & 0 deletions b/‎app/components/content/DocsVideo.vue‎
Lines changed: 54 additions & 0 deletions
diff --git a/‎content/0.welcome.md‎
Lines changed: 4 additions & 2 deletions b/‎content/0.welcome.md‎
Lines changed: 4 additions & 2 deletions
diff --git a/‎content/01.start-here/1.what-is-basic-memory.md‎
Lines changed: 2 additions & 2 deletions b/‎content/01.start-here/1.what-is-basic-memory.md‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎content/01.start-here/2.quickstart-cloud.md‎
Lines changed: 13 additions & 1 deletion b/‎content/01.start-here/2.quickstart-cloud.md‎
Lines changed: 13 additions & 1 deletion
diff --git a/‎content/02.whats-new/01.v0-23.md‎
Lines changed: 3 additions & 0 deletions b/‎content/02.whats-new/01.v0-23.md‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎content/02.whats-new/02.comments-and-suggestions.md‎
Lines changed: 6 additions & 3 deletions b/‎content/02.whats-new/02.comments-and-suggestions.md‎
Lines changed: 6 additions & 3 deletions
diff --git a/‎content/02.whats-new/03.interactive-mcp-app.md‎
Lines changed: 7 additions & 4 deletions b/‎content/02.whats-new/03.interactive-mcp-app.md‎
Lines changed: 7 additions & 4 deletions
diff --git a/‎content/02.whats-new/04.teams.md‎
Lines changed: 3 additions & 0 deletions b/‎content/02.whats-new/04.teams.md‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎content/02.whats-new/05.changelog.md‎
Lines changed: 4 additions & 2 deletions b/‎content/02.whats-new/05.changelog.md‎
Lines changed: 4 additions & 2 deletions
diff --git a/‎content/02.whats-new/07.hermes-plugin.md‎
Lines changed: 16 additions & 3 deletions b/‎content/02.whats-new/07.hermes-plugin.md‎
Lines changed: 16 additions & 3 deletions
@@ -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>
@@ -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
 
@@ -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?
 
 
@@ -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
 
@@ -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
 
@@ -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
 ---
 
@@ -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
 ---
 
@@ -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
 
@@ -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).
 
 
@@ -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