obsidian-git

# Git Plugin for Obsidian

A 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.

## Documentation

All setup instructions (including mobile), common issues, tips, and advanced configuration can be found in the [full documentation](https://publish.obsidian.md/git-doc).

> Mobile users: The plugin is **highly unstable**. Please check the dedicated [Mobile](#mobile-support-experimental) section below.

## Key Features

- **Automatic commit-and-sync** (commit, pull, and push) on a schedule.
- **Auto-pull on Obsidian startup**
- **Source Control View** to stage/unstage, commit and diff files - Open it with the `Open source control view` command.
- **History View** for browsing commit logs and changed files - Open it with the `Open history view` command.
- **Diff View** for reviewing changes side by side and staging or resetting individual hunks - Open it with the `Open diff view` command.
- **Conflict resolution in the editor** with highlighted changes and buttons to keep either version, both versions, or the common ancestor when available.
- **Signs in the editor** to indicate added, modified, and deleted lines/hunks (desktop only).
- **Submodule support** for managing multiple repositories (desktop only and opt-in)
- GitHub integration to open files and history in your browser

> For detailed file history, consider pairing this plugin with the [Version History Diff](obsidian://show-plugin?id=obsidian-version-history-diff) plugin.

## UI Previews

### Source Control View

Manage 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.

![Source Control View](images/source-view.png)

### History View

Show 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.

![History View](images/history-view.png)

### Diff View

Compare versions side by side with highlighted changes. Review, stage, or reset individual hunks without leaving the diff view.
Open it from the source control view or via the `Open diff view` command.

![Diff View](images/diff-view.png)

### Signs in the Editor

View 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.

![Editor signs with a hunk preview and stage/reset controls](images/signs.png)

### Conflict Resolution

Resolve conflicting changes in Live Preview without leav