A Community Plugin for Obsidian.md to manage your vault with Git.
Requirements, installation steps (including setup for mobile), tips and tricks, common issues and more can be found in the documentation.
For mobile users see Mobile section below.
Open Source Control View
command.git log
) via the History View. Open it with the Open History View
command.This view allows you to stage, unstage individual files and commit them. It also shows the status of each file in your vault.
This view shows the commit history of your repository. You can see the commit message, author, date, and changed files. Author and date can are disabled by default as shown in the screenshot, but can be enabled in the settings.
You can open the diff view from the source control view or via an extra command.
List changed files
: Lists all changes in a modalOpen diff view
: Open diff view for the current fileStage current file
Unstage current file
Commit all changes
: Only commits all changes without pushingCommit all changes with specific message
: Same as above, but with a custom messageCommit staged
: Commits only files that have been stagedCommit staged with specific message
: Same as above, but with a custom messageCommit-and-sync
: With default settings, this will commit all changes, pull, and pushCommit-and-sync with specific message
: Same as above, but with a custom messageCommit-and-sync and close
: Same as Commit-and-sync
, but if running on desktop, will close the Obsidian window. Will not exit Obsidian app on mobile.Push
Pull
Edit remotes
Remove remote
Clone an existing remote repo
: Opens dialog that will prompt for URL and authentication to clone a remote repoOpen file on GitHub
: Open the file view of the current file on GitHub in a browser window. Note: only works on desktopOpen file history on GitHub
: Open the file history of the current file on GitHub in a browser window. Note: only works on desktopInitialize a new repo
Create new branch
Delete branch
CAUTION: Delete repository
Open source control view
: Opens side pane displaying Source control view
Edit .gitignore
Add file to .gitignore
: Add current file to .gitignoreAuthentication may require additional setup. See more in the Authentication documentation
Please use AppImage instead (Linux installation guide)
The git implementation on mobile is very unstable!
The mobile version is supported by isomorphic-git, which is a re-implementation of Git in JavaScript, because you cannot use native Git on Android or iOS.
[!caution] Depending on your device and available free RAM, Obsidian may
- crash on clone/pull
- create buffer overflow errors
- run indefinitely.
It's caused by the underlying git implementation on mobile, which is not efficient. I don't know how to fix this. If that's the case for you, I have to admit this plugin won't work for you. So commenting on any issue or creating a new one won't help. I am sorry.
Setup: iPad Pro M1 with a repo of 3000 files reduced from 10000 markdown files
The initial clone took 0m25s. After that, the most time consuming part is to check the whole working directory for file changes. On this setup, checking all files for changes to stage takes 03m40s. Other commands like pull, push and commit are very fast (1-5 seconds).
The fastest way to work on mobile if you have a large repo/vault is to stage individual files and only commit staged files.
The Line Authoring feature was developed by GollyTicker, so any questions may be best answered by him.
If you have any kind of feedback or questions, feel free to reach out via GitHub issues or vinzent3
on Obsidian Discord server.
This plugin was initial developed by denolehov. Since March 2021, it's me Vinzent03 who is developing this plugin. That's why the GitHub repository got moved to my account in July 2024.
If you find this plugin useful and would like to support its development, you can support me on Ko-fi.