Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/0.welcome.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ 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.22:** team-safe cloud push and pull, search improvements, and MCP reliability fixes. See the [Changelog](/whats-new/changelog).
**New in Basic Memory Cloud:** review notes change by change with [Comments and Suggestions](/whats-new/comments-and-suggestions), and browse, edit, or graph your knowledge directly inside ChatGPT and Claude with the [Interactive MCP App](/whats-new/interactive-mcp-app).
::

## Pick your path
Expand Down
2 changes: 2 additions & 0 deletions content/01.start-here/2.quickstart-cloud.md
Original file line number Diff line number Diff line change
Expand Up @@ -121,6 +121,8 @@ 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).

**What you can do in the web app:**
- Browse all your notes in the folder tree
- Edit notes with the live Markdown editor
Expand Down
59 changes: 59 additions & 0 deletions content/02.whats-new/0.comments-and-suggestions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
title: Comments and Suggestions
description: Leave feedback and propose changes without overwriting a Basic Memory note.
---

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"}
::

## Review without rewriting

Select text in the rich editor to start a review:

- **Add comment** starts an attributed discussion without changing the passage.
- **Suggest insertion** proposes new text after the selection.
- **Suggest deletion** marks the selection for removal.
- **Suggest replacement** keeps the original and proposed wording visible together.

Each suggestion can be accepted or rejected individually. Comments can collect replies and be resolved without changing the note text.

## Follow every open item

The note toolbar shows the number of unresolved comments and suggestions. Open it to see the review rail, where each thread stays aligned with its highlighted passage and shows its author, timestamp, replies, and available actions.

::theme-image{light="/screenshots/cloud-app/critic-review-rail-light.png" dark="/screenshots/cloud-app/critic-review-rail-dark.png" alt="The review rail with a suggestion and comment beside their highlighted passages"}
::

## 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.

Try asking:

```text
Review this note with comments and suggestions. Keep the original prose in place so I can accept each change individually.
```

## Learn more

:::card-group
::card
---
title: Comments and Suggestions Guide
icon: i-lucide-message-square-text
to: /cloud/comments-and-suggestions
---
Add comments, propose each kind of edit, and work through unresolved review items.
::

::card
---
title: Interactive MCP App
icon: i-lucide-panels-top-left
to: /cloud/mcp-app
---
Review and edit notes without leaving a supported AI conversation.
::
:::
74 changes: 74 additions & 0 deletions content/02.whats-new/1.interactive-mcp-app.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
---
title: 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.

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"}
::

## Your knowledge base inside the conversation

The app provides three connected views:

| View | What you can do |
|---|---|
| **Notes** | Browse workspaces, projects, and folders; open notes; edit content; and toggle tasks |
| **Search** | Search the current project or every project you can access and open a result in place |
| **Graph** | Explore notes and relations, inspect connected notes, and move from the graph into the reader |

The note reader renders Basic Memory Markdown, including wiki links, tables, code, Mermaid diagrams, observations, relations, and frontmatter. The embedded editor also supports comments and suggested changes.

## Give the assistant the right context

Choose **Use this folder** to set the workspace, project, and directory where the assistant should write new notes for the conversation. Click a note title to prepare a prompt that identifies the note by workspace, project, and permalink; add your question or instructions, then send it.

::theme-image{light="/screenshots/mcp-app/mcp-app-note-prompt-light.png" dark="/screenshots/mcp-app/mcp-app-note-prompt-dark.png" alt="A conversation prompt prepared with a Basic Memory note as context"}
::

## Open it naturally

There is no separate app server or installation. Connect the hosted Cloud endpoint at `https://cloud.basicmemory.com/mcp`, then ask:

```text
Open Basic Memory.
Show my project notes.
Open Basic Memory search for authentication.
Show the knowledge graph around my architecture note.
```

Clients without interactive MCP App support can still use the normal Basic Memory data tools.

## Learn more

