Skip to content

Commit b857883

Browse files
committed
add docs for web editor
2 parents dfcd8e3 + f77151b commit b857883

File tree

5 files changed

+147
-8
lines changed

5 files changed

+147
-8
lines changed

public/web-editor.png

753 KB
Loading
68.9 KB
Loading

public/web-manage-projects.png

109 KB
Loading

src/pages/guides/cloud.mdx

Lines changed: 41 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
layout: '@/layouts/DocsLayout.astro'
33
title: 'Basic Memory Cloud'
4-
description: 'Cloud authentication, setup, and mount commands for Basic Memory Cloud'
4+
description: 'Cloud remote MCP setup and command line tools for Basic Memory Cloud'
55
icon: 'cloud'
66
---
77

@@ -27,7 +27,7 @@ Bring your knowledge to the cloud. All your existing notes, connections, and con
2727
[Basic Memory Cloud](/guides/cloud-cli) is live! Now accessible from everywhere, in the Cloud. [Sign up ->](https://basicmemory.com/beta).
2828
</Tip>
2929

30-
## Setup
30+
## Claude
3131

3232
Basic Memory Cloud uses remote mcp to connect to AI assistants. The connection URL is:
3333
```
@@ -77,15 +77,48 @@ Confirm that Basic Memory is available in the "search and tools" menu for a chat
7777

7878
All your notes will be saved to your cloud instance.
7979

80-
### ChatGPT
80+
## ChatGPT
8181

8282
<Note>
8383
ChatGPT requires a Pro or Max subscription to use remote mcp.
8484
</Note>
8585

86+
A complete setup walkthrough is shown in the following video.
87+
8688
<iframe width="560" height="315" src="https://www.youtube.com/embed/NvU0Jo38P_k?si=0VvGBAhN8uOGw-KG" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
8789

88-
## Command line Quick Start
90+
91+
## Web Note Editor
92+
93+
Basic Memory Cloud notes are viewable via a web based note editor
94+
95+
```
96+
https://app.basicmemory.com/notes
97+
```
98+
99+
You can view your projects, notes and edit them via the web editor.
100+
<Card className="m-2">
101+
<img src="/web-editor.png" alt="Claude -> Tools" height="200"/>
102+
</Card>
103+
104+
To switch or manage project, use the Project dropdown from the upper left corner.
105+
106+
<Card className="m-2">
107+
<img src="/web-manage-projects-menu.png" alt="Claude -> Tools" height="200"/>
108+
</Card>
109+
110+
111+
On the Manage Projects page you can add or delete projects, and upload and download notes.
112+
<Card className="m-2">
113+
<img src="/web-manage-projects.png" alt="Claude -> Tools" height="200"/>
114+
</Card>
115+
116+
Click the "more" button (...) to
117+
- Upload notes
118+
- Download project notes as a zip
119+
- Delete a project and its notes
120+
121+
## Command line
89122

90123
Basic Memory Cloud requires version v0.15.2 or later of the Basic Memory CLI tools. See the install and upgrade
91124
instructions on the <a href="/getting-started">Getting Started</a> page.
@@ -119,7 +152,7 @@ instructions on the <a href="/getting-started">Getting Started</a> page.
119152
</Step>
120153
</Steps>
121154

122-
## Authentication
155+
### Authentication
123156

124157
Basic Memory uses JWT-based cloud authentication with OAuth 2.1 and automatic subscription validation.
125158

@@ -337,12 +370,12 @@ Syncing project 'specs'...
337370
✓ Filesystem sync initiated for project 'specs'
338371
```
339372

340-
After sync completes, the notes are available in the [Notes Web UI](https://app.basicmemory.com) and for AI conversations.
373+
After sync completes, the notes are available in the [Notes Web Editor](https://app.basicmemory.com) and for AI conversations.
341374

342-
**Notes Web UI**
375+
**Notes Web Editor**
343376

344377
<Card>
345-
<img src="/webui-notes-upload.png" alt="Device Activation" height="200"/>
378+
<img src="/webui-notes-upload.png" alt="Notes Editor" height="200"/>
346379
</Card>
347380

348381

src/pages/latest-releases.mdx

Lines changed: 106 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,112 @@ import { Card, CardGroup, Info, Warning, Note, Tip, Accordion, AccordionItem, St
1010

1111
View the latest changes to Basic Memory on [GitHub](https://github.com/basicmachines-co/basic-memory/releases)
1212

13+
## [v0.15.2](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.15.2) — 2025-10-14
14+
15+
### Cloud Features
16+
17+
- **WebDAV upload command for cloud projects** ([#356](https://github.com/basicmachines-co/basic-memory/pull/356))
18+
- New `basic-memory cloud upload` command for uploading files to cloud projects via WebDAV
19+
- Supports uploading individual files or entire directories
20+
- Automatic project syncing after upload completes
21+
- Simplifies workflow for adding local files to cloud projects
22+
23+
**Full Changelog**: https://github.com/basicmachines-co/basic-memory/compare/v0.15.1...v0.15.2
24+
25+
---
26+
## [v0.15.1](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.15.1) — 2025-10-13
27+
28+
**Focus:** Cloud mode stability, performance optimizations, and bug fixes
29+
30+
<Info>
31+
**Highlights:**
32+
- 10-100x performance improvement for directory operations
33+
- 43% faster sync and indexing operations
34+
- Enhanced cloud mode security with path validation
35+
- Critical bug fixes for project deletion and Claude Desktop compatibility
36+
</Info>
37+
38+
### Performance Improvements
39+
40+
- **Optimize directory operations for 10-100x performance improvement** ([#350](https://github.com/basicmachines-co/basic-memory/pull/350))
41+
- Dramatically faster directory listing and traversal operations
42+
- Improved responsiveness for large knowledge bases
43+
- Optimized file system operations
44+
45+
- **Optimize sync/indexing for 43% faster performance** ([#352](https://github.com/basicmachines-co/basic-memory/pull/352))
46+
- Significantly faster file synchronization
47+
- Reduced indexing time for large projects
48+
- Enhanced overall system responsiveness
49+
50+
### Cloud Mode Enhancements
51+
52+
- **Cloud mode path validation and sanitization** ([#332](https://github.com/basicmachines-co/basic-memory/pull/332))
53+
- Enhanced security with strict path validation in cloud mode
54+
- Prevents path traversal attacks and unauthorized file access
55+
- Improved data isolation for multi-tenant environments
56+
57+
- **BASIC_MEMORY_PROJECT_ROOT for path constraints** ([#334](https://github.com/basicmachines-co/basic-memory/pull/334))
58+
- New environment variable for defining project root boundaries
59+
- Additional security layer for cloud deployments
60+
- Prevents access to files outside designated project directories
61+
62+
- **Normalize paths to lowercase in cloud mode** ([#336](https://github.com/basicmachines-co/basic-memory/pull/336))
63+
- Prevents case-sensitivity collisions in cloud storage
64+
- Ensures consistent file handling across platforms
65+
- Improves cross-platform compatibility
66+
67+
- **Configuration persistence via Tigris (SPEC-15)** ([#343](https://github.com/basicmachines-co/basic-memory/pull/343))
68+
- Cloud configuration storage implementation
69+
- Persistent settings across sessions
70+
- Foundation for enhanced cloud features
71+
72+
- **Async client context manager pattern** ([#344](https://github.com/basicmachines-co/basic-memory/pull/344))
73+
- Improved cloud client architecture
74+
- Better resource management and connection handling
75+
- Enhanced reliability for cloud operations
76+
77+
### Bug Fixes
78+
79+
- **Prevent nested project paths** ([#338](https://github.com/basicmachines-co/basic-memory/pull/338))
80+
- Prevents data conflicts from nested project configurations
81+
- Improved project isolation and data integrity
82+
- Clear error messages for invalid project structures
83+
84+
- **Project deletion with permalink normalization** ([#345](https://github.com/basicmachines-co/basic-memory/pull/345))
85+
- Fixed project deletion failures caused by permalink handling
86+
- Consistent permalink normalization across operations
87+
- Improved project management reliability
88+
89+
- **Add permalink normalization to project lookups** ([#348](https://github.com/basicmachines-co/basic-memory/pull/348))
90+
- Ensures consistent project lookups across all operations
91+
- Fixes edge cases with project switching
92+
- Enhanced project management stability
93+
94+
- **Correct ProjectItem.home property** ([#341](https://github.com/basicmachines-co/basic-memory/pull/341))
95+
- Fixed property to return path instead of name
96+
- Corrects API contract for project information
97+
- Improved integration reliability
98+
99+
- **Update view_note and ChatGPT tools for Claude Desktop compatibility** ([#355](https://github.com/basicmachines-co/basic-memory/pull/355))
100+
- Fixed Claude Desktop integration issues
101+
- Enhanced MCP tool compatibility
102+
- Improved cross-platform tool support
103+
104+
### Documentation
105+
106+
- **v0.15.0 assistant guide** ([#335](https://github.com/basicmachines-co/basic-memory/pull/335))
107+
- Comprehensive guide for AI assistants working with Basic Memory
108+
- Enhanced integration documentation
109+
- Improved developer experience
110+
111+
- **Tool documentation for write_note** ([#339](https://github.com/basicmachines-co/basic-memory/pull/339))
112+
- Clarified usage of empty string or "/" for root folder
113+
- Improved API documentation
114+
- Better tool usage examples
115+
116+
**Full Changelog**: https://github.com/basicmachines-co/basic-memory/compare/v0.15.0...v0.15.1
117+
118+
---
13119
## [v0.15.0](https://github.com/basicmachines-co/basic-memory/releases/tag/v0.15.0) — 2024-10-04
14120

15121
**Major Release:** Cloud features, performance improvements, and enhanced project workflow

0 commit comments

Comments
 (0)