Troubleshooting
Gatekeeper and SmartScreen on first launch, an AppImage that will not run, a git or gh version that is too old, and a few other things people actually hit.
"GitLane is damaged and can't be opened" (macOS)
Not damaged. GitLane isn't notarized by Apple yet, and macOS shows this for every non-notarized download on Apple Silicon. Copy the app to Applications, then clear the quarantine flag once:
xattr -dr com.apple.quarantine /Applications/GitLane.app
On Intel Macs the same situation usually appears as an "unidentified developer" message. Right-click → Open, or System Settings → Privacy & Security → Open Anyway, also works. More: Install.
"Windows protected your PC"
SmartScreen blocking an unsigned installer. Click More info → Run anyway. The installer needs no admin rights, and in-app updates don't retrigger it.
The AppImage won't run (Linux)
Browsers strip the executable bit. chmod +x the file once. Prefer the .deb or .rpm if your distribution takes one.
GitLane refuses to run a git operation
GitLane requires Git 2.36 or newer and checks before writing. git --version. More: Requirements.
The Pull Requests tab isn't available
Your forge isn't supported for PRs. Azure DevOps, Gitea, and Forgejo/Codeberg work for everything else but have no pull-request view yet.
Your CLI is too old or not signed in. GitHub needs gh 2.95+ (gh --version, gh auth status). Cursor Origin needs the Origin CLI signed in (origin auth status); native Windows is not supported, and a missing origin never falls back to gh.
A GitHub action that fails with a host mismatch means the repository's host and the bound account's host don't match. Rebind in Settings → Accounts.
I committed with the wrong email
Identities are pinned per repository, in local git config. Open Settings → Identities and apply the right card — or adopt the repository's current git-config identity as a card. Nothing you do there touches your global config. To fix the commit itself, amend it from the commit composer.
An operation failed with "the repository changed"
Working as designed. If the repository moved between the impact preview and your confirmation, GitLane refuses to act on stale state. Re-read the fresh preview and confirm again.
I lost a commit
Use Recover. It browses the reflog so you can create a branch back at almost anything — unreferenced isn't gone. More: Safety and recovery.
Sign-out didn't remove my saved password
Provider sign-out deletes GitLane's own keychain token. Forget saved HTTPS credential runs git credential reject, clearing what your git credential helper stored. You probably want the second one.
Good to know
First-launch Gatekeeper and SmartScreen warnings are expected. In-app updates do not retrigger them.
Something else: GitHub issues.
Full walkthrough: Troubleshooting.
Installers: Download GitLane.