Skip to content

Installation

BHARATH CHANDRA VADDARAM edited this page Sep 7, 2026 · 1 revision

Installation

Download a pre-built installer from the latest release.

Platform Format Architecture Notes
macOS .dmg Universal (Apple Silicon & Intel) Unsigned. Clear quarantine after install (below).
Linux .AppImage, .deb x86_64 Built on Ubuntu 22.04 (glibc 2.35+)
Windows .msi, .exe x64 Windows 10 / 11

Current packaged version is 0.0.7 (package.json / release manifests). Prefer the GitHub Releases page over a cached copy.

macOS Gatekeeper

macOS quarantines unsigned downloads. After dragging GitPulse to /Applications:

xattr -dr com.apple.quarantine /Applications/GitPulse.app

Then open the app from Finder or Spotlight.

Updates

GitPulse does not auto-update and does not check for updates unless you ask it to.

Settings → Updates:

  • Off by default. With the toggle off, GitPulse makes no network request about itself.
  • When enabled, it compares public release tags at most once a day via git ls-remote. No account, no token, and nothing about your repositories is sent.
  • Check now runs a single check on demand.
  • It never downloads or installs binaries. The notification links to the release page.

A check that cannot complete says so. "Could not check" is never reported as "up to date".

Runtime dependencies

GitPulse shells out to tools you already have:

Tool Required? Used for
git Yes Every repository operation
gh Optional PRs, issues, workflow runs, Dependabot alerts
Local LLM (Ollama, LM Studio, llama.cpp, vLLM) Optional Commit messages, explanations, health/coverage suggestions
manvi sidecar Optional Policy gate; absent → verdicts are unchecked, never silently allowed

Build from source

If you want a development build, see Development. Short version:

git clone https://github.com/bharathvbcr/GitPulse.git
cd GitPulse
npm install
git config core.hooksPath .githooks
npm run tauri dev

Prerequisites: Node.js 22+, stable Rust, platform native toolchains (Xcode CLT / MSVC + WebView2 / WebKitGTK).

Clone this wiki locally