update docs wip

Author: phernandez

src/config/navigation.ts

@@ -44,6 +44,7 @@ export const navConfig = {
         { title: 'MCP Tools Reference', href: '/guides/mcp-tools-reference' },
         { title: 'Canvas', href: '/guides/canvas' },
         { title: 'CLI Reference', href: '/guides/cli-reference' },
+        { title: 'Cloud CLI', href: '/guides/cloud-cli' },
         { title: 'AI Assistant Guide', href: '/guides/ai-assistant-guide' },
       ],
     },

src/pages/getting-started.mdx

@@ -22,13 +22,16 @@ The fastest way to get started with Basic Memory:
 
 You can install Basic Memory using `uv`, an extremely fast Python package and project manager, written in Rust.
 
+**Requirements**: Python 3.13 or higher
+
 You can install `uv` from [astral's website ↗️](https://docs.astral.sh/uv/getting-started/installation/). After installing `uv` you can install Basic Memory with the command:
 
 ```bash
 uv tool install basic-memory
 ```
 <Warning>
 - **`uv` must be installed and available in your system PATH**. Claude Desktop runs in its own isolated environment and needs `uv` to manage dependencies.
+- **Python 3.13+ required**. Check your version with `python --version`.
 </Warning>
 
 ### Homebrew Installation (macOS)
@@ -71,15 +74,6 @@ Edit your Claude Desktop config, located at:
 
 ![tools-menu](/attachments/claude-tools-menu.png)
 
-### Install Basic Memory Pre-releases (For Daring Adventurers)
-
-```bash
-# Beta releases (new features, testing)
-pip install basic-memory --pre
-
-# Development builds (latest changes)
-pip install basic-memory --pre --force-reinstall
-```
 
 ### Choosing Where Your Notes Are Saved
 

src/pages/guides/cli-reference.mdx

@@ -8,6 +8,87 @@ import { Card, CardGroup, Info, Warning, Note, Tip, Accordion, AccordionItem, St
 
 ## Core Commands
 
+### cloud
+
+Manage cloud authentication and synchronization. Requires active subscription.
+
+```bash
+# Authenticate with cloud service
+basic-memory cloud login
+
+# Logout and clear credentials
+basic-memory cloud logout
+
+# Bidirectional sync with cloud
+basic-memory cloud sync
+
+# Verify cloud storage integrity
+basic-memory cloud check
+
+# Mount cloud storage locally
+basic-memory cloud mount
+
+# Unmount cloud storage
+basic-memory cloud unmount
+```
+
+#### Cloud Login
+
+Authenticate with cloud service using JWT tokens:
+
+```bash
+basic-memory cloud login
+```
+
+Opens browser for authentication. Stores credentials in `~/.basic-memory/cloud_auth.json`.
+
+#### Cloud Sync
+
+Synchronize local files with cloud storage using rclone bisync:
+
+```bash
+# Sync current project
+basic-memory cloud sync
+
+# Sync specific project
+basic-memory --project=work cloud sync
+```
+
+Performs bidirectional synchronization with conflict detection.
+
+#### Cloud Mount
+
+Mount cloud storage as local filesystem:
+
+```bash
+# Mount with default (balanced) profile
+basic-memory cloud mount
+
+# Mount with specific performance profile
+basic-memory cloud mount --profile fast
+basic-memory cloud mount --profile balanced
+basic-memory cloud mount --profile safe
+```
+
+Performance profiles:
+- `fast`: 5s cache, optimized for speed
+- `balanced`: 10-15s cache (default)
+- `safe`: 15s+ cache, optimized for data integrity
+
+#### Cloud Check
+
+Verify integrity of cloud storage:
+
+```bash
+basic-memory cloud check
+```
+
+Validates checksums and file consistency between local and cloud.
+
+<Warning>
+Cloud commands require an active subscription. Use `basic-memory cloud login` to authenticate.
+</Warning>
+
 ### import
 
 Imports external knowledge sources with support for project targeting: