Skip to main content
The Settings screen opens as a full-screen overlay, with the ParalleLane tab and the Projects tab at the top. The ParalleLane tab holds app-wide and machine-wide settings, and the Projects tab holds local settings for the selected repository. Open it from the settings icon at the bottom of the left sidebar, or from ParalleLane → Settings… in the macOS menu. Close it from Back to app in the upper left.
General, Appearance, Shortcuts, Accounts, Git, Signing, Open In, AI, Plan, About

​
General

The General settings screen, with the Language, Default clone location, Source code folders, Excluded folders, session restore, Fetch, Invalid worktrees, and Updates rows stacked in that order
The automatic check first runs 6 seconds after the app starts and repeats every 6 hours after that; you can turn it off with the Check for updates automatically toggle.Checking manually with the Check for updates button shows the result next to the current version. When an update is available, the Install update button appears; click Install and restart in the dialog and the app restarts after installing.
Clicking Install creates the parallelane command and shows the install path below the row. You can open a repository by passing a path, as in parallelane ., and if you move the app to a different location you need to reinstall.
Shown and works on macOS only.

​
Appearance

The Appearance settings screen. Under Color Theme, the Dark group shows preview cards for the selected Espresso Dark, Espresso Cream, Caramel Macchiato, and Cold Brew, and the Light group shows Latte and Affogato, followed by the Syntax highlighting toggle and the UI Font setting
The reset button on the font rows restores the system default. Changes apply immediately.

​
Git

Covers machine-wide Git defaults. Per-repository remote settings live separately, under the identically named Settings → Projects → Git.
The Git settings screen, with the default account, fetch and push defaults, and the Git LFS status badge
Commit signing has its own Signing menu, separate from the Git screen.

​
The remaining menus

  • Shortcuts remaps the shortcuts for Working copy, History, View, and tab commands.
  • Accounts manages the accounts registered on the machine.
  • Signing manages the global SSH/GPG signing method.
  • Open In manages the apps exposed in the Open in… menu.
  • AI picks Claude Code or Codex as the CLI that drafts pull requests and merge requests, shows whether it was found, and sets its path, arguments, and prompt.
  • Plan shows the current plan and activates a license key.

​
Per-project settings

  • Appearance chooses the project icon.
  • Account chooses the repository’s commit identity and authentication account from Global or a registered account.
  • Git sets the Default remote, adds, edits, and deletes remotes, edits the commit template, and turns Sign-off on or off.
  • Signing chooses Use global setting or Override for this repo to override just this repository.
  • Open In chooses Inherit or Override. Switching to Override saves a copy of the global list to this repository.

​
Project icon

The project icon appears on the repository row in the sidebar, the repository name in the top bar, and the project dropdown in Settings. A new repository starts with an icon auto-detected from its platform, or a folder icon when no platform is detected. In Settings → Projects → Appearance, click Change icon to open the Project icon window. Pick a mode at the top, check the preview, and click Apply.