Skip to content

Commit 1c67003

Browse files
committed
docs: qualify MCP cloud deletion routing
Signed-off-by: phernandez <paul@basicmachines.co>
1 parent f45c47c commit 1c67003

1 file changed

Lines changed: 6 additions & 3 deletions

File tree

content/03.cloud/01.cloud-guide.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -123,9 +123,12 @@ bm project remove research --cloud --delete-notes
123123
Keep the explicit `--cloud` flag on the destructive `--delete-notes` command so the CLI also removes any configured local sync directory. Omitting `--cloud` from a cloud-routed project still purges hosted storage, but leaves the local sync copy intact. Hosted deletion is asynchronous: the project is hidden from cloud workspace operations when deletion is accepted, then a background job removes its database rows. A local routing or sync configuration entry can still appear as a config-only row in the combined `bm project list`; that does not mean the hosted project remains. With `--delete-notes`, the background job also removes indexed and unindexed objects under the project's exact storage prefix.
124124

125125
The MCP `delete_project` tool provides the same hosted-storage purge with
126-
`delete_notes=true`. It does not remove a configured local sync directory; use the explicit
127-
CLI command above when you need to delete both copies. The MCP response reports the pending
128-
deletion status and background job ID.
126+
`delete_notes=true` when the MCP session is hosted or explicitly cloud-routed. From a local
127+
stdio MCP session, also pass `workspace` to route the request to that cloud workspace;
128+
`delete_notes=true` alone does not switch a local request to Cloud. MCP deletion does not
129+
remove a configured local sync directory, so use the explicit CLI command above when you need
130+
to delete both copies. The MCP response reports the pending deletion status and background
131+
job ID.
129132

130133
---
131134

0 commit comments

Comments
 (0)