Skip to content

docs(guides): say a running sync never writes back a moved or deleted file #592

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.

Sign up for GitHub

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
aicayzer merged 2 commits into from
Oct 23, 2026
Merged

docs(guides): say a running sync never writes back a moved or deleted file #592

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
28de5bb
docs(guides): say a running sync never writes back a moved or deleted…
aicayzer Oct 23, 2026
4afa077
docs(guides): say a moved file is not written back, not never
aicayzer Oct 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion content/docs/guides/folder-safeguards.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ A folder deletes in both directions: a file you remove can send its item to the

| What happens | What the folder does |
| --- | --- |
| **You delete a file** | Moves its item to the bin after a five-second grace, so a save that replaces a file isn't taken for a delete. |
| **You delete a file** | Moves its item to the bin after a five-second grace, so a save that replaces a file isn't taken for a delete. A sync that is running when you delete the file doesn't write it back. |
| **You move or rename a file in the folder** | Keeps its item, even when the move lands while a sync is running, and doesn't write the file back where it was. |
| **An item is moved to the bin, purged, or leaves the states the search holds** | Removes its file at the next sync. A file you changed since Marfa wrote it stays. |
| **An item stops matching the search** | Keeps its file, and edits to the file still reach the item. [`marfa folders unmatched`](/guides/keep-folders-running#remove-files-a-folder-keeps-but-no-longer-holds) lists these files. |
| **You move a file to another folder on the same Mac** | Treats it as the same item, so the folder it left doesn't take the move for a delete. |
Expand Down
Loading