Git Plugin for Obsidian
Obsidian plugin that adds Git version control, automatic commit-and-sync, and history/diff views to your notesVinzent03/obsidian-git
- Stars
- 12.2k
- Forks
- 667
- Licence
- MIT
- Language
- TypeScript
- Last update
- 6 days ago
- Type
- App
What it is
This is a community plugin for Obsidian, a note-taking app, that connects your vault (your folder of notes) to a Git repository. It can commit, pull, and push changes automatically on a schedule, and it provides views for staging files, browsing commit history, and comparing changes. People use it to get version history and backups for their notes without leaving Obsidian.
- Automatically commit and push your vault to a GitHub or other Git remote on a schedule
- Browse the commit history of a note and see which files changed in each commit
- Stage individual files or hunks and commit them from the Source Control view
- Resolve conflicting edits in the editor using keep-ours, keep-theirs, or keep-both buttons
- Open the current file's history or file view on GitHub in your browser (desktop only)
Great for
- Desktop Obsidian users who want version history for their notes
- People already comfortable with Git who want changes synced to a remote repository
- Users who want to review, stage, or diff note changes inside Obsidian
- Anyone resolving merge conflicts in Markdown notes directly in the editor
Not ideal for
- Mobile-only users: the README says the mobile implementation is highly unstable and recommends other sync services instead
- Users with large vaults on mobile, since the README notes memory limits and crashes on clone or pull
- Users who need SSH authentication on mobile, which the README says is not supported
- People who do not want to learn basic Git concepts, since the plugin exposes commits, branches, and remotes
How to get it
- 1
Download the app
You'll need: Obsidian desktop app · Git installed on your system (desktop)
Clone the repository
git clone https://github.com/Vinzent03/obsidian-git - 2
Run it
- Install the plugin through Obsidian's community plugins browser, or follow the setup guide in the full documentation
- Enable the plugin in Obsidian's settings
- Initialize or clone a Git repository for your vault using the plugin's commands
- Configure automatic commit-and-sync in the plugin settings
- Open the Source Control view with the command palette to see your changes
- 3
Get the most out of it
- Use the Commit-and-sync command with a custom message when you want a specific label on a commit
- Enable Signs in the editor to see added, modified, and deleted lines (desktop only)
- Use the Diff view to stage or reset individual hunks without leaving the note
- Pair with the Version History Diff plugin for more detailed file history, as the README suggests
- Edit .gitignore or add the current file to it from the command palette to exclude files from commits
Downloads
Strengths
- Brings common Git actions into Obsidian through commands, side panes, and in-editor signs
- Supports automatic commit-and-sync and auto-pull on startup, reducing manual steps
- Open source under the MIT license with a large user base (about 12,200 stars)
Trade-offs
- Mobile support is marked experimental and very unstable by the author
- On desktop it relies on your installed Git and needs shell and filesystem access, as noted in the README's scorecard section
- Setup for HTTPS or SSH authentication may require extra configuration per the authentication guide
How it compares
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| obsidian-git (this) | 12.2k | App | intermediate | 6 days ago | Desktop Obsidian users who want version history for their notes |
| claudian | 15.9k | App | intermediate | 4 days ago | Obsidian users who already use Claude Code or Codex and want that agent inside their notes |
| quartz | 13.5k | App | intermediate | 4 days ago | People who keep notes in Markdown, especially Obsidian users, who want to publish them online |
| gitui | 22.6k | App | beginner | 1 months ago | Developers who already work in a terminal and want a visual view of git changes |
| desktop | 22k | App | beginner | 6 days ago | Developers who work with GitHub and prefer a visual interface for commits and branches |
| ungit | 10.6k | App | beginner | 2 months ago | Developers who know git basics but find the command line slow for branching and reviewing history |
Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.