Obsidian Plugin · v1.0.0

Your vault.
Backed by GitHub.

Push and pull your entire Obsidian vault to a GitHub repository — no Git installation, no Node.js, no terminal required. Works seamlessly on desktop and mobile.

Start from scratch Quick setup

Desktop Mobile No Git required MIT License

How it works

One plugin. Two directions.

Direct GitHub Sync communicates directly with the GitHub API, treating your vault as source of truth.

Your Obsidian Vault

All your notes, attachments, and settings — exactly where they are.

Plugin processes your files

Reads vault contents, handles encoding, normalises paths, and resolves conflicts. Ignored paths and the .obsidian directory can be excluded.

Direct GitHub API call

No middleman, no local Git daemon. The plugin communicates with the GitHub REST API using your Personal Access Token, with automatic retry and rate-limit handling.

GitHub Repository

Your vault lives as a standard repository. Version history, branch control, and access anywhere — all through GitHub's interface.

Capabilities

What it handles

Mobile & Desktop

Works on iOS, Android, Windows, macOS, and Linux. No native dependencies.

Retry & Rate Limit Handling

Automatic retries with exponential backoff when GitHub's API rate-limits your requests.

Ignore Paths

Exclude the .obsidian folder, specific files, or custom patterns from syncing.

Concurrency Control

Configurable concurrent uploads prevent overwhelming the API while keeping syncs fast.

Case-Conflict Detection

Flags files that differ only in capitalisation, which can cause silent data loss on case-insensitive filesystems.

Sync Cache

Tracks the last known remote commit to allow incremental, efficient pull operations.

Ready to get started?

New to GitHub? No problem — the beginners guide covers everything from creating an account to your first sync.

Complete setup guide I know what I'm doing

Your vault. Backed by GitHub.