feat: Cloud CLI cloud sync via rclone bisync #322

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

phernandez merged 30 commits into main from rclone-bisync

Oct 3, 2025

docs/cloud-cli.md

Large diffs are not rendered by default.

specs/SPEC-8 TigrisFS Integration.md

Large diffs are not rendered by default.

specs/SPEC-9 Multi-Project Bidirectional Sync Architecture.md

Large diffs are not rendered by default.

src/basic_memory/api/app.py

-Original file line number
+Diff line change
@@ Expand Up / @@ -19,7 +19,6 @@ @@
         resource,
         search,
         prompt_router,
-        webdav,
     )
     from basic_memory.config import ConfigManager
     from basic_memory.services.initialization import initialize_file_sync, initialize_app
@@ Expand Down Expand Up / @@ -77,7 +76,6 @@ async def lifespan(app: FastAPI): # pragma: no cover @@
     app.include_router(directory_router.router, prefix="/{project}")
     app.include_router(prompt_router.router, prefix="/{project}")
     app.include_router(importer_router.router, prefix="/{project}")
-    app.include_router(webdav.router, prefix="/{project}")
     # Project resource router works accross projects
     app.include_router(project.project_resource_router)
@@ Expand Down @@

src/basic_memory/api/routers/__init__.py

-Original file line number
+Diff line change
@@ Expand Up / @@ -7,6 +7,5 @@ @@
     from . import resource_router as resource
     from . import search_router as search
     from . import prompt_router as prompt
-    from . import webdav_router as webdav
-    __all__ = ["knowledge", "management", "memory", "project", "resource", "search", "prompt", "webdav"]
+    __all__ = ["knowledge", "management", "memory", "project", "resource", "search", "prompt"]

src/basic_memory/api/routers/project_router.py

-Original file line number
+Diff line change
@@ -1,11 +1,17 @@
     """Router for project management."""
     import os
-    from fastapi import APIRouter, HTTPException, Path, Body
+    from fastapi import APIRouter, HTTPException, Path, Body, BackgroundTasks
     from typing import Optional
+    from loguru import logger
-    from basic_memory.deps import ProjectServiceDep, ProjectPathDep
-    from basic_memory.schemas import ProjectInfoResponse
+    from basic_memory.deps import (
+        ProjectConfigDep,
+        ProjectServiceDep,
+        ProjectPathDep,
+        SyncServiceDep,
+    )
+    from basic_memory.schemas import ProjectInfoResponse, SyncReportResponse
     from basic_memory.schemas.project_info import (
         ProjectList,
         ProjectItem,
@@ Expand Down Expand Up / @@ -97,6 +103,54 @@ async def update_project( @@
             raise HTTPException(status_code=400, detail=str(e))
+    # Sync project filesystem
+    @project_router.post("/sync")
+    async def sync_project(
+        background_tasks: BackgroundTasks,
+        sync_service: SyncServiceDep,
+        project_config: ProjectConfigDep,
+    ):
+        """Force project filesystem sync to database.
+        Scans the project directory and updates the database with any new or modified files.
+        Args:
+            background_tasks: FastAPI background tasks
+            sync_service: Sync service for this project
+            project_config: Project configuration
+        Returns:
+            Response confirming sync was initiated
+        """
+        background_tasks.add_task(sync_service.sync, project_config.home, project_config.name)
+        logger.info(f"Filesystem sync initiated for project: {project_config.name}")
+        return {
+            "status": "sync_started",
+            "message": f"Filesystem sync initiated for project '{project_config.name}'",
+        }
+    @project_router.post("/status", response_model=SyncReportResponse)
+    async def project_sync_status(
+        sync_service: SyncServiceDep,
+        project_config: ProjectConfigDep,
+    ) -> SyncReportResponse:
+        """Scan directory for changes compared to database state.
+        Args:
+            sync_service: Sync service for this project
+            project_config: Project configuration
+        Returns:
+            Scan report with details on files that need syncing
+        """
+        logger.info(f"Scanning filesystem for project: {project_config.name}")
+        sync_report = await sync_service.scan(project_config.home)
+        return SyncReportResponse.from_sync_report(sync_report)
     # List all available projects
     @project_resource_router.get("/projects", response_model=ProjectList)
     async def list_projects(
@@ Expand Down Expand Up / @@ -259,7 +313,7 @@ async def get_default_project( @@
     # Synchronize projects between config and database
-    @project_resource_router.post("/sync", response_model=ProjectStatusResponse)
+    @project_resource_router.post("/config/sync", response_model=ProjectStatusResponse)
     async def synchronize_projects(
         project_service: ProjectServiceDep,
     ) -> ProjectStatusResponse:
@@ Expand Down @@

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: Cloud CLI cloud sync via rclone bisync #322

Uh oh!

Diff view

Diff view

There are no files selected for viewing

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!