Companion app for git-mastery.org. Electron-based, cross-platform client for Git-Mastery.
Linux support is still in development.
Grab the latest release from GitHub Releases.
Windows: run the .exe (portable) or the .msi installer.
macOS: install the .dmg, then clear the quarantine flag (required for unsigned builds):
xattr -rc /Applications/git-mastery.appWithout this, macOS reports that the app can't be opened.
Linux: not officially supported.
git clone https://github.com/git-mastery/git-mastery-desktop.git
cd git-mastery-desktop
npm install
npm run devnpm run dev starts the React frontend and Electron backend together.
Builds take a while. The Dock / installer / .exe icon is resources/icon.png — see packaging.md.
| Platform | Command | Output |
|---|---|---|
| Windows | npm run dist:win |
dist/git-mastery-{version}-win-x64.exe and dist/git-mastery-{version}-win-x64.msi |
| macOS | npm run dist:mac |
dist/git-mastery-{version}-mac-arm64.dmg |
| Linux | npm run dist:linux |
AppImage / dist artifacts (unsupported) |
macOS users of an unsigned build still need the xattr command above after installing.
node-pty needs native compilation. If the build fails:
- Install Visual Studio Build Tools with Desktop development with C++, including MSVC v143, the Windows 10/11 SDK, and C++ CMake tools.
- If you see
MSB8040(Spectre-mitigated libraries required), add those libraries from the Visual Studio Installer → Individual components. - Restart the terminal and retry.
Releases are manual. Details, versioning rules, and bootstrap steps are in release-pipeline.md.
- Merge PRs to
mainwith conventional titles (feat:,fix:, …). Squash-merge so the title is the commit. - On GitHub: Actions → Release → Run workflow, with branch
main. - The workflow bumps the version from commits since the last tag, builds macOS arm64 and Windows x64 installers, and publishes a GitHub Release.
For the very first v0.0.1 cut, tag it by hand and run Build & Publish Release against that tag — see the bootstrap section in the pipeline doc.