Settings has eight panels in three groups.
There are two settings windows: App settings (everything on this page) and Repository settings for the open repository (its remotes, identity and labels). A card at the top of each opens the other one.
| Group | Panels |
|---|---|
| Accounts & identities | Accounts · Identities |
| AI | AI Agents · Terminal Agents · Prompts |
| Application | Appearance · Keyboard Shortcuts · About |
Accounts
Where you connect GitHub, GitLab, Bitbucket, and Cursor Origin, and choose which account each remote authenticates as. Accounts drive clone, fetch, pull, push, and pull-request API calls — never who you commit as.
Connecting a provider shows one method at a time — the provider’s CLI
(gh, glab, origin), an access token, or an SSH key — and each says
what it covers and where to get the credential. For an access token you
choose where it’s kept: GitLane, in your OS keychain, or your own Git
credential helper. After saving, GitLane checks the token against the open
repository’s remotes. Origin uses the CLI session only.
A GitHub token kept in GitLane’s keychain covers pull requests as well as fetch and push. The GitHub CLI still has to be installed, but it no longer needs to be signed in.
From Repository settings, an HTTPS remote’s account row can connect a new account for that provider. App settings then shows ← Back to your repository, and binds the new account to the remote when exactly one matching account was added.
If a save fails, the message says why. When another credential helper answers for the same host, GitLane names the username it returned and offers to forget it and save again.
Two sign-out verbs live here and do different things: provider sign-out deletes GitLane’s keychain token, while forget saved HTTPS credential clears what your own git credential helper stored.
Identities
Your saved identity cards — name, email, optional GPG/SSH signing key — and which one applies to the open repository. Applying a card writes to that repository’s local git config, never the global one.
“This computer” is the fallback: your global git config, used when nothing is pinned.
AI Agents
The agents that answer requests inside GitLane — Draft / Improve a commit message, AI actions, and conflict resolve. They drive a CLI you are already signed in to over the Agent Client Protocol, so there is no API key to paste and nothing is billed separately from your existing subscription.
The panel lists the agents in use, in order. Drag to reorder — the first enabled agent is the default the Draft, Improve, and AI actions surfaces offer. Under the list, a searchable catalogue adds a supported agent (Claude Code, Codex, Cursor, Kimi, OpenCode, Goose, Gemini, Copilot, Kiro, Junie, Devin, Grok, Amp, OpenClaw, Oh My Pi) or a custom command of your own.
Each row expands to:
| Field | Meaning |
|---|---|
| Adapter | Which agent to launch — or Terminal only, which keeps the entry out of in-app actions |
| Adapter command | The command GitLane runs. Editable when the adapter is Custom |
| Connect | Launches the adapter once and reads back what it offers. The status pill shows the result |
| Model | Pinned model, or the adapter’s own default. Populated by Connect |
| Effort | Reasoning effort or fast/thinking preset, when the adapter advertises one |
| Enabled | Disabled agents stay configured but drop out of the pickers |
Pins you set are read back from the agent’s own session options, so the list is whatever your CLI actually supports today — not a hard-coded table. A pin whose model the adapter no longer advertises stays selected rather than silently falling back to the default.
Changes apply to every repository. Reset to defaults restores the shipped list.
Terminal Agents
The AI CLIs — or any commands — that GitLane can launch in the integrated terminal. This is the separate, older surface: it types a command into a shell rather than speaking a protocol, and it is what review notes hand their composed instruction to. Four built-ins ship configured; add as many of your own as you like.
Each agent has:
| Field | Meaning |
|---|---|
| Name | The toolbar button text and settings row title |
| Command | What’s typed into the running shell — flags and args allowed, e.g. claude --model <model> |
| Description | The toolbar tooltip |
| Enabled | Disabled agents stay configured but hide from the toolbar |
GitLane probes your PATH on every load and greys out agents whose binary
isn’t there — the entry stays, it just can’t be launched. Availability is
computed fresh each time, never cached.
The list lives in a config file in the app data directory, and there’s a reset to restore the built-ins.
Prompts
The instructions in-app agents follow. Each field is sent as written; the agent reads the repository itself, so GitLane never ships a diff over IPC. Edits apply to every repository. Expand a row, then Save or Cancel. The commit-message prompt is always on; AI-action commands are a list you can reorder, disable, or extend.
Commit message
- Commit message instruction — Draft, Improve, and Commit with agent share this. The app adds “reply with the message only” or “then commit” depending on which action you ran.
AI actions
Used by the AI actions popup (Cmd/Ctrl + Shift + A). The list is the picker: reorder rows, disable a built-in to hide it, or Add command with a title and prompt. Built-ins can be reset to the shipped text. Custom prompt is still typed at run time and is not stored. Save keeps an edit; Cancel discards it.
Appearance
Presentation and the background-fetch cadence.
Theme
Dark, Light, or System. New installs follow the system; a theme you already picked is kept.
Accent colour
Nine accents — green, teal, cyan, blue, indigo, purple, pink, red, orange. The accent threads through every accent surface: the HEAD badge, primary buttons, active tabs, and selected rows.
Graph density
Comfortable or Compact. Compact fits more commits on screen.
Commit icons
On by default: author avatars, co-author badges, and icons for commits made by AI agents and bots. Turn it off for classic coloured dots.
Background fetch
Automatically fetch remotes on an interval — 5, 15, 30, or 60 minutes, defaulting to 15.
Keyboard Shortcuts
A read-only list of every binding GitLane supports on this platform, grouped the same way as Keyboard shortcuts. Bindings are not customisable yet. Context menus that share a binding show the keys as badges for this OS.
About
Version and build information — GitLane version, Tauri version, platform, and bundle identifier — plus links to release notes, the license, and acknowledgements.
Two update controls live here:
- Automatically check for updates — checks once a day and lights the titlebar when a new version is available
- Receive beta updates — switches the update channel
About also lists What’s new — the release notes of every version from the one on offer back through earlier releases — with Skip this version when an update is available.