{"id":15017048,"url":"https://github.com/vinzent03/obsidian-git","last_synced_at":"2026-10-18T22:08:01.754Z","repository":{"id":37212490,"uuid":"307756285","full_name":"Vinzent03/obsidian-git","owner":"Vinzent03","description":"Integrate Git version control with automatic commit-and-sync and other advanced features in Obsidian.md","archived":false,"fork":false,"pushed_at":"2026-10-18T21:06:11.000Z","size":5681,"stargazers_count":12133,"open_issues_count":94,"forks_count":655,"subscribers_count":41,"default_branch":"master","last_synced_at":"2026-10-18T21:43:48.350Z","etag":null,"topics":["git","obsidian","obsidian-md","obsidian-plugin"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Vinzent03.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"accessibility":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","claude":null,"gemini":null,"cursor":null,"copilot":null,"dco":null,"cla":null,"disclosure":null},"funding":{"ko_fi":"vinzent"}},"created_at":"2020-10-27T16:08:16.000Z","updated_at":"2026-10-18T21:06:18.000Z","dependencies_parsed_at":"2026-10-18T17:26:33.765Z","dependency_job_id":null,"html_url":"https://github.com/Vinzent03/obsidian-git","commit_stats":{"total_commits":726,"total_committers":46,"mean_commits":"15.782608695652174","dds":"0.43939393939393945","last_synced_commit":"d8a4ffa567bc546c623711ecc625a46fe45cbce3"},"previous_names":["vinzent03/obsidian-git","denolehov/obsidian-git"],"tags_count":162,"template":false,"template_full_name":null,"purl":"pkg:github/Vinzent03/obsidian-git","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vinzent03%2Fobsidian-git","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vinzent03%2Fobsidian-git/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vinzent03%2Fobsidian-git/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vinzent03%2Fobsidian-git/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Vinzent03","download_url":"https://codeload.github.com/Vinzent03/obsidian-git/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vinzent03%2Fobsidian-git/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":344872684,"owners_count":38342694,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-10-03T21:59:58.778Z","status":"online","status_checked_at":"2026-10-18T02:00:06.448Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["git","obsidian","obsidian-md","obsidian-plugin"],"created_at":"2024-09-24T19:49:44.309Z","updated_at":"2026-10-18T22:08:01.749Z","avatar_url":"https://github.com/Vinzent03.png","language":"TypeScript","funding_links":["https://ko-fi.com/vinzent","https://ko-fi.com/F1F195IQ5"],"categories":[],"sub_categories":[],"readme":"# Git Plugin for Obsidian\n\nA powerful community plugin for [Obsidian.md](https://obsidian.md) that brings Git integration right into your vault. Automatically commit, pull, push, and see your changes — all within Obsidian.\n\n## Documentation\n\nAll setup instructions (including mobile), common issues, tips, and advanced configuration can be found in the [full documentation](https://publish.obsidian.md/git-doc).\n\n\u003e Mobile users: The plugin is **highly unstable**. Please check the dedicated [Mobile](#mobile-support-experimental) section below.\n\n## Key Features\n\n- **Automatic commit-and-sync** (commit, pull, and push) on a schedule.\n- **Auto-pull on Obsidian startup**\n- **Source Control View** to stage/unstage, commit and diff files - Open it with the `Open source control view` command.\n- **History View** for browsing commit logs and changed files - Open it with the `Open history view` command.\n- **Diff View** for reviewing changes side by side and staging or resetting individual hunks - Open it with the `Open diff view` command.\n- **Conflict resolution in the editor** with highlighted changes and buttons to keep either version, both versions, or the common ancestor when available.\n- **Signs in the editor** to indicate added, modified, and deleted lines/hunks (desktop only).\n- **Submodule support** for managing multiple repositories (desktop only and opt-in)\n- GitHub integration to open files and history in your browser\n\n\u003e For detailed file history, consider pairing this plugin with the [Version History Diff](obsidian://show-plugin?id=obsidian-version-history-diff) plugin.\n\n## UI Previews\n\n### Source Control View\n\nManage your file changes directly inside Obsidian, including staging and unstaging individual files and committing them. The main Commit action commits staged changes when present. The actions menu provides explicit staged-only and all-changes alternatives, plus amending the previous commit on desktop.\n\n![Source Control View](images/source-view.png)\n\n### History View\n\nShow the commit history of your repository. The commit message, author, date, and changed files can be shown. Author and date are disabled by default as shown in the screenshot, but can be enabled in the settings.\n\n![History View](images/history-view.png)\n\n### Diff View\n\nCompare versions side by side with highlighted changes. Review, stage, or reset individual hunks without leaving the diff view.\nOpen it from the source control view or via the `Open diff view` command.\n\n![Diff View](images/diff-view.png)\n\n### Signs in the Editor\n\nView line-by-line changes directly in Live Preview with added, modified, and deleted line/hunk indicators. You can stage and reset changes right from the signs. There are also commands to navigate between hunks and stage/reset hunks under the cursor. Needs to be enabled in the plugin settings.\n\n![Editor signs with a hunk preview and stage/reset controls](images/signs.png)\n\n### Conflict Resolution\n\nResolve conflicting changes in Live Preview without leaving your note. Highlighted sections show your version and the incoming version, with buttons to keep ours, theirs, or both. The bar at the top lets you apply a choice to every conflict in the file. Source Control lists conflicted files and shows how many conflict blocks remain.\n\n![Conflict resolution in Live Preview, with local and incoming changes and the Source Control conflict list](images/conflict-resolution.png)\n\nWhen Git includes the common ancestor (for example, with `merge.conflictStyle=diff3`), you can also compare and keep the base version.\n\n![Conflict resolution with the common ancestor and Keep base controls](images/conflict-resolution-base.png)\n\nAfter reviewing the result, mark the file as resolved in Source Control, then commit to finish the merge. See the [conflict resolution guide](https://publish.obsidian.md/git-doc/Conflict+resolution) for the full workflow.\n\n## Available Commands\n\n\u003e Not exhaustive - these are just some of the most common commands. For a full list, see the Command Palette in Obsidian.\n\n- Changes\n  - `List changed files`: Lists all changes in a modal\n  - `Open diff view`: Open diff view for the current file\n  - `Stage current file`\n  - `Unstage current file`\n  - `Discard all changes`: Discard all changes in the repository\n- Commit\n  - `Commit`: Commits staged changes when present. If nothing is staged, either stages and commits all changes or stops, depending on the `Stage all changes when nothing is staged` setting\n  - `Commit with specific message`: Same as above, but with a custom message\n  - `Commit all changes`: Commits all changes without pushing\n  - `Commit all changes with specific message`: Same as above, but with a custom message\n- Commit-and-sync\n  - `Commit-and-sync`: With default settings, this will commit all changes, pull, and push\n  - `Commit-and-sync with specific message`: Same as above, but with a custom message\n  - `Commit-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.\n- Remote\n  - `Push`, `Pull`\n  - `Edit remotes`: Add new remotes or edit existing remotes\n  - `Remove remote`\n  - `Clone an existing remote repo`: Opens dialog that will prompt for URL and authentication to clone a remote repo\n  - `Open file on GitHub`: Open the file view of the current file on GitHub in a browser window. Note: only works on desktop\n  - `Open file history on GitHub`: Open the file history of the current file on GitHub in a browser window. Note: only works on desktop\n- Manage local repository\n  - `Initialize a new repo`\n  - `Create new branch`\n  - `Delete branch`\n  - `CAUTION: Delete repository`\n- Miscellaneous\n  - `Open source control view`: Opens side pane displaying [Source control view](#source-control-view)\n  - `Open history view`: Opens side pane displaying [History view](#history-view)\n  - `Edit .gitignore`\n  - `Add file to .gitignore`: Add current file to `.gitignore`\n\n## Desktop Notes\n\n### Community scorecard\n\nThe [Obsidian community scorecard](https://community.obsidian.md/plugins/obsidian-git#scorecard) reports automated code checks, including warnings about shell execution and direct filesystem access. On desktop, this plugin needs those capabilities to run your installed Git and work with repository metadata and Git configuration beyond Obsidian's vault API. These requirements contribute to the Review rating, so read it alongside the individual findings and in the context of native Git integration.\n\n### Authentication\n\nSome Git services may require further setup for HTTPS/SSH authentication. Refer to the [Authentication Guide](https://publish.obsidian.md/git-doc/Authentication)\n\n### Obsidian on Linux\n\n- Snap is not supported due to its sandboxing restrictions.\n- Flatpak is not recommended, because it doesn't have access to all system files. They are actively fixing many issues, but there are still issues. Especially with more advanced setups.\n- Please use AppImage or a full access installation of your system's package manager instead ([Linux installation guide](https://publish.obsidian.md/git-doc/Installation#Linux))\n\n## Mobile Support (Experimental)\n\nThe Git implementation on mobile is **very unstable**! I would not recommend using this plugin on mobile, but try other syncing services.\n\nOne such alternative is [GitSync](https://github.com/ViscousPot/GitSync), which is available on both Android and iOS. It is not associated with this plugin, but it may be a better option for mobile users. A tutorial for setting it up can be found [here](https://viscouspotenti.al/posts/gitsync-all-devices-tutorial).\n\n\u003e The Git plugin works on mobile thanks to [isomorphic-git](https://isomorphic-git.org/), a JavaScript-based re-implementation of Git - but it comes with serious limitations and issues. It is not possible for an Obsidian plugin to use a native Git installation on Android or iOS.\n\n### Mobile Feature Limitations\n\n- No **SSH authentication** ([isomorphic-git issue](https://github.com/isomorphic-git/isomorphic-git/issues/231))\n- Limited repo size, because of memory restrictions\n- No rebase merge strategy\n- No submodules support\n\n### Performance Caveats\n\n\u003e [!caution]\n\u003e Depending on your device and available free RAM, Obsidian may\n\u003e\n\u003e - crash on clone/pull\n\u003e - create buffer overflow errors\n\u003e - run indefinitely.\n\u003e\n\u003e 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.\n\n### Tips for Mobile Use:\n\nIf you have a large repo/vault I recommend staging individual files and setting automatic commit globs to Include matches with an empty list, so automatic commits use only staged files.\n\n## Contact \u0026 Credits\n\n- The Line Authoring feature was developed by [GollyTicker](https://github.com/GollyTicker), so any questions may be best answered by her.\n- This plugin was initially developed by [denolehov](https://github.com/denolehov). Since March 2021, it's me [Vinzent03](https://github.com/Vinzent03) who is developing this plugin. That's why the GitHub repository got moved to my account in July 2024.\n- If you have any kind of feedback or questions, feel free to reach out via GitHub issues.\n\n## Support\n\nIf you find this plugin useful and would like to support its development, you can support me on Ko-fi.\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/F1F195IQ5)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvinzent03%2Fobsidian-git","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvinzent03%2Fobsidian-git","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvinzent03%2Fobsidian-git/lists"}