GitHub Repo Tools

An Obsidian plugin that puts a GitHub repository panel in your sidebar — monitor staleness, manage branches, stage and commit files, and track pull requests without leaving Obsidian.

Desktop only. Requires git to be installed and a local clone of the repository you want to monitor.

Features

Local repo status

• Shows your current branch and a dropdown to switch branches
• Detects uncommitted changes with an expandable file list
• Shows how many commits you are behind the remote with a one-click Pull button
• Ribbon icon badge turns red when your local repo is behind

Changed-file navigation & highlighting

• Click any file in the uncommitted-changes list to open it directly in Obsidian
• The lines that actually changed are highlighted in the editor for a few seconds so you can spot the diff at a glance
• The same highlight also triggers automatically whenever you open a changed file any other way — from the file explorer, a link, or the quick switcher
• A small dot marks modified files in Obsidian's file explorer, plus every parent folder on the path down to them, so changes are visible even in collapsed folders

Conflicts and merges

• If a merge or cherry-pick leaves conflicts, the sidebar shows a banner listing the conflicting files
• Resolve each file with one click (keep mine / keep theirs), or abort the merge/cherry-pick entirely

Stash management

• View all stashes for the repo, with a summary of what each one contains
• Apply or drop any stash directly from the sidebar

Branch switching

• Switching or pulling tries the operation directly first, and only auto-stashes your local changes if they'd actually block it
• Safer handling means a switch won't silently fail after a pull

Git operations

Fetch, Pull, Push, and Create Branch from the action bar. All operations run against the local clone you configure.

Commit modal

Stage individual files by checkbox, write a commit message, and commit (or commit + push) in one step.

PR dashboard

• My PRs — open PRs you authored
• Awaiting My Review — PRs where you are a requested reviewer
• All Open PRs — collapsible list of everyone else's PRs
• New activity badge on PRs that have been updated since you last opened them
• One-click to open any PR in the browser

Create PR workflow

Smart PR creation from the sidebar:

1. If you have uncommitted changes, prompts you to commit first
2. Pushes the branch if it hasn't been pushed yet
3. Opens a modal pre-filled with a title derived from your branch name

Status bar

Compact summary in the Obsidian status bar: sync status, uncommitted file count, open PR counts, and review request count.

Setup

1. Install the plugin and enable it.
2. Open Settings → GitHub Repo Tools.
3. Set Local repo path — the absolute path to your local git clone (or use the Browse button).
4. Set your GitHub personal access token — a classic PAT with repo scope is sufficient. The plugin will auto-detect the repo owner/name and your GitHub username from the token and remote URL.

Settings

Requirements

• Obsidian 0.15.0 or later
• macOS, Windows, or Linux desktop (not mobile)
• git installed and available on the system PATH
• A GitHub personal access token with repo scope

License

MIT