Repository navigation
Document cloud sync/bisync commands as Personal-workspace-only local mirror workflows #851
Description
Feature / UX Request
Mark rclone-based cloud sync/bisync commands as Personal-workspace local mirror commands in CLI help and docs.
Problem
The old rclone sync/bisync commands are still useful for Personal workspace local mirror workflows, but their help text does not clearly say that they are not a general Cloud/Teams sync facility.
With Team workspaces, users may reasonably expect bm cloud sync or bm cloud bisync to work for shared workspaces, but multi-user rclone bisync is not supported there.
Proposed Documentation/Help Updates
Update command help and relevant docs to say something like:
Personal workspace local mirror only. Not supported for Team workspaces.
Team workspaces are accessed through cloud API/MCP routing.
This should appear in:
bm cloud sync-setup --helpbm cloud sync --helpbm cloud bisync --helpbm cloud check --helpbm cloud bisync-reset --help- Any docs pages that describe cloud sync/bisync
Acceptance Criteria
- Users can tell from
--helpthat rclone sync/bisync is Personal-workspace-only. - Team workspace docs point users toward cloud API/MCP routing rather than local sync setup.
- Existing Personal workspace rclone workflows remain documented.
Activity
claude commentedon May 24, 2026
Claude finished @groksrc's task in 3m 37s —— View job
Triage & Implementation
src/basic_memory/cli/commands/cloud/project_sync.py)cloud sync,cloud bisync,cloud check,cloud bisync-reset,cloud sync-setup)docs/cloud-cli.md— added notices in "Understanding the Sync Commands" and Command Reference "File Synchronization" sectionsdocumentation,enhancement275ef81)Changes Made
src/basic_memory/cli/commands/cloud/project_sync.py— All 5 rclone-based commands now include in their--helpoutput:Commands updated:
bm cloud sync,bm cloud bisync,bm cloud check,bm cloud bisync-reset,bm cloud sync-setupdocs/cloud-cli.md— Two notices added:Note: Push Blocked
The branch push failed with
remote: Permission to basicmachines-co/basic-memory.git denied to github-actions[bot]. This is a repository permission issue — the GitHub Actions workflow token doesn't have write access to push branches. A maintainer can either:275ef81manually, ordocs(cli): document personal-vs-team cloud sync semantics (#947)