Local folder sync

Mirror your vault to a folder on your computer's disk — Obsidian-style. Edit notes in any text editor, push to a local backup folder, or manage everything as a git repo from inside noteser.

Chromium-only — Chrome, Edge, Brave, Arc, or Opera. Firefox + Safari don't ship the File System Access API yet.

Connect a folder

1. Open Settings → Local folder.
2. Click Connect a folder….
3. Pick a directory in the browser picker. Grant read/write permission.

After connecting, the folder name appears in Settings. The folder handle is remembered across sessions, but the browser re-prompts for permission once per session (security model).

Sync directions

• Push vault to folder — writes every active note as a .md file at its repo path (or sanitised <title>.md at the root for unpushed notes).
• Sync from folder… — opens a preview modal showing new / updated / unchanged counts, then on confirm overwrites local notes with what's in the folder.

There's no auto-mirror on save in v1 — you click the buttons explicitly. (The browser has no real-time filesystem watch yet.)

In-folder git

If the folder is or should be a git repo, the In-folder git subsection lets you drive the whole git lifecycle from inside noteser:

1. Initialise git repo — runs git init on the folder.
2. Set remote — paste a GitHub URL like https://github.com/owner/repo.git.
3. Commit — stages all .md + .noteser/*.json files, commits with your GitHub identity.
4. Push to origin — pushes via a CORS-friendly proxy on noteser's own infra.

You'll need a connected GitHub token (Settings → GitHub sync) for push to work.

Trade-offs vs GitHub Sync

Use GitHub sync if you mostly write inside noteser. Use local-folder + in-folder git if you want to edit in another editor or want full git history offline.