README file from
GithubEasy Push
Review changes and push them without the terminal.
Easy Push shows the files that changed, lets you choose what to push, creates a commit, and sends it to your Git remote.
It is intentionally small:
- review changed files
- push the current file, selected files, or all changes
- edit the commit message before pushing
- choose the branch to push to
- push pending local commits
- see file status markers in the file explorer
- set up a remote from inside Obsidian
No accounts, sync service, telemetry, backend, or GitHub-specific API. It only runs local git commands in your vault.
Set up the git remote:

Just provide git clone link:

Review status on the right and left sidebars:

Setup
Create an empty repository on GitHub, GitLab, Bitbucket, Gitea, Forgejo, or any normal Git host.
In Obsidian, run:
Easy Push: Set up Easy Push
Paste the remote URL, then push from the ribbon icon, sidebar view, command palette, or file context menu.
If your vault is already a Git repository, Easy Push uses it. If not, it initializes one for you.
Status Colors
In the file explorer:
- green means the file is already pushed
- red means the file has local changes or belongs to an unpushed commit
Markers are shown on files by default. A setting can add matching left-side markers to folders that contain files ready to push.
Easy Push hides common local files such as .obsidian/, .trash/, .DS_Store, .git/, .vscode/, and ignored files.
Notes
Easy Push is desktop-only. Obsidian mobile does not expose the local shell environment needed to run Git.
The plugin works with any Git remote that your local git command can push to.
When pushing to a non-default branch that already exists locally, Easy Push warns before continuing and recommends a fresh branch name. It does not fetch, merge, delete branches, or resolve conflicts for you.
Manual Installation
Copy these files into:
VaultFolder/.obsidian/plugins/easy-push/
Files:
main.js
manifest.json
styles.css
Then enable Easy Push in Obsidian’s Community Plugins settings.
Development
npm install
npm run build
For watch mode:
npm run dev
Community plugin releases should attach main.js, manifest.json, and styles.css.
Support
If Easy Push saves you time, you can support development through GitHub Sponsors or Buy Me a Coffee.