A note from Sen

I built Direct GitHub Sync because I wanted a simple, reliable way to keep my Obsidian vault backed up without wrestling with Git on mobile. Every existing solution either required running a local server, installing separate software, or was too fragile on iOS.

This plugin talks directly to the GitHub API — no middleman, no setup beyond a token. It works the same on your phone as it does on your laptop. That simplicity was the whole point.

If it has been useful to you, I appreciate any form of support — whether that is reporting a bug, contributing to the code, or simply sharing it with someone who might find it helpful.

— Sen  github.com/xensenx


Contribute

The plugin is open source and welcomes contributions. Whether you are fixing a bug, improving documentation, or proposing a new feature — all of it helps.

Report an issue

Found a bug or unexpected behaviour? Open an issue on GitHub with details about what you were doing and what happened.

Submit a pull request

Fork the repository, make your changes, and submit a PR. For significant changes, consider opening an issue first to discuss the direction.

Share the plugin

Word of mouth goes a long way. If Direct GitHub Sync has been useful to you, mentioning it in Obsidian communities helps others find it.

Improve documentation

Spotted something unclear or missing in the guides? Documentation improvements are just as valuable as code contributions.


Buy Sen a coffee

Direct GitHub Sync is free and will remain free. If it has saved you time or given you peace of mind about your notes, supporting the project financially helps sustain development.

Support on Ko-fi

One-time or monthly — whatever feels right

Support on Ko-fi

Ko-fi handles all payments. No account required for one-time support.


About the project

Curious about the origin and direction of Direct GitHub Sync? The project wiki covers the background, design decisions, and roadmap in more detail.

Read the Wiki

This plugin has been tested across multiple devices and typical workflows. As with any sync system, edge cases may occur in complex or unusual scenarios. It is recommended to keep backups of your vault. If you encounter any issues, please open an issue on GitHub with details.


What's coming

Two significant features are actively being worked on. These are non-trivial to build correctly, so no timeline is attached — but they are core to where the plugin is heading.

In Development

Smart Sync

Dynamically syncs files after a short idle period. Coordinates vault state across devices via GitHub, with conflict detection and resolution built in — so switching devices becomes seamless rather than manual.

In Development

Time Traverse

Travel through the full history of your Obsidian vault. Browse past states, compare versions, and restore your vault — or individual notes — to any previous point in time.

Want to see these sooner?

Supporting the developer directly helps make dedicated time for these features possible.

Support