Skip to content

Requirements

What GitLane needs installed, and what each optional dependency unlocks.

Updated View as Markdown

Required

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

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 added in Settings
Bitbucket pull requests An Atlassian API token (legacy app passwords also work) added 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

Why the gh version floor

Before it runs a GitHub operation, GitLane probes a non-secret capability baseline: gh version, gh auth status --json hosts, gh auth token, gh pr diff --patch --color never, and gh api graphql. Versions below 2.95 don’t support all of it, so GitLane tells you to upgrade instead of failing midway through a pull-request action.

Why Origin needs its own CLI

Cursor Origin pull requests use the signed-in origin session. GitLane probes pr diff --patch, api, and pr thread before the first Origin operation. A missing or old CLI, or native Windows, fails with an Origin-specific message and never falls back to gh.

Forges without pull-request support

Repositories hosted on Azure DevOps, Gitea, or Forgejo/Codeberg work completely for everything else — commit, branch, fetch, pull, push. Only the pull-request view is unavailable, and GitLane says so plainly instead of failing with a cryptic error from a CLI that was never going to work.

Building from source

If you’d rather compile it yourself, see Build from source — you’ll need bun, the Rust toolchain, and your platform’s Tauri system dependencies.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close