All posts

Docs2 min read

What GitLane needs installed

Git 2.36 or newer on your PATH is the only hard requirement. Everything else unlocks one surface and can be skipped.

Git 2.36 or newer, on your PATH. GitLane shells out to your real git binary for every write operation, and the write layer checks the version before it runs anything. Older versions are refused rather than silently misbehaving.

git --version

That is the whole hard requirement. A repository is fully usable — clone, commit, branch, merge, push — with no account connected to GitLane at all.

Optional, per feature

None of these block the core app. Skip them all and you still get the graph, staging, conflict resolution, worktrees, stashes, and tags.

You want You need
GitHub pull requests GitHub CLI gh 2.95+, signed in via gh auth login
GitLab merge requests glab signed in, or a GitLab personal access token in Settings
Bitbucket pull requests An Atlassian API token (legacy app passwords also work) in Settings
Cursor Origin pull requests Origin CLI signed in via origin auth login (macOS, Linux, or WSL — not native Windows)
AI-drafted commit messages, AI actions, conflict resolve An AI CLI on your PATHclaude, codex, and similar

Before it runs a GitHub operation, GitLane probes a non-secret capability baseline (gh version, gh auth status, gh auth token, gh pr diff, gh api graphql). Versions below 2.95 don't support all of it, so GitLane tells you to upgrade instead of failing midway.

Cursor Origin pull requests use the signed-in origin session. A missing or old CLI, or native Windows, fails with an Origin-specific message and never falls back to gh.

Repositories hosted on Azure DevOps, Gitea, or Forgejo/Codeberg work completely for everything else. Only the pull-request view is unavailable, and GitLane says so plainly.

Good to know

Each optional dependency unlocks one surface. Nothing in that table is required to commit, branch, or push.

If you'd rather compile it yourself, see Build from source.

Full walkthrough: Requirements.

Installers: Download GitLane.