Sync a folder
Keep a brain as files on your computer, and edit them in any app.
With the desktop app, you can keep a brain as a folder of files on your computer. Edit them in any app, and changes sync both ways while the app's background process runs, even with the brain's window closed.
Turn it on
- Open the brain in the desktop app.
- Open Settings, then This brain > Folder sync.
- Turn on Folder sync.
- Choose Use this folder, or Choose another folder to pick where the files go.
What syncs
Pages and attachments sync. Files your folder's .gitignore excludes don't. A local file over 20 MiB isn't uploaded, and the app tells you it's too large.
Big changes wait for you
When many files change at once, such as 10 or more, or several deletions, the app holds them and shows Changes are waiting for review. Click Review changes to check them before they upload.
Conflicts
If a file changed both on your computer and in the cloud, the app shows both and asks you to choose: Keep this computer's version, Use the cloud version, or Keep both as separate files.
Turn it off
In This brain > Folder sync, click Turn off folder sync. The folder keeps its files; they just stop syncing.
You can also check and control folder sync from a terminal with open-knowledge-cloud folder-sync. See The CLI.