diff --git a/app/components/content/DocsVideo.vue b/app/components/content/DocsVideo.vue
new file mode 100644
index 0000000..171439b
--- /dev/null
+++ b/app/components/content/DocsVideo.vue
@@ -0,0 +1,21 @@
+
+
+
+
+
+
+
diff --git a/content/0.welcome.md b/content/0.welcome.md
index 2bb7275..f1926ab 100644
--- 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
index ba32da7..e1c9363 100644
--- 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
index 20fbce4..f5698a2 100644
--- 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
index 51d0499..2501a32 100644
--- 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
index 2c07c25..3d3abdf 100644
--- 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
index d9aa6cb..abe61da 100644
--- 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
index fbb9711..c5478b0 100644
--- 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
index 6d9ff63..afeab63 100644
--- 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
index c5a7445..a3a2b1c 100644
--- 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
index ea6156a..d0db635 100644
--- 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) |
diff --git a/content/03.cloud/03.note-editor.md b/content/03.cloud/03.note-editor.md
index 952b518..7422e0f 100644
--- 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
index c7168b2..6849f09 100644
--- 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
index dc76d89..bb6e997 100644
--- 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/11.file-history.md b/content/03.cloud/11.file-history.md
index 6a5e50b..ee8975f 100644
--- a/content/03.cloud/11.file-history.md
+++ b/content/03.cloud/11.file-history.md
@@ -9,6 +9,9 @@ Every saved version of a note is preserved automatically in Basic Memory Cloud.
File history is a cloud feature. Versions are created automatically on every save — no setup, nothing to turn on.
::
+::docs-video{src="/videos/docs-file-history.mp4" poster="/videos/posters/docs-file-history.png" alt="Opening File history and restoring an earlier version of a note"}
+::
+
---
## Open File history
diff --git a/content/03.cloud/14.comments-and-suggestions.md b/content/03.cloud/14.comments-and-suggestions.md
index df1da91..4d229b9 100644
--- 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
---
diff --git a/content/03.cloud/15.mcp-app.md b/content/03.cloud/15.mcp-app.md
index 83e0830..a26f799 100644
--- a/content/03.cloud/15.mcp-app.md
+++ b/content/03.cloud/15.mcp-app.md
@@ -1,14 +1,17 @@
---
-title: Interactive MCP App
+title: Pocketbook
description: Browse, search, graph, read, review, and edit Basic Memory from a compatible MCP conversation.
---
-Basic Memory Cloud includes an interactive **Basic Memory MCP App** inside compatible AI clients. It brings a focused version of your workspace into the conversation, so you can browse notes, set a writing location, or make a quick edit without switching to a separate browser tab.
+Basic Memory Cloud includes an interactive **Pocketbook** inside compatible AI clients. It brings a focused version of your workspace into the conversation, so you can browse notes, set a writing location, or make a quick edit without switching to a separate browser tab.
The app is part of the hosted Cloud connector at `https://cloud.basicmemory.com/mcp`; there is no second server or separate installation.
+::docs-video{src="/videos/docs-pocketbook.mp4" poster="/videos/posters/docs-pocketbook.png" alt="The Pocketbook inside a conversation"}
+::
+
::note
-Interactive MCP Apps are currently supported in:
+Pocketbooks are currently supported in:
- **ChatGPT** — web and desktop
- **Claude** — web and desktop
@@ -31,33 +34,33 @@ Show the knowledge graph around my architecture note.
Your assistant calls `open_basic_memory` and opens the requested view. The default workspace and project resolve automatically, so you do not need to list or choose a project first unless you want a different location.
-::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 to the Notes gallery 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 to the Notes gallery inside an AI conversation"}
::
## Expand the app to full screen
When your AI client supports full-screen MCP Apps, the diagonal-arrow **Expand** action appears in the app header beside the link to the full Basic Memory web app.
-::theme-image{light="/screenshots/mcp-app/mcp-app-expand-control-light.png" dark="/screenshots/mcp-app/mcp-app-expand-control-dark.png" alt="The Expand action in the Basic Memory MCP App header"}
+::theme-image{light="/screenshots/mcp-app/mcp-app-expand-control-light.png" dark="/screenshots/mcp-app/mcp-app-expand-control-dark.png" alt="The Expand action in Pocketbook header"}
::
Choose **Expand** to move from the compact conversation card into a larger workspace. Full-screen mode keeps the project or folder picker, **Notes**, **Search**, **Graph**, the active writing-location control, and the full web-app link together while giving note cards, editors, and graphs more room.
The exact full-screen frame is controlled by the AI client. Use its close or return control to go back to the conversation.
-::theme-image{light="/screenshots/mcp-app/mcp-app-fullscreen-light.png" dark="/screenshots/mcp-app/mcp-app-fullscreen-dark.png" alt="The Basic Memory MCP App expanded to a full-screen workspace in an AI client"}
+::theme-image{light="/screenshots/mcp-app/mcp-app-fullscreen-light.png" dark="/screenshots/mcp-app/mcp-app-fullscreen-dark.png" alt="The Pocketbook expanded to a full-screen workspace in an AI client"}
::
## Choose where new notes go
The **Notes** view is both a browser and a location picker. Use the breadcrumb at the top to switch workspaces, projects, and folders. Folder cards show their note counts, note cards open in place, and **Load more** pages through longer directories. The external-link action opens the current location in the full Basic Memory web app.
-::theme-image{light="/screenshots/mcp-app/mcp-app-use-folder-light.png" dark="/screenshots/mcp-app/mcp-app-use-folder-dark.png" alt="The Use this folder button before a writing location is selected in the Basic Memory MCP App"}
+::theme-image{light="/screenshots/mcp-app/mcp-app-use-folder-light.png" dark="/screenshots/mcp-app/mcp-app-use-folder-dark.png" alt="The Use this folder button before a writing location is selected in Pocketbook"}
::
Choose **Use this folder** to make the current workspace, project, and directory the active writing location for the conversation. The app marks it as **Active folder**, and the copy action lets you reuse its Basic Memory location elsewhere.
-::theme-image{light="/screenshots/mcp-app/mcp-app-active-folder-light.png" dark="/screenshots/mcp-app/mcp-app-active-folder-dark.png" alt="A folder selected as the active writing location in the Basic Memory MCP App"}
+::theme-image{light="/screenshots/mcp-app/mcp-app-active-folder-light.png" dark="/screenshots/mcp-app/mcp-app-active-folder-dark.png" alt="A folder selected as the active writing location in Pocketbook"}
::
The app sends the location into the conversation and asks the assistant to write new notes there until you choose another folder. The assistant can then keep the workspace, project, and directory attached to later Basic Memory calls instead of asking you to select them again.
@@ -85,12 +88,12 @@ From the reader you can:
In the Notes gallery, hover over a note card and choose **Use note in conversation**. The app prepares a prompt that tells the assistant to use that note in the current conversation thread.
-::theme-image{light="/screenshots/mcp-app/mcp-app-use-note-gallery-light.png" dark="/screenshots/mcp-app/mcp-app-use-note-gallery-dark.png" alt="The Use note in conversation action on a note card in the Basic Memory MCP App gallery"}
+::theme-image{light="/screenshots/mcp-app/mcp-app-use-note-gallery-light.png" dark="/screenshots/mcp-app/mcp-app-use-note-gallery-dark.png" alt="The Use note in conversation action on a note card in Pocketbook gallery"}
::
You can also open the note and click its title in the reader to use it in the conversation.
-::theme-image{light="/screenshots/mcp-app/mcp-app-use-note-title-light.png" dark="/screenshots/mcp-app/mcp-app-use-note-title-dark.png" alt="The clickable note title in the full Basic Memory MCP App reader header"}
+::theme-image{light="/screenshots/mcp-app/mcp-app-use-note-title-light.png" dark="/screenshots/mcp-app/mcp-app-use-note-title-dark.png" alt="The clickable note title in the full Pocketbook reader header"}
::
The prompt identifies the note by workspace, project, and permalink, so the assistant can read the right note and use it as context. You can add your question or instructions before sending it.
@@ -102,7 +105,7 @@ The prompt identifies the note by workspace, project, and permalink, so the assi
Open **Search**, enter a query, and choose whether to search the current project or all projects you can access. Results show matching excerpts and their locations; select one to open it in the reader without leaving the app.
-::theme-image{light="/screenshots/mcp-app/mcp-app-search-light.png" dark="/screenshots/mcp-app/mcp-app-search-dark.png" alt="Search results in the Basic Memory MCP App"}
+::theme-image{light="/screenshots/mcp-app/mcp-app-search-light.png" dark="/screenshots/mcp-app/mcp-app-search-dark.png" alt="Search results in Pocketbook"}
::
## Edit and review in place
diff --git a/content/07.concepts/6.schema-system.md b/content/07.concepts/6.schema-system.md
index f4f1263..e51897b 100644
--- a/content/07.concepts/6.schema-system.md
+++ b/content/07.concepts/6.schema-system.md
@@ -5,6 +5,9 @@ description: Define, validate, and evolve note structure in Basic Memory with sc
In Basic Memory, your notes are Markdown files with structured information — facts (called [observations](/concepts/observations-and-relations)) and links to other notes (called [relations](/concepts/observations-and-relations)). A schema describes what a particular type of note should contain — like making sure every person note has a name.
+::docs-video{src="/videos/docs-schema-system.mp4" poster="/videos/posters/docs-schema-system.png" alt="Schema validation catching a bad record, fixed with one sentence"}
+::
+
Schemas are optional. You can use Basic Memory without ever defining one. But as your knowledge base grows, schemas help you keep notes consistent and give your AI a guide for creating well-structured notes.
---
diff --git a/content/07.concepts/7.semantic-search.md b/content/07.concepts/7.semantic-search.md
index 38f84b8..0edf23a 100644
--- a/content/07.concepts/7.semantic-search.md
+++ b/content/07.concepts/7.semantic-search.md
@@ -5,6 +5,9 @@ description: Meaning-based retrieval with vector and hybrid search in Basic Memo
Most knowledge tools make you organize everything up front so you can find it later. Basic Memory takes the opposite approach — write naturally, and let search figure out the connections.
+::docs-video{src="/videos/docs-semantic-search.mp4" poster="/videos/posters/docs-semantic-search.png" alt="Semantic search answering a plain-language question"}
+::
+
When you or your AI save a note, Basic Memory indexes it two ways: by the exact words it contains, and by what it *means*. Search for "login security improvements" and find notes about "authentication hardening" even though the exact words don't match. This happens automatically — no tagging system to maintain, no folder hierarchy to get right.
What makes this different from a typical search tool is that your AI is part of the loop. It writes notes, searches them, and builds on what it finds — all through the same tools. The search index updates incrementally as notes change, so the AI is always working with current knowledge, not a stale snapshot.
diff --git a/content/07.concepts/8.metadata-search.md b/content/07.concepts/8.metadata-search.md
index 1ce06a4..5adad10 100644
--- a/content/07.concepts/8.metadata-search.md
+++ b/content/07.concepts/8.metadata-search.md
@@ -5,6 +5,9 @@ description: Filter and find notes by their YAML frontmatter — status, type, t
Every note in Basic Memory has YAML frontmatter at the top. Metadata search lets you find notes by those fields — status, type, tags, custom fields, anything you put there. It's how you ask things like _"show me all in-progress specs tagged security"_ or _"find decisions made in the last quarter with priority high or critical"_ without scanning text.
+::docs-video{src="/videos/docs-metadata-search.mp4" poster="/videos/posters/docs-metadata-search.png" alt="Filtering notes by frontmatter fields in Structured search"}
+::
+
Metadata search is a parameter on the same [`search_notes`](/reference/mcp-tools-reference#search_notes) tool you use for text and [semantic search](/concepts/semantic-search). You can use it on its own, or combine it with a text query and tag filters.
::tip
diff --git a/content/08.integrations/01.claude-desktop.md b/content/08.integrations/01.claude-desktop.md
index 52516be..8cc4204 100644
--- a/content/08.integrations/01.claude-desktop.md
+++ b/content/08.integrations/01.claude-desktop.md
@@ -157,6 +157,16 @@ What have we been working on this week?
Claude checks recent activity and offers to continue any thread. Changes sync in real time — edits you make in any text editor appear instantly in your next conversation.
+**Open your knowledge base in the conversation:**
+```
+Open Basic Memory
+```
+
+Claude displays the **[Pocketbook](/cloud/mcp-app)** — a working interface inside the chat. Browse folders and notes, open the full editor to make changes in place, or point the agent at a folder so new notes land where you want them.
+
+::docs-video{src="/videos/docs-pocketbook-claude.mp4" poster="/videos/posters/docs-pocketbook-claude.png" alt="Pocketbook running inside Claude Desktop"}
+::
+
You can also reference specific notes with `memory://` URLs. Learn more in [Memory URLs](/concepts/memory-urls).
---
diff --git a/content/08.integrations/04.chatgpt.md b/content/08.integrations/04.chatgpt.md
index 43e9678..8070069 100644
--- a/content/08.integrations/04.chatgpt.md
+++ b/content/08.integrations/04.chatgpt.md
@@ -72,7 +72,10 @@ ChatGPT will call the appropriate tools behind the scenes, searching and fetchin
## Use the interactive Basic Memory app
-When you ask to open or browse Basic Memory, ChatGPT can display the **Basic Memory MCP App** directly in the conversation. From there you can switch projects and folders, browse or search notes, explore the graph, follow wiki links, edit notes, toggle tasks, and work through comments and suggested edits.
+When you ask to open or browse Basic Memory, ChatGPT can display the **Pocketbook** directly in the conversation. From there you can switch projects and folders, browse or search notes, explore the graph, follow wiki links, edit notes, toggle tasks, and work through comments and suggested edits.
+
+::docs-video{src="/videos/docs-pocketbook.mp4" poster="/videos/posters/docs-pocketbook.png" alt="Pocketbook inside a ChatGPT conversation"}
+::
Try:
@@ -80,7 +83,7 @@ Try:
Open Basic Memory search for quarterly planning.
```
-If you only ask a question about your notes, ChatGPT uses the normal search and read tools instead of opening the interface. See [Interactive MCP App](/cloud/mcp-app) for the full workflow.
+If you only ask a question about your notes, ChatGPT uses the normal search and read tools instead of opening the interface. See [Pocketbook](/cloud/mcp-app) for the full workflow.
## Important Notes
@@ -131,7 +134,7 @@ Complete documentation for every MCP tool.
::card
---
-title: Interactive MCP App
+title: Pocketbook
icon: i-lucide-panels-top-left
to: /cloud/mcp-app
---
diff --git a/content/10.reference/2.mcp-tools-reference.md b/content/10.reference/2.mcp-tools-reference.md
index 055c1fb..ac7be41 100644
--- a/content/10.reference/2.mcp-tools-reference.md
+++ b/content/10.reference/2.mcp-tools-reference.md
@@ -117,7 +117,7 @@ Render a note as a formatted artifact for display in MCP clients. Returns the no
### `open_basic_memory` (Cloud)
-Open the interactive Basic Memory MCP App in a compatible client. Use this when the user wants to see, browse, navigate, or interact with Basic Memory visually. Use `read_note`, `search_notes`, or `list_directory` instead when the assistant only needs data for its answer.
+Open the interactive Pocketbook in a compatible client. Use this when the user wants to see, browse, navigate, or interact with Basic Memory visually. Use `read_note`, `search_notes`, or `list_directory` instead when the assistant only needs data for its answer.
The default workspace and project resolve automatically. Do not call `list_memory_projects` first unless the user asks for project metadata or wants a non-default location.
@@ -143,7 +143,7 @@ open_basic_memory(view="note", identifier="memory://main/plans/api", note_mode="
open_basic_memory(view="graph", identifier="Architecture", graph_mode="full")
```
-See [Interactive MCP App](/cloud/mcp-app) for the user workflow.
+See [Pocketbook](/cloud/mcp-app) for the user workflow.
---
diff --git a/public/videos/docs-activity.mp4 b/public/videos/docs-activity.mp4
new file mode 100644
index 0000000..2cbeb57
Binary files /dev/null and b/public/videos/docs-activity.mp4 differ
diff --git a/public/videos/docs-command-palette.mp4 b/public/videos/docs-command-palette.mp4
new file mode 100644
index 0000000..f7c2fa4
Binary files /dev/null and b/public/videos/docs-command-palette.mp4 differ
diff --git a/public/videos/docs-comments-suggestions.mp4 b/public/videos/docs-comments-suggestions.mp4
new file mode 100644
index 0000000..064a25c
Binary files /dev/null and b/public/videos/docs-comments-suggestions.mp4 differ
diff --git a/public/videos/docs-file-history.mp4 b/public/videos/docs-file-history.mp4
new file mode 100644
index 0000000..bc9b444
Binary files /dev/null and b/public/videos/docs-file-history.mp4 differ
diff --git a/public/videos/docs-frontmatter.mp4 b/public/videos/docs-frontmatter.mp4
new file mode 100644
index 0000000..a1d47b1
Binary files /dev/null and b/public/videos/docs-frontmatter.mp4 differ
diff --git a/public/videos/docs-graph.mp4 b/public/videos/docs-graph.mp4
new file mode 100644
index 0000000..784e534
Binary files /dev/null and b/public/videos/docs-graph.mp4 differ
diff --git a/public/videos/docs-import.mp4 b/public/videos/docs-import.mp4
new file mode 100644
index 0000000..abab0f1
Binary files /dev/null and b/public/videos/docs-import.mp4 differ
diff --git a/public/videos/docs-metadata-search.mp4 b/public/videos/docs-metadata-search.mp4
new file mode 100644
index 0000000..0437de4
Binary files /dev/null and b/public/videos/docs-metadata-search.mp4 differ
diff --git a/public/videos/docs-navigating-notes.mp4 b/public/videos/docs-navigating-notes.mp4
new file mode 100644
index 0000000..5918b29
Binary files /dev/null and b/public/videos/docs-navigating-notes.mp4 differ
diff --git a/public/videos/docs-note-editor.mp4 b/public/videos/docs-note-editor.mp4
new file mode 100644
index 0000000..5136050
Binary files /dev/null and b/public/videos/docs-note-editor.mp4 differ
diff --git a/public/videos/docs-pocketbook-claude.mp4 b/public/videos/docs-pocketbook-claude.mp4
new file mode 100644
index 0000000..406f333
Binary files /dev/null and b/public/videos/docs-pocketbook-claude.mp4 differ
diff --git a/public/videos/docs-pocketbook.mp4 b/public/videos/docs-pocketbook.mp4
new file mode 100644
index 0000000..9391592
Binary files /dev/null and b/public/videos/docs-pocketbook.mp4 differ
diff --git a/public/videos/docs-quickstart.mp4 b/public/videos/docs-quickstart.mp4
new file mode 100644
index 0000000..883ccfa
Binary files /dev/null and b/public/videos/docs-quickstart.mp4 differ
diff --git a/public/videos/docs-schema-system.mp4 b/public/videos/docs-schema-system.mp4
new file mode 100644
index 0000000..f56d83c
Binary files /dev/null and b/public/videos/docs-schema-system.mp4 differ
diff --git a/public/videos/docs-semantic-search.mp4 b/public/videos/docs-semantic-search.mp4
new file mode 100644
index 0000000..af30580
Binary files /dev/null and b/public/videos/docs-semantic-search.mp4 differ
diff --git a/public/videos/docs-themes.mp4 b/public/videos/docs-themes.mp4
new file mode 100644
index 0000000..77ea935
Binary files /dev/null and b/public/videos/docs-themes.mp4 differ
diff --git a/public/videos/hero.mp4 b/public/videos/hero.mp4
new file mode 100644
index 0000000..477d633
Binary files /dev/null and b/public/videos/hero.mp4 differ
diff --git a/public/videos/posters/docs-activity.png b/public/videos/posters/docs-activity.png
new file mode 100644
index 0000000..0bdc35c
Binary files /dev/null and b/public/videos/posters/docs-activity.png differ
diff --git a/public/videos/posters/docs-command-palette.png b/public/videos/posters/docs-command-palette.png
new file mode 100644
index 0000000..4183bae
Binary files /dev/null and b/public/videos/posters/docs-command-palette.png differ
diff --git a/public/videos/posters/docs-comments-suggestions.png b/public/videos/posters/docs-comments-suggestions.png
new file mode 100644
index 0000000..ba52d64
Binary files /dev/null and b/public/videos/posters/docs-comments-suggestions.png differ
diff --git a/public/videos/posters/docs-file-history.png b/public/videos/posters/docs-file-history.png
new file mode 100644
index 0000000..b01f2e6
Binary files /dev/null and b/public/videos/posters/docs-file-history.png differ
diff --git a/public/videos/posters/docs-frontmatter.png b/public/videos/posters/docs-frontmatter.png
new file mode 100644
index 0000000..38a817c
Binary files /dev/null and b/public/videos/posters/docs-frontmatter.png differ
diff --git a/public/videos/posters/docs-graph.png b/public/videos/posters/docs-graph.png
new file mode 100644
index 0000000..2efc354
Binary files /dev/null and b/public/videos/posters/docs-graph.png differ
diff --git a/public/videos/posters/docs-import.png b/public/videos/posters/docs-import.png
new file mode 100644
index 0000000..d9c5ee9
Binary files /dev/null and b/public/videos/posters/docs-import.png differ
diff --git a/public/videos/posters/docs-metadata-search.png b/public/videos/posters/docs-metadata-search.png
new file mode 100644
index 0000000..7d33121
Binary files /dev/null and b/public/videos/posters/docs-metadata-search.png differ
diff --git a/public/videos/posters/docs-navigating-notes.png b/public/videos/posters/docs-navigating-notes.png
new file mode 100644
index 0000000..aca7861
Binary files /dev/null and b/public/videos/posters/docs-navigating-notes.png differ
diff --git a/public/videos/posters/docs-note-editor.png b/public/videos/posters/docs-note-editor.png
new file mode 100644
index 0000000..cd84a79
Binary files /dev/null and b/public/videos/posters/docs-note-editor.png differ
diff --git a/public/videos/posters/docs-pocketbook-claude.png b/public/videos/posters/docs-pocketbook-claude.png
new file mode 100644
index 0000000..d8e9136
Binary files /dev/null and b/public/videos/posters/docs-pocketbook-claude.png differ
diff --git a/public/videos/posters/docs-pocketbook.png b/public/videos/posters/docs-pocketbook.png
new file mode 100644
index 0000000..c744912
Binary files /dev/null and b/public/videos/posters/docs-pocketbook.png differ
diff --git a/public/videos/posters/docs-quickstart.png b/public/videos/posters/docs-quickstart.png
new file mode 100644
index 0000000..5c1f085
Binary files /dev/null and b/public/videos/posters/docs-quickstart.png differ
diff --git a/public/videos/posters/docs-schema-system.png b/public/videos/posters/docs-schema-system.png
new file mode 100644
index 0000000..a63dad3
Binary files /dev/null and b/public/videos/posters/docs-schema-system.png differ
diff --git a/public/videos/posters/docs-semantic-search.png b/public/videos/posters/docs-semantic-search.png
new file mode 100644
index 0000000..cce22ef
Binary files /dev/null and b/public/videos/posters/docs-semantic-search.png differ
diff --git a/public/videos/posters/docs-themes.png b/public/videos/posters/docs-themes.png
new file mode 100644
index 0000000..8d145b5
Binary files /dev/null and b/public/videos/posters/docs-themes.png differ
diff --git a/public/videos/posters/hero.png b/public/videos/posters/hero.png
new file mode 100644
index 0000000..f8b946f
Binary files /dev/null and b/public/videos/posters/hero.png differ