1. Install the app and check Git
Download the package for your desktop: Linux AppImage, Debian, RPM, or Arch; a universal macOS DMG or ZIP; or the Windows installer. Released packages do not require Node.js or a source-build toolchain.
Have the system git command installed and available on PATH. macOS builds are unsigned and use manual installation and updates. For Linux, the dedicated installation guide explains package selection and the one-line installer.
git --version2. Choose a commit profile and appearance
On first launch, enter a profile name, author name, and email. An existing global Git identity is prefilled when available. The app supplies the selected identity for its commit command; writing it to global Git configuration is a separate opt-in, off by default.
Preview a theme, then configure AI or skip it. Skipping setup makes no model request and does not change global Git identity. These settings remain available later. The optional Gravatar preview makes an external image request; turn it off if you prefer initials.
3. Open and inspect your repository
Use Home to open an existing repository or create one. Pin frequently used projects and switch between them in tabs. Select a commit in the graph to inspect its parents, file changes, and patch.
Start with a repository you know. Local Git work needs no hosting account. Connect a provider in Settings → Pull Request Providers when you want to read, review, or create hosted requests.
4. Review, stage, commit, and push
Review staged and unstaged changes in the diff viewer. Stage the files or hunks that belong together, read the staged patch, and write a commit message. Unrelated working edits can stay unstaged.
Fetch, pull, and push using your existing SSH key or Git credential helper. A commit is local until you push. Supported in-app destructive actions create restore points; direct terminal commands do not receive those safeguards.
- Ctrl/Cmd + , opens Settings.
- Ctrl/Cmd + F filters commits and branches.
- Ctrl/Cmd + R refreshes repository status.
- Ctrl/Cmd + T opens Home.
- Escape dismisses a viewer or dialog.