Settings has eight panels in three groups.
| 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.
Connect a provider by signing into its CLI (gh, glab, origin), pasting a
token, or running native OAuth. Tokens GitLane owns are stored in your OS
keychain. Origin uses the CLI session only.
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.
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