:::card-group
::card
---
title: Interactive MCP App Guide
icon: i-lucide-panels-top-left
to: /cloud/mcp-app
---
See every view, writing-location controls, note prompts, editing, and review actions.
::

::card
---
title: Comments and Suggestions
icon: i-lucide-message-square-text
to: /cloud/comments-and-suggestions
---
Review passages and accept proposed changes individually.
::

::card
---
title: ChatGPT
icon: i-lucide-message-square
to: /integrations/chatgpt
---
Connect Basic Memory Cloud to ChatGPT.
::
:::
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,19 @@ Notable changes in each Basic Memory release, most recent first. For complete pa

---

## August 2026 — Cloud review and interactive MCP Apps

*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.

These are Basic Memory Cloud product updates. The versioned Core release notes continue under [All releases](#all-releases).

---

## v0.22 — Team-safe cloud push and pull

*June 2026 · [v0.22.0](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.22.0) · [v0.22.1](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.22.1)*
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,18 @@ description: Cloud UI updates and new features.

Work with your knowledge base across multiple devices using cloud sync and storage.

## An interactive Basic Memory app in MCP conversations

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).

## Comments and suggested edits

The Cloud editor now renders portable CriticMarkup as an actionable review workflow. Select text to add an attributed comment or propose an insertion, deletion, or replacement. The review rail keeps open items beside the document, with replies and resolve, accept, or reject actions.

Connected agents can leave the same review markup, giving you a change-by-change approval flow instead of an immediate rewrite. See [Comments and Suggestions](/cloud/comments-and-suggestions).

## A redesigned web app

The Basic Memory web app has been rebuilt around a fast, three-pane layout (sidebar, note list, note detail) where notes open ready to edit.
Expand Down
3 changes: 3 additions & 0 deletions content/03.cloud/01.cloud-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,7 @@ Browse, edit, and collaborate on your cloud notes directly in your browser at [a

**Key features:**
- **Edit notes** - A rich editor, plain Markdown source mode, and a read-only preview with clickable wiki links
- **[Review changes](/cloud/comments-and-suggestions)** - Attributed comments and insertion, deletion, or replacement suggestions using portable CriticMarkup
- **Collaborate with AI** - Connect an agent and watch it write alongside you in the same note
- **Import data** - Bring in project ZIPs, Claude or ChatGPT exports, or memory-json from **Settings → Import**
- **Manage projects** - Create, switch between, and manage projects
Expand All @@ -60,6 +61,8 @@ 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).

---

## Command Line Tools
Expand Down
19 changes: 18 additions & 1 deletion content/03.cloud/03.note-editor.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Note Editor
description: Editing modes, markdown formatting, frontmatter, drafts, note management, and keyboard shortcuts in the web app.
description: Editing modes, Markdown formatting, drafts, note management, and keyboard shortcuts in the web app.
---

Notes in the [web app](/cloud/web-app) open ready to edit, and everything you write is saved as plain Markdown.
Expand Down Expand Up @@ -50,6 +50,14 @@ Open the **Frontmatter** panel from the toolbar (or the command palette) to edit

---

## Review notes without overwriting them

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.

---

## Drafts

Start typing in an empty editor — or press **Cmd/Ctrl + N** for a new note — to create a **draft**.
Expand Down Expand Up @@ -169,6 +177,15 @@ to: /cloud/ai-collaboration
Connect an agent and watch it write alongside you.
::

::card
---
title: Comments and Suggestions
icon: i-lucide-message-square-text
to: /cloud/comments-and-suggestions
---
Review notes with comments and proposed edits.
::

::card
---
title: File History
Expand Down
2 changes: 2 additions & 0 deletions content/03.cloud/04.ai-collaboration.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@ Click **Connect Agent** in the editor to start or resume an agent session for th

Select text in the editor and it appears in the agent pane, where you can send a request about it — a rewrite, a summary, or a next step. The agent's changes stream into the note as it works.

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).

## 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.
Expand Down
Loading
Loading