Skip to content

sync

Jump to bottom
aniongithub edited this page May 19, 2026 · 1 revision

title: Sync to a git remote type: guide

Sync to a git remote

mind-map can sync a path prefix in your wiki to a git repository so your notes are versioned and backed up.

Setup via the web UI

Open Settings → Sync. Add a mapping:

Prefix Remote
projects/mind-map git@github.com:you/mind-map-wiki.git

Save. The wiki under projects/mind-map is now committed to that repo on each save and pulled on each architecture/wiki-engine.

Setup via MCP

An agents/index can also register sync with agents/mcp-tools:

register_sync(prefix="projects/foo", remote="git@github.com:you/foo-wiki.git")

How it works

sequenceDiagram
    participant U as User / agent
    participant E as Engine
    participant G as git
    participant R as Remote
    U->>E: update_page
    E->>E: write file
    E->>G: commit
    G->>R: push (background)
    loop on reindex
        G->>R: pull
        R->>G: changes
        G->>E: trigger Reindex
    end
Loading

Credentials

Sync uses the machine's existing git credentials. No tokens stored in mind-map. If git push works for you on the CLI, sync will work.

See also

Clone this wiki locally